¿Puede Chatwoot self-hosted usar la API oficial de WhatsApp sin App Review de Meta?

En resumen: sí, y tu número sigue funcionando en la app de WhatsApp Business de tu celular. ZapClaw lo conecta a la Cloud API oficial de Meta por Coexistencia y le responde al canal nativo de WhatsApp Cloud de Chatwoot igual que Meta. Sin app propia en Meta, sin App Review y sin modificar Chatwoot: una variable de entorno y una llamada a la API por número.

Lo que ZapClaw le suma a Chatwoot

• La API oficial, no una librería no oficial. Los mensajes pasan por la Cloud API de Meta y no por un cliente que imita WhatsApp Web, el tipo de conexión que va contra las condiciones de WhatsApp y pone los números en riesgo.
• El número sigue en el celular. Con la Coexistencia, la app de WhatsApp Business sigue funcionando junto a Chatwoot. Meta solo abre la Coexistencia a Tech Providers y Solution Partners. ZapClaw es Tech Provider de Meta, así que no necesitas convertirte en uno.
• Los números de tus clientes, sin App Review. Una app que usan otras empresas necesita el App Review de Meta. Tus clientes se conectan por el Embedded Signup de ZapClaw, en minutos, y los planes de pago aceptan números ilimitados.
• Chatwoot y tu automatización en un mismo número. Un webhook nativo puede funcionar junto a Chatwoot, así que un bot o un flujo de n8n también recibe cada mensaje.

Configuración: una variable y una llamada a la API por número

1. Crea tu cuenta de ZapClaw y conecta el número en la ventana de Meta, por Embedded Signup.
2. En el panel, crea una clave de API para Chatwoot y escribe la dirección de tu Chatwoot en la sección Chatwoot de Webhook. ZapClaw te muestra la clave de firma y, para cada número, el comando de la bandeja de entrada con los datos del número.
3. Define WHATSAPP_CLOUD_BASE_URL como https://api.zapclaw.app en los contenedores web y Sidekiq de Chatwoot y reinicia los dos. Desde ahí, todas las bandejas de entrada de WhatsApp Cloud de esa instalación envían por ZapClaw.
4. Crea la bandeja de entrada con una llamada a la API de Chatwoot, una vez por número. La llamada define source como manual_setup_v2 y usa la clave de firma como app_secret de la bandeja, lo que activa la verificación de firma de Chatwoot.
5. Haz clic en Enviar evento de prueba y envía un mensaje de WhatsApp al número. Aparece en Chatwoot, y las respuestas salen por ZapClaw.

¿Por qué no desde la pantalla del propio Chatwoot? Desde Chatwoot 4.18, su pantalla de WhatsApp Cloud valida la clave en graph.facebook.com, que rechaza una clave de ZapClaw. La llamada a la API crea la misma bandeja de entrada nativa.

Chatwoot envía por ZapClaw desde la versión 2.15. Usa la 4.14 o una más reciente, que además verifica la firma de cada entrega con el app_secret de la bandeja. La variable WHATSAPP_APP_SECRET no interviene: una instalación estándar la ignora.

¿Chatwoot responde 401?

Para quién es

Equipos y agencias que tienen Chatwoot en su propio servidor y quieren mantener el número en la app de WhatsApp Business, tener los números de sus clientes en Chatwoot o las dos cosas. Si es un solo número tuyo y no necesita la app, Chatwoot puede conectarse directamente a Meta, sin App Review.

Para ir más allá

• La guía completa de Chatwoot (en inglés), con cada campo y la solución de problemas.
• chatwoot-zapclaw en GitHub (en inglés): un script que prueba tu clave antes de tocar Chatwoot y un ejemplo de Compose.
• Lo que necesitas para conectar un número por Coexistencia.
• Planes y precios, del plan gratuito al plan Agência para agencias.