No hay ninguna app que instalar en Customer.io. Construyes ambas direcciones con acciones estándar de Customer.io, así que decides exactamente qué solicitudes se ejecutan y qué atributos cambian.
Cómo funciona la integración
Flowella nunca llama a la API de Customer.io. En la dirección entrante opcional, Flowella solo envía eventos a la URL de webhook que le indiques, y tu automatización decide qué hacer con ellos.
Antes de empezar
- Una organización de Flowella con un número de WhatsApp conectado. Consulta Orden de configuración.
- Una plantilla de WhatsApp aprobada en Flowella. Consulta Plantillas.
- El rol Owner o Admin en Flowella, para crear una clave de API y, para la sincronización entrante, un webhook. Consulta Equipo y roles.
- Un espacio de trabajo de Customer.io en el que puedas crear campañas o automatizaciones con acciones de webhook.
- El número de WhatsApp de cada persona guardado en su perfil de Customer.io en formato internacional, como
+447700900123. Consulta Formato de números de teléfono. - El consentimiento de cada persona para recibir mensajes de WhatsApp tuyos. Meta exige el opt-in antes de escribir a nadie. Consulta la guía de opt-in de Meta.
Envía una plantilla de WhatsApp desde Customer.io
1
Crea una clave de API de Flowella
En Flowella, ve a Settings, luego a API keys, y crea una clave live con un nombre como
Customer.io production. Cópiala enseguida: Flowella solo la muestra una vez. Consulta Claves de API.2
Busca los ID de la plantilla y del canal
Llama a
GET /v1/templates?status=APPROVED con tu clave. Anota el id y el wabaId de la plantilla, y el whatsappChannelId del número desde el que quieres enviar. Consulta Varios números si tienes más de un número.3
Añade una acción de webhook a tu campaña
En el workflow de tu campaña de Customer.io, añade una acción Send and receive data en el punto en que deba salir el mensaje de WhatsApp. Consulta la guía de Customer.io sobre acciones de webhook.
4
Configura la solicitud
Establece el método
POST y la URL https://api.flowella.io/v1/templates/send. Añade estas cabeceras:5
Escribe el cuerpo de la solicitud
Pega este cuerpo y sustituye los ID por los tuyos. Cambia
customer.phone por el atributo que contiene el número de WhatsApp de la persona.bodyParameters rellena las variables del cuerpo de la plantilla en orden: el primer valor va en {{1}}, el segundo en {{2}}, y así sucesivamente. Déjalo como una lista vacía, [], si la plantilla no tiene variables en el cuerpo.6
Prueba la acción
Elige una persona de prueba con tu propio número de WhatsApp y selecciona Test response en Customer.io. Añade una cabecera
Idempotency-Key con un valor que no hayas usado antes, como test-2026-11-11-01, y cámbialo en cada prueba. Consulta Envíos repetidos e idempotencia.Una respuesta 202 con "status": "accepted" significa que Flowella puso el envío en cola. No confirma la entrega: consulta el resultado en la pestaña Statistics de la plantilla en Flowella.7
Quita la cabecera de prueba e inicia la campaña
Elimina la cabecera
Idempotency-Key que usaste para las pruebas, o sustitúyela por un valor distinto para cada persona. Después, inicia la campaña.Opciones de plantilla para cada persona
El cuerpo de la solicitud acepta estos campos para cada destinatario. La introducción a la API y el documento OpenAPI describen la solicitud completa.
En una plantilla con encabezado de imagen, vídeo o documento, puedes indicar un enlace público al archivo en
headerMedia.url, en el nivel superior del cuerpo.
Envíos repetidos e idempotencia
POST /v1/templates/send te protege de enviar el mismo mensaje dos veces, algo importante porque Customer.io reintenta una acción de webhook cuando no recibe una respuesta 2xx:
- Sin una cabecera
Idempotency-Key, Flowella usa un hash del cuerpo de la solicitud como clave. Un cuerpo idéntico byte a byte en un plazo de 7 días devuelve elidoriginal y no envía nada. Como el cuerpo de cada persona contiene su propio número, una campaña normal envía a todos una vez. - Con una cabecera
Idempotency-Key, cualquier solicitud con la misma clave en un plazo de 7 días devuelve elidoriginal y no envía nada, aunque el cuerpo haya cambiado. - Además, Flowella omite un segundo envío de la misma plantilla al mismo número en un plazo de 15 segundos.
Idempotency-Key cada vez.
Envíos a un segmento grande
Cada solicitud de Customer.io pone en cola un envío, y Flowella lo entrega en segundo plano y reintenta los errores temporales de WhatsApp. En las campañas grandes se aplican dos límites:- El límite de mensajes de Meta. Meta limita a cuántas personas puedes escribir fuera de la ventana de 24 horas en un periodo móvil de 24 horas. Consulta Límites de mensajes.
- El límite de velocidad de tu clave de API. Las solicitudes que superan el límite devuelven
429con una cabeceraRetry-After. Consulta Límites de velocidad.
Sincroniza los mensajes entrantes con Customer.io (opcional)
Esta parte envía a Customer.io cada mensaje de WhatsApp que te manda un contacto, para que puedas actualizar a la persona o iniciar otras campañas a partir de él.1
Crea una automatización activada por webhook en Customer.io
Crea una campaña o automatización activada por webhook y copia la URL de webhook que genera Customer.io. Consulta la guía de Customer.io sobre campañas activadas por webhook.
2
Añade un webhook saliente en Flowella
En Flowella, ve a Settings, luego a Webhooks, y selecciona Add webhook. Pega la URL de Customer.io en Endpoint URL, introduce un secreto de firma y marca solo
message.received en Events. Consulta Webhooks.3
Envía datos de ejemplo
Envíate una plantilla de WhatsApp desde Flowella y respóndela, para que Customer.io reciba un evento Send test event en Flowella envía un evento
message.received real con el que construir el workflow. Cada evento tiene este aspecto:webhook.test, que no tiene contacto, así que fíltralo en el paso siguiente.4
Quédate solo con los mensajes entrantes reales
Añade una True/False Branch que continúe solo cuando el
type del disparador sea message.received.5
Busca el contacto en Flowella
El evento contiene ID, no el número de teléfono. Añade una acción Send and receive data con el método
GET, la URL https://api.flowella.io/v1/contacts/{{trigger.data.contactId}} y la misma cabecera Authorization que antes. La respuesta incluye id, phone, waId, name, email, externalId, isOptedOut, createdAt y updatedAt del contacto.Para guardar el propio mensaje, añade otra solicitud a GET /v1/messages/{{trigger.data.messageId}}. Su campo body contiene el texto del mensaje y puede estar vacío.6
Actualiza a la persona
Añade una acción Create or Update Person. Elige el identificador que usa tu espacio de trabajo para las personas y define solo los atributos que necesites, como la hora de la última respuesta por WhatsApp. Consulta la guía de Customer.io sobre Create or update person.
Seguridad del webhook entrante
Flowella firma cada solicitud con la cabeceraX-Flowella-Signature. Una automatización de Customer.io activada por webhook no puede comprobar esa firma, así que cualquiera que tenga la URL de webhook de Customer.io puede enviarle datos. Mantén la URL en privado y no uses la sincronización entrante para cambiar atributos de consentimiento o de facturación. Consulta Verificar firmas si primero diriges los eventos a tu propio endpoint.
Exclusiones
Cuando un contacto envíaSTOP u otra palabra clave de exclusión, Flowella registra la exclusión en ese número de WhatsApp y bloquea todos los envíos posteriores a ese contacto desde él, incluidos los envíos desde Customer.io. Consulta Exclusiones.
Para copiar las exclusiones en Customer.io, no te bases en el evento optout.created: por ahora no se dispara con la primera exclusión de un contacto en un número. En su lugar, lista las exclusiones con GET /v1/opt-outs, que acepta los filtros createdAfter y phone.
Solución de problemas
Relacionado
Introducción a la API
Autenticación, idempotencia, límites de velocidad y errores.
Referencia de webhooks
Tipos de eventos, cuerpos de las solicitudes y firmas.
Variables de plantilla
Variables, ejemplos y valores de respaldo.
Envío masivo
Envía una plantilla a una lista desde la app de Flowella.

