Usa un número de Coexistencia como bandeja WhatsApp Cloud de Chatwoot

¿Cómo se conecta un número de Coexistencia a Chatwoot?

En dos lugares, en este orden.

En Chatwoot, añade una bandeja de entrada, elige WhatsApp y selecciona el proveedor WhatsApp Cloud con la configuración manual. Introduce el número, el ID del número de teléfono, el ID de la cuenta de WhatsApp Business y el token de acceso. Todos aparecen en el panel de EasyCoexistence para la conexión, o get_api_credentials los devuelve a un asistente. Chatwoot muestra entonces una URL de webhook y un token de verificación del webhook para la bandeja.

En EasyCoexistence, fija el destino del webhook del número en esa URL e introduce el mismo token de verificación. Meta envía su petición de verificación a Chatwoot, Chatwoot la responde y, desde ese momento, cada mensaje al número llega a la bandeja. No hay nada en medio, así que no hay ningún flujo de trabajo que mantener vivo.

¿Las respuestas enviadas desde el teléfono aparecen en Chatwoot?

Sí. En un número de Coexistencia, una respuesta escrita en la app de WhatsApp Business la notifica Meta como un evento smb_message_echoes, y el job de webhook de Chatwoot reconoce ese campo y registra el mensaje como saliente en la conversación correcta. Su código fuente describe el caso directamente: empresas que responden desde Chatwoot y desde la app, con los mensajes sincronizados en Chatwoot.

Eso hace que el reparto funcione en la práctica. El dueño puede seguir atendiendo a los clientes habituales desde el teléfono, el equipo puede trabajar la bandeja compartida desde un escritorio, y cada uno ve lo que envió el otro sin reenviar capturas de pantalla.

Los mensajes enviados desde Chatwoot salen por la Cloud API con el mismo número, así que también aparecen en el teléfono.

¿Por qué la bandeja de Chatwoot no debe tener secreto de la app?

Porque las entregas se firman con un secreto que no tienes. Meta firma cada webhook con el secreto de la app propietaria de la suscripción, que es la app de EasyCoexistence, y ese secreto nunca se comparte.

En el código actual de Chatwoot, la cabecera X-Hub-Signature-256 de un canal de WhatsApp Cloud configurado manualmente solo se comprueba cuando se ha guardado un secreto de la app en él, o cuando el canal se creó mediante el Embedded Signup propio de Chatwoot. Una bandeja manual sin secreto de la app acepta las entregas; una con cualquier secreto de la app rellenado rechaza todas por no autorizadas.

La protección que aplica aquí es el token de verificación. Elige un valor largo y aleatorio, porque es lo que permite a Chatwoot distinguir la petición de verificación de Meta de la de cualquier otro.

¿Qué no puede hacer Chatwoot con este número?

Recibir webhooks en un segundo lugar al mismo tiempo. Meta enruta los webhooks de un número a un único destino, así que mientras Chatwoot lo tenga, un flujo de n8n no recibirá los mismos eventos. Si necesitas ambos, apunta el destino a un pequeño relay propio que reenvíe cada entrega a Chatwoot y al flujo.

Los límites de Coexistencia se aplican como en cualquier otro sitio: la API envía hasta 20 mensajes por segundo, el texto libre solo sale dentro de las 24 horas posteriores al último mensaje del cliente, y las plantillas cubren todo lo que viene después.

La app de WhatsApp Business sigue necesitando abrirse al menos una vez cada 14 días, algo que EasyCoexistence vigila.

Errores comunes

• Rellenar un secreto de la app en la bandeja de Chatwoot. Las entregas se firman con el secreto de la app de EasyCoexistence, así que Chatwoot rechaza todas por no autorizadas.
• Usar en EasyCoexistence un token de verificación distinto del que muestra Chatwoot. La verificación de Meta falla y la bandeja nunca recibe un mensaje.
• Elegir el Embedded Signup de Chatwoot en lugar del flujo manual. Eso conecta el número mediante la app de Meta propia de Chatwoot, una conexión aparte.

Preguntas frecuentes

Sigue leyendo