-50 % avec le code BLACKFRIDAY50-20 % avec le code BLACKFRIDAY20
Intégrations et APIGrowth / Pro et plus

API : lister et envoyer des modèles WhatsApp

Deux points d'accès permettent à votre logiciel d'utiliser vos modèles WhatsApp. GET /api/v1/whatsapp/templates liste vos modèles approuvés, et POST /api/v1/whatsapp/send-template en envoie un à un client depuis votre numéro par défaut. Les deux nécessitent une clé avec l'accès WhatsApp.

Où
Ask Menuthere support for a key
Formule
Nécessite un numéro WhatsApp Business connecté, disponible à partir de Starter / Pro.
Mis à jour

Lister vos modèles

curl 'https://menuthere.com/api/v1/whatsapp/templates' -H 'Authorization: Bearer ck_live_YOUR_KEY'

Il renvoie les modèles approuvés de votre numéro par défaut : vous connaissez ainsi le nom exact et le nombre de valeurs dont chacun a besoin.

ChampSignification
name, languageLe nom du modèle et son code de langue.
category, statusUne catégorie comme MARKETING ou UTILITY. Le statut est APPROVED.
body_variablesCombien de valeurs {{n}} le corps nécessite.
has_header, header_formatS'il y a un en-tête, et TEXT, IMAGE, VIDEO ou DOCUMENT.

Envoyer un modèle

POST /api/v1/whatsapp/send-template avec un corps JSON. Le message part de votre expéditeur par défaut, défini dans Plusieurs numéros et le numéro principal. Vous ne pouvez pas choisir le numéro dans l'appel.

ChampObligatoireDe quoi il s'agit
toOuiLe numéro du client avec l'indicatif du pays.
template_nameOuiLe nom issu de l'appel de liste.
languageNonRetrouvée à partir du modèle approuvé si vous l'omettez.
body_paramsNonTableau de valeurs pour {{1}}, {{2}} et ainsi de suite, dans l'ordre.
header_paramsNonTableau de valeurs pour un en-tête texte.
header_media_url, header_media_typeNonUn lien et image, video ou document pour un en-tête média.
button_paramsNonTableau de valeurs pour un bouton URL dynamique.
idempotency_keyNonUne référence de votre choix. id et un en-tête Idempotency-Key fonctionnent aussi.

Un envoi réussi renvoie ok: true, le message_id, le numéro to et status: "sent". Si vous renvoyez la même clé d'idempotence, vous récupérez le premier résultat avec duplicate: true et rien n'est envoyé deux fois. Un envoi échoué libère la clé pour que vous puissiez réessayer.

Erreurs et limites

Statut`error`Signification
400missing_fields, invalid_json, invalid_number, template_errorUn champ obligatoire manque, le numéro semble erroné, ou le modèle ne convient pas aux valeurs envoyées.
404template_not_foundAucun modèle approuvé de ce nom sur votre numéro par défaut.
409recipient_opted_outLe client a répondu STOP. Aucun message n'est envoyé.
409in_progressUne requête avec la même clé d'idempotence est encore en cours.
412no_whatsapp_numberAucun numéro WhatsApp par défaut n'est connecté.
429daily_limit_reached, rate_limitedLa limite quotidienne WhatsApp de votre numéro est épuisée, ou la clé dépasse sa limite de débit.
502send_failedWhatsApp n'a pas pu être joint. Réessayez.
Bon à savoirChaque envoi par l'API est un message WhatsApp normal : Meta le facture donc comme les autres. Voir Ce que coûtent les messages WhatsApp. Un modèle doit être approuvé avant de pouvoir être envoyé. Voir Modèles de message.

Questions

Puis-je envoyer un message texte normal par l'API ?
Non. L'API n'envoie que des modèles approuvés, qui atteignent aussi les clients en dehors de la fenêtre de 24 heures.
Écrira-t-elle à quelqu'un qui s'est désabonné ?
Non. Un client qui a répondu STOP est ignoré et l'appel renvoie recipient_opted_out.

Vous ne trouvez pas ? Écrivez à help@mail.menuthere.com ou discutez avec nous, de 9 h à 21 h.Centre d'aideTarifsmenuthere.com