Envoi de messages texte

Vous pouvez utiliser le nœud messages pour envoyer des messages texte à votre clientèle.

Avant de commencer

Vous devez remplir toutes les conditions requises indiquées dans la section Avant de commencer de la documentation sur les messages.

Contraintes :

• Un message texte peut contenir jusqu’à 4 096 caractères.

Étape 1 : envoyer une requête POST à /messages

Une fois que vous disposez de l’ID WhatsApp de la personne à laquelle vous souhaitez envoyer un message, utilisez-le pour envoyer un message texte. Indiquez text dans le champ type.

POST /v1/messages
{
    "preview_url": false | true,
    "recipient_type": "individual",
    "to": "whatsapp-id",
    "type": "text",
    "text": {
        "body": "your-text-message-content"
    }
}

Pour en savoir plus sur les paramètres, consultez les rubriques suivantes :

• Paramètres communs à toutes les requêtes de message
• Paramètres des messages texte

Si vous souhaitez mettre votre message en forme, consultez Formatage dans les messages texte.

Envoi d’URL dans les messages texte

Par défaut, l’application mobile WhatsApp reconnaît les URL et les rend cliquables. Pour inclure un aperçu de l’URL, insérez "preview_url": true dans le corps du message et assurez-vous que l’URL commence par http:// ou https://. Un nom d’hôte est requis, les adresses IP ne sont pas associées.

Notez que l’utilisation de preview_url ici est différente de celle de l’API Cloud. Consultez la documentation de l’API Cloud sur les messages.

Exemple

{
    "preview_url": true,
    "to": "whatsapp-id",
    "text": {
        "body": "You have to check out this amazing messaging service https://www.whatsapp.com/"
     }

La plupart du temps, lorsque vous envoyez une URL, que ce soit avec un aperçu ou non, la personne destinataire du message voit une URL sur laquelle elle peut cliquer.

Les aperçus d’URL s’affichent uniquement après les actions suivantes :

1. L’entreprise a envoyé un modèle de message au particulier.
2. Le particulier commence une conversation avec un lien « cliquer pour discuter ».
3. Le particulier ajoute le numéro de téléphone professionnel à son carnet d’adresses et commence une conversation.

Étape 2 : vérifier votre réponse

Une réponse positive comprend un objet messages avec un ID pour le message nouvellement créé.

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

En cas d’échec, la réponse renvoyée contient un message d’erreur. Pour plus d’informations, consultez Codes d’erreur et d’état.