Atención omnicanal
Integra WhatsApp con Chatwoot
Chatwoot es una plataforma de atención al cliente omnicanal y de código abierto. Reúne en una sola bandeja compartida las conversaciones de varios canales (sitio web, email, redes sociales y WhatsApp), donde varios agentes trabajan en equipo, con colas, equipos, etiquetas, respuestas prediseñadas e informes. Es la alternativa autoalojada más popular a herramientas como Zendesk e Intercom y, al ser abierta, permite conectar tus propios canales mediante el tipo de bandeja "API".
Por qué conectar
Por sí solo, Chatwoot no habla WhatsApp con un número común: o usas la API Oficial (cara y burocrática) o no tienes canal. Al conectar ZapZap API, usas un número normal de WhatsApp mediante una instancia gestionada y llevas todas las conversaciones a la bandeja de Chatwoot. Un escenario concreto: un equipo de soporte de 5 agentes atiende a cientos de clientes en un solo número. El cliente escribe por WhatsApp, ZapZap dispara un webhook, tu capa intermedia crea la conversación en Chatwoot y el agente responde desde la pantalla de Chatwoot. La respuesta sale por el webhook de Chatwoot y ZapZap la envía de vuelta por WhatsApp. Obtienes distribución de conversaciones, historial centralizado y métricas de atención, manteniendo el calentamiento comunitario, recursos antibaneo que reducen el riesgo de la cuenta y la opción de IA por instancia, todo por R$15 por número activo/mes, prepago y con un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente.
Paso a paso
- 1
Crea una bandeja de tipo API en Chatwoot
En Chatwoot, ve a Configuración > Bandejas de entrada > Añadir bandeja y elige el canal API. Ponle un nombre (por ejemplo WhatsApp ZapZap) e indica una Webhook URL que apunte a tu capa intermedia. Al terminar, Chatwoot genera el inbox_identifier y un api_access_token que usarás en las llamadas.
- 2
Configura el webhook de eventos de Chatwoot
En Configuración > Integraciones > Webhooks (o en el Agent Bot de la bandeja API), marca los eventos message_created y conversation_created. Así, cada vez que un agente responda en la pantalla de Chatwoot, se dispara el payload a tu capa, que hará el envío real por WhatsApp mediante ZapZap API.
- 3
Apunta el webhook de la instancia de ZapZap a tu capa
En el panel de ZapZap API, define el webhook por evento de la instancia (mensaje entrante) con la URL de tu middleware. Cuando un cliente escribe por WhatsApp, ZapZap te envía el payload con el número y el contenido del mensaje para procesar.
- 4
Reenvía el mensaje entrante a Chatwoot
En tu middleware, al recibir el webhook de ZapZap, usa la API pública de Chatwoot para crear o encontrar el contacto y la conversación y publicar el mensaje: POST /public/api/v1/inboxes/{inbox_identifier}/contacts/{contact_identifier}/conversations y luego /messages. La conversación aparece en la bandeja del equipo como una nueva entrada de WhatsApp.
- 5
Envía la respuesta del agente de vuelta por WhatsApp
Cuando el agente responde en Chatwoot, el webhook message_created llega a tu middleware. Filtra por message_type outgoing y llama al endpoint de envío de ZapZap API (con los headers x-api-key y x-api-secret) para entregar la respuesta al WhatsApp del cliente. Consulta la ruta y los campos exactos en la documentación en https://api.zapzapapi.com/llms.txt.
Ejemplo
// Ejemplo ILUSTRATIVO: cuando llega un mensaje a Chatwoot (webhook del agente),
// tu capa lo envía por WhatsApp mediante ZapZap API.
// La ruta y los nombres exactos de los campos están en la documentación: https://api.zapzapapi.com/llms.txt
POST https://api.zapzapapi.com/v1/messages/send
Headers:
x-api-key: TU_API_KEY
x-api-secret: TU_API_SECRET
Content-Type: application/json
{
"number": "5511999999999",
"text": "¡Hola! Recibimos tu mensaje y te atenderemos en breve."
}Ilustrativo. Los campos y endpoints exactos están en la documentación.
Preguntas frecuentes
¿Necesito la API Oficial de WhatsApp para usarlo con Chatwoot?
No. ZapZap API funciona con números comunes de WhatsApp mediante instancias gestionadas, así que te conectas a Chatwoot por el canal API sin pasar por la API Oficial ni por la burocracia de Meta. Conservas la bandeja de equipo de Chatwoot y pagas R$15 por número activo/mes, prepago, con un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente.
¿Necesito una capa intermedia entre ZapZap y Chatwoot?
Sí. El canal API de Chatwoot y ZapZap API no se comunican directamente: necesitas un pequeño servicio (webhook) que reciba el evento de un lado y llame al otro. Puede ser una función serverless, un endpoint de tu backend o un flujo en n8n. Traduce los webhooks en ambos sentidos.
¿Varios agentes pueden atender el mismo número?
Sí, ese es el punto fuerte. Chatwoot distribuye las conversaciones de una sola bandeja de WhatsApp entre agentes y equipos, con asignación automática, etiquetas y respuestas prediseñadas. Todos los mensajes entran y salen por un único número gestionado en ZapZap API.
¿Esto protege mi cuenta de WhatsApp contra baneos?
ZapZap API ofrece calentamiento comunitario y recursos antibaneo que reducen el riesgo de la cuenta, además de IA por instancia. Ninguna solución garantiza cero baneos, pero centralizar la atención con respuestas más rápidas y humanas ayuda a mantener un patrón de uso saludable.
¿Dónde veo el endpoint y los nombres de campos exactos de ZapZap API?
La referencia oficial está en https://api.zapzapapi.com/llms.txt, con las rutas de envío, los eventos de webhook y los campos aceptados. Los ejemplos de esta página son ilustrativos: confirma los nombres exactos en la documentación antes de pasar a producción.
Empieza ahora
Crea tu cuenta, conecta un número en minutos y prueba la API con calentamiento y anti-bloqueo. R$15 por número activo/mes, prepago, sin permanencia.