Fonctionnement de l’intégration
Avant de commencer
- Une organisation Flowella avec un numéro WhatsApp connecté. Voir Étapes de configuration.
- Un modèle WhatsApp approuvé dans Flowella. Voir Modèles.
- Le rôle Owner ou Admin dans Flowella, pour créer une clé API et, pour la synchronisation entrante, un webhook. Voir Équipe et rôles.
- Un espace de travail Customer.io dans lequel vous pouvez créer des campagnes ou des automatisations avec des actions webhook.
- Le numéro WhatsApp de chaque personne enregistré sur son profil Customer.io au format international, par exemple
+447700900123. Voir Format des numéros de téléphone. - L’accord de chaque personne pour recevoir vos messages WhatsApp. Meta exige un opt-in avant tout message. Voir les recommandations de Meta sur l’opt-in.
Envoyer un modèle WhatsApp depuis Customer.io
Créez une clé API Flowella
Customer.io production. Copiez-la immédiatement : Flowella ne l’affiche qu’une fois. Voir Clés API.Trouvez les identifiants du modèle et du canal
GET /v1/templates?status=APPROVED avec votre clé. Notez l’id et le wabaId du modèle, ainsi que le whatsappChannelId du numéro d’envoi. Voir Multi-canal si vous avez plusieurs numéros.Ajoutez une action webhook à votre campagne
Paramétrez la requête
POST et l’URL https://api.flowella.io/v1/templates/send. Ajoutez ces en-têtes :Rédigez le corps de la requête
customer.phone par l’attribut qui contient le numéro WhatsApp de la personne.bodyParameters remplit les variables du corps du modèle dans l’ordre : la première valeur va dans {{1}}, la deuxième dans {{2}}, et ainsi de suite. Laissez une liste vide, [], si le modèle n’a pas de variable dans le corps.Testez l'action
Idempotency-Key avec une valeur jamais utilisée, par exemple test-2026-11-11-01, et changez-la à chaque test. Voir Envois répétés et idempotence.Une réponse 202 avec "status": "accepted" signifie que Flowella a mis l’envoi en file. Elle ne confirme pas la livraison : consultez l’onglet Statistics du modèle dans Flowella pour le résultat.Retirez l'en-tête de test et lancez la campagne
Idempotency-Key utilisé pour les tests, ou remplacez-le par une valeur différente pour chaque personne. Lancez ensuite la campagne.Options de modèle par personne
Le corps de la requête accepte ces champs pour chaque destinataire. L’introduction à l’API et le document OpenAPI décrivent la requête complète.headerMedia.url, au premier niveau du corps.
Envois répétés et idempotence
POST /v1/templates/send vous évite d’envoyer deux fois le même message, ce qui compte car Customer.io relance une action webhook lorsqu’il ne reçoit pas de réponse 2xx :
- Sans en-tête
Idempotency-Key, Flowella utilise une empreinte du corps de la requête comme clé. Un corps identique à l’octet près dans les 7 jours renvoie l’idd’origine et n’envoie rien. Comme le corps de chaque personne contient son propre numéro, une campagne normale envoie une fois à chacun. - Avec un en-tête
Idempotency-Key, toute requête portant la même clé dans les 7 jours renvoie l’idd’origine et n’envoie rien, même si le corps a changé. - Par ailleurs, Flowella ignore un second envoi du même modèle au même numéro dans les 15 secondes.
Idempotency-Key à chaque fois.
Envoyer à un grand segment
Chaque requête de Customer.io met un envoi en file, que Flowella livre en arrière-plan en relançant les erreurs WhatsApp temporaires. Deux limites s’appliquent aux grandes campagnes :- La limite de messagerie de Meta. Meta plafonne le nombre de personnes que vous pouvez contacter hors fenêtre de 24 heures sur 24 heures glissantes. Voir Limites de messagerie.
- La limite de débit de votre clé API. Les requêtes au-delà de la limite renvoient
429avec un en-têteRetry-After. Voir Limites de débit.
Synchroniser les messages WhatsApp entrants vers Customer.io (facultatif)
Cette partie envoie vers Customer.io chaque message WhatsApp qu’un contact vous adresse, pour mettre à jour la personne ou lancer d’autres campagnes.Créez une automatisation déclenchée par webhook dans Customer.io
Ajoutez un webhook sortant dans Flowella
message.received sous Events. Voir Webhooks.Envoyez des données d'exemple
message.received à partir duquel construire le workflow. Chaque événement ressemble à ceci :webhook.test, sans contact : filtrez-le à l’étape suivante.Ne gardez que les vrais messages entrants
type du déclencheur vaut message.received.Recherchez le contact dans Flowella
GET, l’URL https://api.flowella.io/v1/contacts/{{trigger.data.contactId}} et le même en-tête Authorization que précédemment. La réponse contient les champs id, phone, waId, name, email, externalId, isOptedOut, createdAt et updatedAt du contact.Pour enregistrer le message lui-même, ajoutez une autre requête vers GET /v1/messages/{{trigger.data.messageId}}. Son champ body contient le texte du message et peut être vide.Mettez à jour la personne
Sécurité du webhook entrant
Flowella signe chaque requête avec l’en-têteX-Flowella-Signature. Une automatisation Customer.io déclenchée par webhook ne peut pas vérifier cette signature : toute personne disposant de l’URL de webhook Customer.io peut y publier des données. Gardez l’URL privée, et n’utilisez pas la synchronisation entrante pour modifier des attributs de consentement ou de facturation. Voir Vérifier les signatures si vous faites d’abord transiter les événements par votre propre endpoint.
Désinscriptions
Lorsqu’un contact envoieSTOP ou un autre mot-clé de désinscription, Flowella enregistre la désinscription sur ce numéro WhatsApp et bloque tout envoi ultérieur depuis ce numéro, y compris depuis Customer.io. Voir Désinscriptions.
Pour copier les désinscriptions dans Customer.io, ne vous fiez pas à l’événement optout.created : il ne se déclenche pas actuellement pour la première désinscription d’un contact sur un numéro. Listez plutôt les désinscriptions avec GET /v1/opt-outs, qui accepte les filtres createdAfter et phone.

