Envoyer un message avec l'API WhatsApp

Envoie 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.

Identifiant
whatsapp_send_message

L'appel

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
    }
  }
}

Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.

Exemple illustratif. Remplacez les tokens, l’UUID de connexion et les données de destination par les vôtres. Cette page n’exécute pas la requête.

Avant l’exécution

  • Pour type=text, ajoutez text.body. Le numéro destinataire doit contenir l’indicatif du pays et uniquement des chiffres. Utilisez le phone_number_id du compte professionnel connecté.
  • Le texte libre s’utilise dans les 24 heures suivant le message de l’utilisateur. En dehors de cette fenêtre, utilisez type=template avec un modèle approuvé, language et les paramètres qu’il exige.
  • L’ID renvoyé identifie un message accepté par l’API ; il ne confirme pas sa livraison. Consultez api_error.body en cas d’erreur HTTP du fournisseur.

Paramètres

Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.

ParamètreTypeObligatoireDescription
phone_number_idstringOuiId of the business phone number that sends, from List phone numbers.
messaging_productstringOuiAlways whatsapp.Valeurs : whatsapp
recipient_typestringOuiindividual for a person, group for a WhatsApp group of the number.Valeurs : individual, group
tostringOuiPhone number of the person with country code, digits only, for example 5511987654321, or the id of the group.
typestringOuiKind of message. Send the object with the same name, such as text or template.Valeurs : text, template, image, video, document, audio
textobjectOui, si type=textFor type text.
templateobjectOui, si type=templateFor type template.
imageobjectOui, si type=imageFor type image: a JPEG or PNG at a public URL.
videoobjectOui, si type=videoFor type video: an MP4 or 3GP at a public URL.
documentobjectOui, si type=documentFor type document: a file at a public URL, such as a PDF.
audioobjectOui, si type=audioFor type audio: an audio file at a public URL.

Connexions possibles

Votre client connecte son compte WhatsApp une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.

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.

La réponse

En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.

Format illustratif de réussite

{
  "messaging_product": "whatsapp",
  "messages": [
    {
      "id": "wamid.EXAMPLE"
    }
  ]
}

Le contenu est un exemple, pas une exécution enregistrée. Conservez X-Toolkit-Execution-Id lorsqu’il est renvoyé pour consulter l’exécution. Connect ne gère ni relance ni idempotence : répéter un POST peut répéter l’envoi.

Prête pour les agents IA

L'input de cette tool est un JSON Schema, disponible via GET /api/tools/whatsapp_send_message. Il devient la définition de tool de votre agent sans conversion.

Autres tools WhatsApp

Voir les 10 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.