Développez des applications basées sur Flowella, par programmation.
Lorsque les outils sans code ne permettent pas d'accomplir certaines tâches, l'API REST de Flowella et les webhooks sortants prennent le relais. Appelez l'API pour envoyer des messages WhatsApp, gérer les contacts et les désabonnements, et extraire des données analytiques. Abonnez-vous aux webhooks pour réagir en temps réel aux messages, aux livraisons, aux désabonnements et aux modifications de modèles, sans qu'il soit nécessaire d'effectuer des requêtes de vérification.
Appelez-le, et il vous rappellera.
Deux sens de communication, un seul moteur. Votre application appelle l'API REST pour déclencher des actions : envoyer un modèle, mettre à jour un contact, récupérer des données analytiques. Dans l'autre sens, Flowella envoie des événements Webhook signés à votre point de terminaison dès qu'un événement se produit, ce qui vous permet de réagir instantanément sans avoir à effectuer de requêtes de sondage. Ensemble, ils vous permettent de développer tout ce dont votre pile a besoin en s'appuyant sur le même moteur WhatsApp et HubSpot.
Envoyer, gérer et générer des rapports
Une API REST v1 simple, dotée d'une authentification par clé de porteur et d'un comportement prévisible.
L'API REST est en version 1 et accessible à l'adresse https://app.flowella.io/api/v1. Chaque requête comporte une clé « bearer » au niveau de l'organisation dans l'en-tête Authorization ; celle-ci est générée par un propriétaire ou un administrateur via le menu Paramètres > Clés API et n'est affichée qu'une seule fois. Les points de terminaison de liste utilisent une pagination par curseur avec une limite comprise entre un et cent éléments ; les erreurs sont renvoyées dans une enveloppe standard avec un champ de code fixe, et les requêtes sont limitées en nombre par organisation avec un code 429 si vous allez trop vite. Il est préférable de transmettre les numéros de téléphone au format E.164, et une spécification OpenAPI lisible par machine s'intègre directement dans Postman ou un générateur de code.
Pour les envois en masse volumineux, le point de terminaison d'envoi des modèles accepte un paramètre de limitation horaire, ce qui permet à Flowella de réguler la livraison côté serveur, plutôt que de vous obliger à réguler vous-même les requêtes.
Réagir aux événements en temps réel
Abonnez-vous aux événements qui vous intéressent et Flowella vous envoie une notification dès qu'ils se produisent.
| Événement | Lorsqu'il se déclenche |
|---|---|
| message.received | Un message WhatsApp entrant est reçu d'un contact |
| message.sent | Flowella a accepté votre message sortant et l'a transmis à Meta |
| message.delivered | Meta a confirmé la livraison sur l'appareil du destinataire |
| message.read | Le destinataire a ouvert le message |
| message.failed | Meta a renvoyé un échec pour le message |
| conversation.opened / closed | Une conversation a changé d'état |
| optout.created | Un contact s'est désabonné d'un canal |
| template.status_updated | Meta a modifié le statut d'un modèle |
Chaque requête est signée à l'aide d'un condensé hexadécimal HMAC-SHA256 du corps brut ; vérifiez donc la signature avant le traitement. Flowella attend jusqu'à dix secondes pour un code 2xx, effectue jusqu'à trois tentatives avec un délai d'attente, et désactive automatiquement un point de terminaison après dix échecs consécutifs. Étant donné que les tentatives peuvent répéter un événement, utilisez l'identifiant de l'événement comme clé d'idempotence et traitez les doublons comme des opérations sans effet.
Le « no-code » d'abord, le code quand c'est nécessaire.
L'API vient compléter le produit. Elle ne remplace pas les fonctionnalités qui fonctionnent déjà sans code.
Commencez ici pour les emplois les plus courants.
La plupart des besoins des équipes, l'envoi de modèles, la capture des réponses au flux, le déclenchement de l'automatisation, sont déjà couverts sans toucher à l'API. Ne faites appel au code que lorsque vous avez besoin de quelque chose de plus.
- Form to Flow, synchronisation native avec HubSpot
- Actions de workflow et boîte de réception
- Pas de code à écrire
Le code peut être utilisé lorsque vous avez besoin de plus d'informations.
Lorsque vous avez besoin de connecter WhatsApp à un système personnalisé, de vous synchroniser avec un outil sans connecteur natif ou de réagir à des événements dans votre propre backend, l'API et les webhooks vous donnent un contrôle total.
- Applications personnalisées et intégrations sur mesure
- Réagir aux événements sans polling
- Envois en masse avec limitation côté serveur
- ⏱️ 30 seconds · Card on file
- 👤 With · Membership team
- 📩 Receipt sent here after renewal
Choose your plan
- 🏆 Annual · £49 ✓
- 🎯 Quarterly · £15 ✓
- 📅 Monthly · £6 ✓
Powered by Flowella · Secure renewal
Des réponses claires.
Les questions que se posent les développeurs.
Comment s'authentifier ?
Une clé de support au niveau de l'organisation, créée dans la section « Paramètres », « Clés API » par un propriétaire ou un administrateur. Elle n'apparaît qu'une seule fois lors de sa création ; veillez donc à la conserver en lieu sûr et à la remplacer lorsque des collaborateurs quittent l'équipe.
Que peut faire l'API ?
Envoyez des messages et des modèles WhatsApp, gérez vos contacts et les désabonnements, répertoriez et envoyez en masse des modèles, et extrayez des données analytiques. La liste complète des points de terminaison est générée automatiquement à partir de la spécification OpenAPI.
Puis-je effectuer des envois en masse ?
Oui. Utilisez le point de terminaison d'envoi des modèles avec un paramètre de limitation horaire : Flowella gère alors la cadence côté serveur, vous n'avez donc pas besoin de gérer vous-même les limites de temps ou de fréquence d'accès.
Comment vérifier l'authenticité d'un webhook ?
Chaque webhook est signé à l'aide d'un condensé HMAC-SHA256 du corps brut de la requête. Calculez le même condensé à l'aide de votre clé de signature et comparez-le ; veillez à signer les octets bruts avant toute analyse JSON.
Que se passe-t-il si mon point d'accès est en panne ?
Flowella effectue jusqu'à trois tentatives avec un délai d'attente, puis désactive automatiquement le point de terminaison après dix échecs consécutifs. Une fois votre point de terminaison réparé, réactivez-le dans les paramètres, sous « Webhooks ».
Comment éviter de traiter des doublons ?
Utilisez l'identifiant de l'événement comme clé d'idempotence, conservez un cache temporaire des clés traitées et ignorez les doublons. Les tentatives de réessai impliquent qu'un même événement peut arriver plusieurs fois.
Consultez la documentation pour les développeurs
Tout le contenu de cette page, y compris la documentation complète et les exemples de code, se trouve dans la documentation.
La documentation complète destinée aux développeurs est disponible dans la base de connaissances.
La présentation de l'API couvre l'URL de base, l'authentification, les erreurs, la pagination, les limites de débit et la spécification OpenAPI.
La section sur les webhooks sortants traite de la configuration d'un webhook, de la liste complète des événements, de la vérification de la signature, des tentatives de réessai et de l'idempotence, avec des exemples de code.
Partant du même moteur, adaptez-le à votre guise.
