Integración de WhatsApp con tu sistema: lo que InvestCRM conecta

• ✓WhatsApp, API Oficial o Coexistencia: conecta el número de la empresa por el registro integrado de Meta. Quién la configura: tú, en una ventana de Meta. Plan: todos.
• ✓API REST por clave: crea y actualiza contactos, aplica etiquetas y suscribe a secuencias. Quién la configura: tu sistema, con la clave generada en el panel. Plan: Business y Enterprise.
• ✓Webhooks de salida: avisan a tu sistema de mensajes, contactos, automatizaciones, embudo y conversaciones. Quién los configura: el equipo de InvestCRM, junto contigo. Plan: Business y Enterprise.
• ✓API de Conversiones de Meta: envía el lead calificado del embudo a Meta. Quién la configura: tú, en las conversiones de Meta. Plan: Business y Enterprise.
• ✓Google Ads, conversiones offline: devuelven a Google los niveles del embudo, hasta la venta. Quién las configura: tú, con la etiqueta en el sitio. Plan: Business y Enterprise.
• ✓OpenAI o Anthropic: el agente de IA usa la clave de tu cuenta. Quién la configura: tú, en Agente de IA. Plan: desde Start.
• ✓Odonto Invest: conecta la agenda de la clínica al agente de IA. Quién lo configura: tú, en una cuenta de salud habilitada por el equipo. Plan: Business y Enterprise.
• ✓Planillas CSV y XLSX: importan contactos y exportan nombre y teléfono. Quién las usa: tú, en Contactos. Plan: importar en todos; exportar desde Start.

Conectar un número nuevo abre una ventana de Facebook: eliges el portafolio y la cuenta de WhatsApp allí, y se cierra sola al terminar. No hace falta crear una aplicación. Quien ya tiene una app propia en Meta también puede conectar con credenciales manuales (el ID del número, el ID de la cuenta de WhatsApp Business, un token permanente y la clave secreta de la app).

Cada cuenta de InvestCRM usa un número, para que etiquetas, embudos, envíos y bandeja de entrada nunca se mezclen; para otro número, se abre otra cuenta.

Modo Coexistencia de WhatsApp Business

Si el número ya está en la app WhatsApp Business del celular, el botón de la Coexistencia mantiene la app funcionando y muestra las conversaciones también en InvestCRM. Si confirmas en el celular, llegan los contactos y hasta 6 meses de conversaciones individuales (las de grupo no). Meta solo acepta ese pedido en las 24 horas siguientes al registro, e InvestCRM lo hace justo después de conectar.

• ✓La app pierde, en este número, los mensajes temporales, la visualización única, la ubicación en tiempo real y las listas de difusión (las que existen quedan solo de lectura).
• ✓Los dispositivos vinculados se desconectan; WhatsApp para Windows y WearOS no vuelven.
• ✓El envío queda limitado a 20 mensajes por segundo.
• ✓Lo que escribes en el celular aparece en la Bandeja de entrada; en este modo, el perfil comercial se edita desde el celular.

Más detalles en Coexistencia: la app y la API en el mismo número y en la guía de la API Oficial.

En Integraciones (API), dentro de la Configuración, el Administrador y el Propietario generan las claves. La clave empieza con ic_live_, aparece una sola vez y se guarda solo como hash; puedes revocarla cuando quieras y la pantalla muestra el último uso. La documentación de uso está ahí mismo, en el panel, con ejemplos listos para copiar: no hay una página pública de referencia.

• ✓La clave va en el encabezado Authorization: Bearer o x-api-key; la cuenta siempre sale de la clave, nunca del cuerpo de la llamada.
• ✓Hasta 60 llamadas por minuto por clave; por encima, la respuesta es 429, con Retry-After de 60 segundos.
• ✓El plan se revisa en cada llamada: si la cuenta sale de Business, la clave deja de operar al instante, sin borrarse, y vuelve a valer cuando el plan vuelve.
• ✓El límite de contactos del plan también vale aquí: un contacto nuevo por encima del tope se rechaza.
• ✓El mismo celular con y sin el noveno dígito de Brasil queda como un solo contacto.
• ✓La etiqueta "descadastro" aplicada por la API manda el contacto a la lista de bloqueo, como en cualquier otra pantalla.

Con esas tres llamadas, tu formulario, tu ERP o tu sistema de cobro ya ponen al contacto en WhatsApp: la etiqueta aplicada por la API activa una automatización, que envía la plantilla aprobada. Mira los montajes de automatización.

Un webhook es una dirección de tu sistema que recibe un aviso con cada evento elegido. Son 18 eventos, en cinco grupos:

• ✓Hasta 5 direcciones por cuenta, cada una con los eventos que quieras; solo se aceptan direcciones públicas con https://.
• ✓Cada aviso lleva el encabezado X-InvestCRM-Signature, con v1= y el HMAC-SHA256 de "timestamp.cuerpo" hecho con el secreto de la dirección. Tu sistema revisa la firma y rechaza avisos con más de 5 minutos de diferencia.
• ✓El secreto (whsec_…) aparece una sola vez. Al cambiar el secreto, durante 24 horas los avisos llevan las dos firmas, la nueva y la anterior.
• ✓Si tu sistema no responde en 10 segundos o da error, el aviso se repite después de 1, 5 y 15 minutos, 1 hora y 6 horas.
• ✓Tras 20 fallos seguidos, la dirección se desactiva y el Propietario y los Administradores reciben un correo.
• ✓Hay un evento de prueba (ping) para ver al instante la respuesta de tu servidor, y el historial de entregas se guarda 30 días, con reenvío de las que fallaron.

En los planes Business y Enterprise, el embudo devuelve resultados a los anuncios. Meta recibe por la API de Conversiones el evento de lead calificado (QualifiedLead) de quien vino de un anuncio de clic para WhatsApp, con clic de hasta 7 días. Google Ads recibe conversiones offline en hasta tres niveles: una etiqueta en el sitio guarda el clic, un código de 6 caracteres va en el mensaje y Google busca un archivo CSV una vez al día. Meta recibe solo el lead calificado; la venta va solo a Google.

El paso a paso está en Conversiones Meta y Google.

Odonto Invest es un sistema de clínica odontológica de la misma empresa que InvestCRM. Conectado, trae los pacientes en páginas de 200, después solo los cambios cada 15 minutos, crea el agente "Recepção Odonto Invest" y permite que la IA agende, confirme y reprograme citas en la agenda de la clínica.

• ✓Exige el plan Business, el mismo recurso de la API.
• ✓Una clínica se conecta a una sola cuenta.
• ✓La tarjeta aparece en cuentas de salud, habilitadas por el equipo de InvestCRM.

Cómo armar recordatorios y retornos con él: WhatsApp para clínica odontológica.

• ✓Importa CSV (separado por punto y coma, coma o tabulación: el sistema lo detecta) o XLSX. Reconoce columnas como nome, telefone, celular, whatsapp y var1 a var5, y puedes vincular cada columna a un campo.
• ✓Antes de guardar, una vista previa muestra lo que va a pasar, y puedes aplicar etiquetas en la importación.
• ✓Una fila con teléfono ausente o inválido vuelve con el motivo; un número de la lista de bloqueo se omite; el mismo celular con y sin el noveno dígito no se vuelve dos contactos.
• ✓Hay un modelo .xlsx para descargar y el modo "solo completar nombres vacíos", que trae los nombres sin crear contactos.
• ✓El límite de contactos del plan vale para los que la importación crea.
• ✓Exportar genera un .xlsx con nombre y teléfono, desde el plan Start, solo para Editor, Administrador o Propietario, y la acción queda registrada.

• ✓Meta: cada mensaje entregado, por categoría. Para un número de Brasil, marketing cuesta R$ 0,3217, utilidad R$ 0,0350 y servicio R$ 0,0350 por mensaje, cobrados en la tarjeta de la cuenta de WhatsApp.
• ✓OpenAI o Anthropic: el uso de la IA, en la clave de tu cuenta.
• ✓InvestCRM: la suscripción del plan. API, webhooks y conversiones vienen en Business y Enterprise, sin cobro por llamada.

El camino más común: tu sistema aplica una etiqueta por la API (por ejemplo, pedido-pago) y una automatización con el disparador Etiqueta asignada al contacto envía la plantilla. Tres plantillas que suelen nacer así, con la categoría probable:

Pedido confirmado, enviado cuando tu sistema aplica la etiqueta

Nombre en Meta: pedido_confirmado · Categoría: Utilidad

Por qué esta categoría: Confirma una compra que la persona hizo, con los datos del pedido, sin sugerir nada nuevo. Es el caso de gestión de pedidos que Meta pone como utilidad.

Factura disponible, desde el sistema de cobro

Nombre en Meta: fatura_disponivel · Categoría: Utilidad

Por qué esta categoría: Avisar sobre la cuenta de un servicio contratado es una alerta de cuenta, utilidad para Meta. Cualquier invitación a contratar más sacaría a la plantilla de esa categoría.

Producto de vuelta en stock

Nombre en Meta: voltou_ao_estoque · Categoría: Marketing

Por qué esta categoría: Aunque la persona haya marcado el producto, avisar que volvió sirve para vender: Meta trata la recomendación y el retargeting como marketing.

Reglas de cada categoría: categorías de plantilla, en la documentación de Meta. Más textos en Plantillas de mensaje.

Un mes de avisos que vienen de tu sistema

Total estimado en el mes, pagado directo a Meta: R$ 188,18. Los primeros 1.000 mensajes de servicio de cada número, cada mes, son gratis. Si las plantillas de utilidad de esta cuenta se clasificaran como marketing, el mismo mes pasaría de R$ 188,18 a R$ 618,23. Los volúmenes son un ejemplo para mostrar la cuenta, no datos de un cliente.

Tabla de Meta en reales para números de Brasil, vigente desde el 1 oct 2026, revisada el 9 oct 2026. Ver la tabla en Meta · Haz tu cuenta en la calculadora

Una integración hace que datos personales salgan de un sistema y entren en otro. La ley brasileña de datos (LGPD) pone la seguridad entre los principios del tratamiento, con medidas técnicas y administrativas contra el acceso no autorizado (art. 6, VII), y dice que el operador trata los datos según las instrucciones del controlador (art. 39). La política de WhatsApp manda usar los datos de la conversación solo para esa conversación y no pasar la conversación de un cliente a otro. Fuente: Ley 13.709/2018 · Fuente: política de WhatsApp Business

• ✓Clave de API guardada solo como hash, atada a una cuenta y con límite por minuto.
• ✓Webhook solo para direcciones https públicas, firmado con HMAC-SHA256 y con la hora en el aviso, para que tu sistema rechace avisos viejos.
• ✓Clave de IA y secreto del webhook guardados cifrados y mostrados una sola vez.
• ✓Generar claves y tocar integraciones es tarea del Administrador y del Propietario; exportar la base es desde Editor.
• ✓Los registros de actividad, desde Business, muestran quién hizo qué.

Lo que InvestCRM no decide por ti: qué datos puede recibir tu sistema. Antes de conectar un webhook, revisa la base legal y el contrato con quien va a recibir los datos.

El número, la bandeja de entrada y la importación de planillas valen en todos los planes, dentro del límite de contactos. La clave de IA atendiendo clientes empieza en Start. API, webhooks, conversiones de Meta y Google y Odonto Invest son de Business y Enterprise, que también muestran los registros de actividad.