Boutons interactifs

Les boutons interactifs sont disponibles avec les messages text, image, video et document. Ils peuvent être utilisés avec l’envoi individuel, l’envoi par lot, les messages de groupe et les variations de campagnes.

L’affichage des boutons dépend de la version et de la plateforme WhatsApp du destinataire. WaChap peut désactiver temporairement cette fonctionnalité en cas d’instabilité WhatsApp. Dans ce cas, le message principal est envoyé sans les boutons ni le pied de message.

Structure

Ajoutez buttons et, facultativement, footerText au même niveau que le contenu du message :

{
  "buttons": [
    {
      "id": "confirm",
      "text": "Confirmer",
      "type": "reply"
    },
    {
      "id": "website",
      "text": "Voir le site",
      "type": "url",
      "url": "https://wachap.com"
    },
    {
      "id": "support",
      "text": "Nous appeler",
      "type": "call",
      "phoneNumber": "+2290100000000"
    }
  ],
  "footerText": "Choisissez une option"
}

Types de boutons

Type	Champ supplémentaire	Description
`reply`	Aucun	Envoie une réponse rapide dans la conversation
`url`	`url`	Ouvre une URL publique en `http://` ou `https://`
`call`	`phoneNumber`	Propose d’appeler un numéro au format international

Contraintes

Élément	Limite
Nombre de boutons	1 à 3 par message
Texte d’un bouton	1 à 20 caractères
Identifiant `id`	Unique dans le message ; généré automatiquement s’il est omis
Pied `footerText`	60 caractères maximum
Numéro d’appel	6 à 15 chiffres, avec `+` international facultatif

Le message doit contenir du texte lorsqu’il comporte des boutons :

content pour un message text ;
caption pour une image, une vidéo ou un document.

Les boutons ne sont pas pris en charge pour audio, location et contact. Si buttons est vide ou omis, footerText est ignoré.

Exemple complet

curl -X POST https://api.wachap.com/v1/whatsapp/messages/send \
  -H "Authorization: Bearer token" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "accountId": "account_123",
      "to": "+2290100000000",
      "type": "text",
      "content": "Souhaitez-vous confirmer votre inscription ?",
      "buttons": [
        {"id": "yes", "text": "Oui", "type": "reply"},
        {"id": "help", "text": "Plus d’infos", "type": "url", "url": "https://wachap.com/aide"}
      ],
      "footerText": "WaChap"
    }
  }'

Introduction Envoyer un message texte

Introduction

Authentification

Compte

Messages WhatsApp

Contacts WhatsApp

Étiquettes WhatsApp

Listes de contacts

Campagnes

Groupes WhatsApp

Statuts

Chaînes WhatsApp

SMS

Structure

Types de boutons

Contraintes

Exemple complet

​Structure

​Types de boutons

​Contraintes

​Exemple complet

Structure

Types de boutons

Contraintes

Exemple complet