Communication
WhatsApp dans votre produit et vos agents IA, via une API
Le toolkit WhatsApp Cloud API couvre les comptes professionnels, les numéros de téléphone, l'envoi de messages, les modèles de message et le profil professionnel d'un numéro. Avec Connect, votre produit ou agent IA appelle le tout par un seul endpoint, pendant que Connect stocke les identifiants et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/whatsapp_send_message/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"phone_number_id": "<phone_number_id>",
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "<recipient_number_with_country_code>",
"type": "text",
"text": {
"body": "Hello! This is an example message.",
"preview_url": false
}
}
}Fonctionnement
Du client connecté au premier appel à WhatsApp.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte WhatsApp. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec WhatsApp.
Envoyer des notifications par modèle
Un SaaS démarre une conversation en envoyant un message de type template avec un modèle approuvé, par exemple pour confirmer une commande.
Gérer les modèles depuis votre app
Un produit crée un modèle de message, le soumet à la revue de Meta, puis le modifie ou le supprime quand le contenu change.
Répondre aux clients avec un agent
Un agent IA répond par un message texte libre à une personne qui a écrit au numéro au cours des dernières 24 heures.
Tools
10 tools WhatsApp
- Lister les comptes professionnelsGETListe les comptes professionnels WhatsApp accessibles à l'utilisateur système, avec id et nom. Cet id est le waba_id des autres outils, que Meta appelle désormais aussi Messaging account id. La réponse contient data et paging.cursors.after : passez-le comme after pour lire la page suivante.
- Obtenir un compte professionnelGETRenvoie un compte professionnel WhatsApp avec les champs demandés, qui peuvent être des données du compte ou des analytics. Sans fields, seuls id et name reviennent.
- Lister les numéros de téléphoneGETListe les numéros de téléphone professionnels d'un compte professionnel WhatsApp avec id, display_phone_number, verified_name et quality_rating. Cet id est le phone_number_id des outils de message et de profil. La réponse contient data et paging.cursors.after : passez-le comme after pour lire la page suivante.
- Envoyer un messagePOSTEnvoie un message depuis un numéro de téléphone professionnel et renvoie son id dans messages[0].id. Les types libres (text, image, video, document, audio) n'atteignent que les personnes qui ont écrit au numéro au cours des dernières 24 heures ; pour démarrer une conversation, envoyez le type template avec un modèle approuvé issu de Lister les modèles de message. Meta facture les messages au compte selon ses tarifs WhatsApp.
- Lister les modèles de messageGETListe les modèles de message d'un compte professionnel WhatsApp avec id, name, language, status, category et components. La réponse contient data et paging.cursors.after : passez-le comme after pour lire la page suivante.
- Créer un modèle de messagePOSTCrée un modèle de message et le soumet à la revue de Meta, en renvoyant id, status et category. Il peut être envoyé une fois le statut APPROVED, ce qui peut prendre jusqu'à 24 heures. Les variables sont {{1}}, {{2}} au format POSITIONAL ou {{first_name}} au format NAMED, et chacune a besoin d'un exemple. Un en-tête image, vidéo ou document nécessite un file handle issu d'un upload, que cette connexion ne fait pas.
- Mettre à jour un modèle de messagePOSTModifie un modèle et le renvoie en revue. Seuls les modèles aux statuts APPROVED, REJECTED ou PAUSED peuvent être modifiés, et uniquement leur catégorie et leurs components ; components remplace toutes les parties. Un modèle approuvé accepte jusqu'à 10 modifications en 30 jours et 1 en 24 heures, et sa catégorie ne peut pas changer.
- Supprimer un modèle de messageDELETESupprime un modèle par son nom, dans toutes les langues, ou uniquement la version dont l'id est hsm_id. Le nom d'un modèle approuvé supprimé ne peut pas être réutilisé pendant 30 jours.
- Obtenir le profil professionnelGETRenvoie le profil professionnel que voient les gens sur un numéro de téléphone : about, address, description, email, websites, vertical et profile_picture_url.
- Mettre à jour le profil professionnelPOSTMet à jour le profil professionnel d'un numéro de téléphone. Les champs omis conservent leur valeur, et websites remplace les sites web du profil.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit WhatsApp
Dois-je intégrer l'API WhatsApp moi-même ?
Non. Connect fournit 10 tools WhatsApp décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte WhatsApp ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
