Conecta un bot de Botpress a WhatsApp con Coexistencia
Usa la integración de WhatsApp de Botpress en Manual Configuration. Pega el access token y el phone number id del número conectado, elige un verify token y deja vacíos App ID y Client Secret. Después define la URL del webhook de Botpress y ese verify token como destino del webhook del número, y Meta entrega cada mensaje al bot.
Campo Client Secret de Botpress: si se deja vacío, se omite la verificación de la firma del webhook.
Campos de webhook a los que se suscribe la guía de Botpress, entre ellos messages y las actualizaciones de estado de las plantillas.
La ventana de atención al cliente que abre un mensaje del cliente, dentro de la cual se puede enviar cualquier mensaje de servicio.
¿Qué configuración de Botpress funciona con un número en Coexistencia?
Manual Configuration. Las otras opciones conectan un número a través de la app de Meta propia de Botpress, lo que es un alta separada del número y no una forma de usar uno que ya está conectado.
En la integración de WhatsApp, abre el menú Configuration y elige Manual Configuration. Pide un Verify Token, un Access Token, un Default Bot Phone Number ID y, de forma opcional, un App ID, un Client Secret y un WABA ID.
El access token, el phone number id y el WABA id salen de la conexión: el panel los muestra y get_api_credentials se los devuelve a un asistente. El verify token es cualquier cadena que elijas. App ID y Client Secret quedan vacíos. La guía de Botpress presenta el secreto como un campo por rellenar, pero la definición de su integración lo marca como opcional y dice que sin él se omite la verificación de la firma. Eso importa, porque Meta firma cada entrega con el app secret del Tech Provider, que ningún cliente tiene.
¿Cómo recibe el webhook de Botpress los mensajes de Meta?
A través del destino del webhook del número. La guía de Botpress te pide pegar su URL de webhook y tu verify token en la configuración de WhatsApp de una app de Meta. Aquí no hay ninguna app de Meta tuya: Meta enruta los eventos del número al destino que indique la conexión. Así que copia la URL del webhook que Botpress muestra para la integración y defínela, con el mismo verify token, como destino en el panel o con set_webhook_destination.
Meta envía un GET de verificación, Botpress lo responde y empieza la entrega. Cuando Botpress guarda una configuración manual, también comprueba el token preguntando a Graph qué app lo emitió, de modo que un token inválido o revocado falla al guardar y no con el primer mensaje.
El handler de Botpress también procesa smb_message_echoes, el evento que Meta envía cuando alguien responde desde la app de WhatsApp Business. Así, una respuesta desde el teléfono es visible para el bot y no pasa inadvertida.
| Required? | What to enter | |
|---|---|---|
| Access Token | Required | The connected number's token |
| Default Bot Phone Number ID | Required | The connected number's phone number id |
| Verify Token | Required | Any string, reused in the webhook destination |
| WABA ID | Optional | The connected number's WABA id |
| App ID and Client Secret | Optional | Leave both empty |
¿Qué debe saber el bot sobre la Coexistencia?
Que puede haber una persona hablando ya. La app de WhatsApp Business sigue funcionando en el número, de modo que un cliente puede recibir una respuesta del teléfono y otra del bot en el mismo minuto. Decide en el flujo qué ocurre cuando llega un eco: la mayoría de los equipos pausa el bot para ese contacto durante un tiempo, para no pisar a quien intervino.
Lo segundo es el momento. Un bot que responde a mensajes entrantes trabaja dentro de la ventana de atención al cliente de 24 horas, donde se permite el texto libre. Un flujo que envía algo un día después, un seguimiento o un recordatorio, necesita una plantilla aprobada, y el texto libre ahí devuelve el error 131047. La guía de Botpress suscribe los campos de estado de plantillas justo para este tipo de mensaje proactivo.
Y el throughput es fijo, de 20 mensajes por segundo para un número en Coexistencia, muy por encima de lo que envía un bot conversacional.
Errores comunes
- Rellenar Client Secret con el secreto de tu propia app de Meta. La firma nunca coincide y Botpress responde 401 a cada entrega.
- Elegir la opción OAuth o sandbox en lugar de Manual Configuration. Esas conectan un número a través de la app de Botpress, no el que ya está conectado.
- Ignorar los ecos. Sin una regla para las respuestas enviadas desde el teléfono, el bot contesta por encima de una persona que ya intervino.
Conecta el número en easycoexistence.com, pega su token y su phone number id en Manual Configuration de Botpress y define la URL del webhook de Botpress como destino. Desde US$ 9 por número conectado al mes, bajando hasta US$ 1 a medida que se añaden números, con los primeros 3 días gratis.
Preguntas frecuentes
¿Es seguro omitir la verificación de la firma?
Traslada la protección a la URL. Botpress genera la URL del webhook por integración, así que mantenla privada. Los archivos multimedia siguen teniendo que descargarse de Meta con el token, algo que un evento falsificado no puede imitar.
¿Puede el mismo número alimentar también n8n?
Un número tiene un solo destino de webhook. Apúntalo a un sistema y reenvía desde ahí si un segundo sistema necesita los eventos.
¿Botpress necesita mi WABA id?
Su definición lo marca como opcional por ahora y dice que será obligatorio en una futura versión mayor, así que rellénalo con los datos de la conexión.
¿Los mensajes pasan por EasyCoexistence?
No. Meta entrega directamente a la URL del webhook de Botpress, y el contenido nunca se almacena de nuestro lado.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el