Ejecuta un flujo de Typebot en WhatsApp con Coexistencia
El canal de WhatsApp de Typebot pide un token, un id de WhatsApp Business Account y un phone number id, y te devuelve una callback URL y un verify token. Rellena los tres primeros con los datos del número conectado, deja vacío el app secret opcional de Typebot y fija su callback URL y su verify token como destino del webhook del número.
Typebot incluye la integración con WhatsApp en su plan Pro, no en los planes Free ni Starter.
Typebot solo comprueba la firma del webhook cuando se guarda un app secret junto con las credenciales.
El asistente de Typebot rechaza un token cuya caducidad no esté configurada como nunca.
Throughput fijo para un número usado a la vez con la app de WhatsApp Business y la Cloud API.
¿Qué campos de Typebot toman valores del número conectado?
El asistente de WhatsApp de Typebot, en la pestaña Share de un bot, pide cuatro datos: un app secret, un System User Token, un WhatsApp Business Account ID y un Phone number ID.
Tres de ellos salen directamente de la conexión. El panel muestra el id de la WABA, el phone number id y el token de acceso del número, y la herramienta get_api_credentials devuelve los mismos valores si un asistente los obtiene por ti. Pégalos en los campos correspondientes.
El app secret es el que debes dejar en blanco. Typebot lo usa para una sola cosa en el tráfico entrante: comprobar la cabecera X-Hub-Signature-256 que Meta añade a cada entrega. En un número conectado mediante un Tech Provider, Meta firma con el app secret del proveedor, que nunca se comparte, así que cualquier valor que escribas ahí hace que Typebot rechace todos los mensajes legítimos. Con el campo vacío, Typebot omite esa comprobación y acepta la entrega.
¿Dónde van la callback URL y el verify token de Typebot?
En el destino del webhook del número, no en el panel de una app de Meta.
El asistente de Typebot te indica pegar su Callback URL y su Verify Token en los ajustes de WhatsApp de tu propia app de Meta. Con Coexistencia a través de EasyCoexistence no interviene ninguna app tuya: Meta dirige los eventos del número al destino que esté configurado en la conexión. Por eso, copia ambos valores del último paso de Typebot y fíjalos como destino, en el panel o con set_webhook_destination.
Después Meta envía su GET de verificación a Typebot, Typebot responde con el challenge y, a partir de ese momento, cada mensaje al número llega al bot. El verify token de Typebot es de un solo uso: se borra de su base de datos en cuanto una verificación tiene éxito. Si más adelante vuelves a fijar el destino, genera antes un token nuevo ejecutando de nuevo el asistente.
¿Qué hace el bot con la ventana de 24 horas?
Typebot responde a personas que le han escrito, lo que mantiene casi todos los mensajes dentro de la ventana de atención al cliente. Meta abre una ventana de 24 horas cada vez que un cliente escribe, y dentro de ella se puede enviar cualquier tipo de mensaje de servicio sin plantilla. Un bot que solo responde es, por tanto, el caso fácil.
El límite aparece en un flujo que espera. Un bloque Wait, o una sesión que se reanuda después de que el cliente lleve más de un día en silencio, intentará enviar un mensaje de texto libre fuera de la ventana, y Meta lo rechaza con el error 131047. El tiempo de caducidad de sesión de Typebot, 4 horas por defecto y configurable hasta 48, decide cuándo un cliente que vuelve empieza un chat nuevo, no si Meta acepta el mensaje.
Como se trata de Coexistencia, el equipo sigue viendo todas las conversaciones en la app de WhatsApp Business y puede intervenir desde el teléfono cuando el bot no deba responder.
Errores comunes
- Pegar en Typebot el app secret de una app de Meta. Las entregas se firman con el secreto del Tech Provider, así que Typebot rechaza cada mensaje por firma no válida.
- Reutilizar un verify token antiguo de Typebot. Se borra tras una verificación correcta, así que volver a fijar el destino exige uno nuevo del asistente.
- Compartir la callback URL. Con la comprobación de firma desactivada, conocer la URL es lo que permite que entre una petición, así que trátala como una contraseña.
Conecta el número en easycoexistence.com, copia su token, el id de la WABA y el phone number id en Typebot, y fija la callback URL de Typebot como destino del webhook. Desde US$ 9 por número al mes, bajando hasta US$ 1 a medida que sumas números, con los primeros 3 días gratis.
Preguntas frecuentes
¿Necesito una app de Meta propia para Typebot?
No. La guía de Typebot da por hecho que la tienes porque la mayoría conecta un número por su cuenta. Con Coexistencia a través de un Tech Provider, el token y los ids salen de la conexión y Meta dirige el webhook a Typebot.
¿El equipo seguirá viendo en el teléfono los mensajes del bot?
Sí. Los mensajes enviados por la Cloud API aparecen en la app de WhatsApp Business del mismo número, así que una persona puede leer el hilo y tomar el relevo.
¿Pueden Typebot y n8n recibir a la vez los mensajes del mismo número?
No. Un número tiene un único destino de webhook. Si ambos necesitan los eventos, apunta el destino a n8n y haz que el flujo reenvíe el payload sin modificar a la callback URL de Typebot.
¿Typebot guarda las conversaciones?
Typebot conserva sus propios datos de sesión y resultados, como en cualquier canal. EasyCoexistence nunca almacena el contenido de los mensajes: Meta entrega directamente al destino que fijes.
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