Conecta WhatsApp a Activepieces en un número con Coexistencia

¿Cómo se conecta un número con Coexistencia a Activepieces?

Crea la conexión de WhatsApp Business en Activepieces con dos valores: el token de acceso y el id de WhatsApp Business Account. El panel de EasyCoexistence muestra ambos para la conexión, y get_api_credentials se los devuelve a un asistente. Las instrucciones de la pieza hablan de crear una app de Meta y un usuario del sistema, porque dan por hecho que no tienes ninguno. Aquí el número ya está conectado, así que ve directo a pegar los valores.

Después crea un flujo que empiece con el disparador New Incoming Message, define en él un token de verificación a tu elección y publica el flujo. Copia la URL del webhook del disparador en el destino del webhook del número en EasyCoexistence, con el mismo token de verificación. Meta envía su petición de verificación, el disparador la responde y cada mensaje al número inicia una ejecución.

¿Por qué debe quedar vacío el secreto de la app?

Porque el secreto que firma estas entregas no es tuyo para pegarlo. Meta firma cada webhook con el secreto de la app propietaria de la suscripción, y en un número conectado mediante EasyCoexistence esa es la app de EasyCoexistence, cuyo secreto nunca se comparte.

La pieza trata el campo como opcional. Si lo dejas vacío, sus disparadores aceptan las entregas tal como llegan. Si lo rellenas con el secreto de cualquier otra app, todas las entregas fallan la comprobación de X-Hub-Signature-256 y se ignoran en silencio, lo que se ve igual que mensajes que no llegan.

El token de verificación es lo que deja fuera a los extraños en el intercambio inicial. Elige un valor largo y aleatorio, y mantén privada la URL del disparador, porque es la dirección que inicia tu flujo.

¿Qué puede hacer un flujo cuando llega un mensaje?

El disparador entrega al flujo un mensaje aplanado: remitente, nombre de perfil, id del mensaje, tipo, texto, el id de cualquier archivo multimedia, respuestas de botones y listas, y el id del número de teléfono que lo recibe. A partir de ahí es un flujo corriente de Activepieces con sus otras piezas, como un CRM, una hoja de cálculo o un paso de IA.

Las respuestas usan la misma pieza. Enviar mensaje manda texto libre, y solo se entrega dentro de las 24 horas posteriores al último mensaje del cliente. La acción que envía una plantilla aprobada es lo único que se entrega pasada esa ventana. Los botones interactivos, las listas, los archivos multimedia, la ubicación y las reacciones son acciones aparte.

Las propias instrucciones de Activepieces señalan que Meta admite una sola URL de callback por app. Con destinos por número, el límite es una URL por número, así que un flujo que deba atender varios tipos de evento debe ramificarse dentro de un único flujo.

¿Las respuestas escritas en el teléfono llegan al flujo?

Llegan al webhook, pero no a este disparador. En un número con Coexistencia, Meta envía al mismo destino un eco de cada respuesta escrita en la app de WhatsApp Business, bajo el campo smb_message_echoes. El disparador New Incoming Message de la pieza solo lee el campo messages y descarta todo lo demás.

Si necesitas las respuestas del teléfono en el flujo, empiézalo con la pieza genérica Webhook de Activepieces, que acepta cualquier método HTTP, y responde al GET de verificación con un paso Return Response en su URL síncrona. Después analizas tú mismo la carga útil sin procesar, con ambos campos incluidos.

Para la mayoría de los flujos, el disparador de la pieza es la opción más sencilla: reacciona a los clientes, y las respuestas del equipo siguen visibles en la app del teléfono.

Errores comunes

• Pegar un secreto de app en la conexión de WhatsApp. Las entregas se firman con el secreto de la app de EasyCoexistence, así que se ignoran todas.
• Fijar el destino antes de publicar el flujo. Meta verifica de inmediato y un flujo sin publicar no puede responder.
• Esperar que el disparador New Incoming Message vea las respuestas escritas en el teléfono. Solo lee el campo messages, no smb_message_echoes.

Preguntas frecuentes

Sigue leyendo