Développez votre propre code en vous appuyant sur Flowella.

Avec une clé « bearer » au niveau de l'organisation dans l'en-tête « Authorization ». Les propriétaires et les administrateurs créent des clés dans « Paramètres », puis « Clés API ». Chaque clé commence par « flo_ » et n'est affichée qu'une seule fois ; veillez donc à la conserver en lieu sûr et à la remplacer lorsque des membres de l'équipe quittent l'entreprise.

Gérer les clés API

Envoyez des messages et des modèles WhatsApp, y compris des codes à usage unique et des boutons de lien spécifiques à chaque contact, créez et mettez à jour des contacts, activez ou désactivez les options de désabonnement, affichez la liste des conversations et des modèles, et récupérez les statistiques relatives aux messages sortants. La liste des points de terminaison provient de la spécification OpenAPI, qui s'intègre directement dans Postman ou dans un générateur de code.

Oui, via l’API, et uniquement par ce biais. Un bouton « Copier le code » nécessite un code à chaque envoi, et seule l’API génère un bouton de lien unique par personne : depuis un workflow HubSpot, tout le monde reçoit le lien de secours unique du modèle. Pour envoyer un lien personnalisé par contact depuis HubSpot, placez-le dans une variable de corps de message : WhatsApp le rendra alors cliquable. Les codes peuvent comporter jusqu’à 15 caractères, et l’envoi du même modèle vers le même numéro dans un délai de 15 secondes est ignoré. L’API renvoie le code d’état 202 et effectue l’envoi immédiatement, sauf si vous avez défini le paramètre `scheduledAt`.

L'URL de base est https://api.flowella.io/v1. Les listes utilisent une pagination par curseur avec une limite comprise entre 1 et 100 ; les erreurs sont regroupées dans une seule réponse avec un code d'erreur fixe ; et chaque organisation est soumise à une limitation de débit, avec un code d'erreur 429 et un en-tête « Retry-After » si vous effectuez des requêtes trop rapidement. Transmettez les numéros de téléphone au format E.164.

Présentation de l'API

Oui. La requête POST /v1/templates/send met l'envoi en file d'attente et renvoie le code de statut 202 Accepted avec un identifiant de tâche. L'ajout de « throttlePerHour » et de Flowella permet de réguler le débit côté serveur. L'ajout d'une clé d'idempotence (Idempotency-Key) garantit qu'une nouvelle tentative dans les sept jours renvoie la même tâche au lieu de l'envoyer à nouveau.

Chaque transmission comporte un champ « X-Flowella-Signature », qui correspond à un condensé hexadécimal HMAC-SHA256 du corps brut de la requête, généré à l'aide de votre clé de signature. Calculez le même condensé à partir des octets bruts, avant toute analyse JSON, puis comparez-le. Lors d'une rotation de clé, le champ « X-Flowella-Signature-Previous » contient le condensé généré à l'aide de l'ancienne clé.

Webhooks sortants

Flowella attend jusqu'à 10 secondes pour obtenir un code d'état 2xx et effectue au maximum 3 tentatives de transmission, espacées de 1 et 2 secondes ; il est donc conseillé de répondre rapidement et de traiter la tâche par la suite. Dans les paramètres, la section « Webhooks » répertorie les dernières transmissions pour chaque point de terminaison.

Une nouvelle tentative peut entraîner la transmission deux fois du même événement. Chaque transmission comporte l'identifiant de l'événement au niveau supérieur, qui est identique à chaque nouvelle tentative ; veillez donc à conserver brièvement une trace des identifiants que vous avez déjà traités et à ignorer les doublons.

Non. Elle contient les identifiants du message, de la conversation et du contact, ainsi que la direction et le type, mais pas le numéro de téléphone ni le contenu du message, et l'API ne propose pas d'appel permettant de lire un message individuel. L'événement « optout.created » contient quant à lui le numéro de téléphone et le motif.