Qui peut l’utiliser
API base URL
Cette carte affiche l’adresse de l’API REST. Dans votre intégration, utilisezhttps://api.flowella.io/v1 comme URL de base, même si la carte affiche une adresse se terminant par /api/v1. Voir URL de base pour en savoir plus.
Recent API requests
Cette carte liste les 25 requêtes API les plus récentes adressées à votre organisation avec des clés API ou des jetons d’accès OAuth, de la plus récente à la plus ancienne.
Les requêtes que Flowella refuse avant de les exécuter ne sont pas listées. C’est le cas des requêtes avec un jeton manquant ou invalide, un scope manquant, un en-tête
API-Version non pris en charge, ou qui dépassent la limite de débit.
Pour voir tout ce qui est lié à une requête, comme les événements, les tâches et les envois de webhooks qu’elle a déclenchés, appelez GET /v1/requests/{requestId} avec le Request id. Cet appel nécessite le scope account:read. Voir ID de requête.
API sandbox
La carte API sandbox comporte un interrupteur à l’échelle de l’organisation pour tester sans rien envoyer à WhatsApp. Le badge affiche Active lorsque la sandbox est activée et Off lorsqu’elle est désactivée. Sandbox guide ouvre le guide de la sandbox dans l’application. Pour activer la sandbox, un Owner ou un Admin coche la case en bas de la carte. Décochez-la pour désactiver la sandbox. La modification s’applique immédiatement à toute l’organisation. Vous pouvez aussi lire et modifier ce paramètre avecGET /v1/sandbox et PATCH /v1/sandbox, avec le corps { "enabled": true } ou { "enabled": false }. Les deux nécessitent le scope sandbox:manage.
API sandbox et clés sandbox
Il existe deux façons d’utiliser la sandbox. L’API sandbox à l’échelle de l’organisation couvre toutes les requêtes, tandis qu’une clé sandbox ne couvre que les requêtes effectuées avec cette clé.Ce qui change dans la sandbox
Lorsque la sandbox couvre une requête :POST /v1/messagesstocke le message dans la conversation et renvoie"sandbox": trueavecmetaMessageIddéfini surnull. Rien n’atteint WhatsApp, et aucun webhookmessage.sentn’est déclenché.- La soumission de modèle avec
POST /v1/templates/{id}/submitn’atteint pas Meta. Elle approuve immédiatement le modèle, ou le rejette si le nom du modèle contientreject_. Un en-tête média dont l’exemple n’est qu’une adresse web est refusé avec400 INVALID_TEMPLATE_COMPONENTS. La décision apparaît dans l’API et dans le flux d’événements, mais la page Templates de l’application ne change pas. - La sandbox fonctionne dans votre organisation réelle. Les contacts, conversations et messages créés pendant les tests sont stockés comme les autres et apparaissent dans l’application.
Outils de test de la sandbox
Ces endpoints vous aident à simuler de l’activité. Ils nécessitent le scopesandbox:manage et fonctionnent que la sandbox soit activée ou non : utilisez-les donc uniquement avec des données de test.
Les outils de test n’écrivent que dans le flux d’événements (
GET /v1/events). Ils n’envoient pas de webhooks et ne modifient pas le message lui-même.
Quickstarts
La carte Quickstarts renvoie vers des guides pas à pas. Chacun s’ouvre sous forme de fichier Markdown dans un nouvel onglet.Links
Voir aussi
Introduction à l'API
Authentification, scopes, limites de débit et erreurs.
Clés API
Créez des clés live et sandbox.
Applications développeur
Enregistrez une application OAuth et gérez les applications installées.
Référence des webhooks
Types d’événements, payloads et vérification des signatures.