Captura de WhatsApp vía companion
Captura todas las conversaciones del WhatsApp Business del vendedor directo en la línea de tiempo de Conversaciones, usando un puente companion que tú mismo alojas. Es opcional, desactivado por defecto, y exige aceptar un aviso de Términos de servicio.
Este conector trae a la línea de tiempo de Conversaciones los mensajes del WhatsApp Business del vendedor, capturados por un puente companion que aloja tu organización. Los mensajes entran en el mismo lugar que las demás conversaciones, así que el resumen por IA, los insights y el seguimiento ya funcionan sobre ellos.
Antes de empezar: aviso de Términos de servicio
Cómo funciona
- Ejecutas un puente companion (un servicio open-source de WhatsApp Web) en tu entorno.
- El companion vincula WhatsApp Business por código QR y escucha los mensajes entrantes y salientes.
- Para cada mensaje, el companion envía un POST firmado a la URL de ingesta de tu organización.
- El mensaje se guarda, se vincula al contacto o lead por el teléfono (o crea un lead nuevo cuando el número es desconocido) y aparece en la línea de tiempo de Conversaciones.
Cómo conectar
- Ve a Configuración, Integraciones y abre la tarjeta "WhatsApp: captura vía companion".
- Define un secreto de vinculación fuerte y marca la casilla de consentimiento (entiendo el riesgo a los Términos de servicio). Haz clic en Guardar.
- Copia la URL de ingesta mostrada y configura el companion con esa URL y el mismo secreto de vinculación.
- Vuelve a la tarjeta y haz clic en Activar. Sin el consentimiento marcado y guardado, la captura no se acepta.
Mientras el conector esté desactivado o sin el consentimiento guardado, la URL de ingesta rechaza cualquier envío. Así nunca capturas nada sin haber aceptado el aviso.
Formato del POST (contrato del companion)
El companion envía un mensaje o un lote, firmando el cuerpo con el secreto de vinculación (HMAC-SHA256) en el encabezado X-Sellio-Signature con el formato sha256=<hex>.
POST /api/inbound/whatsapp-capture/TU_TOKEN
X-Sellio-Signature: sha256=<hmac-sha256 del cuerpo con el secreto>
Content-Type: application/json
{
"messages": [
{
"messageId": "id-unico-del-mensaje",
"from": "5215551230000",
"to": "5215559990000",
"direction": "in",
"body": "texto del mensaje",
"timestamp": 1700000000,
"name": "Nombre del contacto"
}
]
}El messageId garantiza que el mismo mensaje, si se reenvía, no se duplique. direction es "in" (recibido) o "out" (enviado por el vendedor). timestamp acepta segundos o milisegundos y se usa para ordenar la línea de tiempo.