50 % Rabatt mit dem Code BLACKFRIDAY5020 % Rabatt mit dem Code BLACKFRIDAY20
Integrationen und APIAb Growth / Pro

API: WhatsApp-Vorlagen auflisten und senden

Zwei Endpunkte lassen Ihre Software Ihre WhatsApp-Vorlagen nutzen. GET /api/v1/whatsapp/templates listet Ihre freigegebenen Vorlagen, und POST /api/v1/whatsapp/send-template sendet eine von Ihrer Standardnummer an einen Gast. Beide brauchen einen Schlüssel mit WhatsApp-Zugriff.

Wo
Ask Menuthere support for a key
Tarif
Braucht eine verbundene WhatsApp-Business-Nummer, die ab Starter / Pro verfügbar ist.
Aktualisiert

Ihre Vorlagen auflisten

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

Es gibt die freigegebenen Vorlagen Ihrer Standardnummer zurück, sodass Sie den genauen Namen kennen und wissen, wie viele Werte jede braucht.

FeldBedeutung
name, languageName und Sprachcode der Vorlage.
category, statusKategorie wie MARKETING oder UTILITY. Der Status ist APPROVED.
body_variablesWie viele {{n}}-Werte der Text braucht.
has_header, header_formatOb es einen Kopf gibt, und TEXT, IMAGE, VIDEO oder DOCUMENT.

Eine Vorlage senden

POST /api/v1/whatsapp/send-template mit einem JSON-Body. Die Nachricht geht von Ihrem Standardabsender raus, den Sie unter Mehrere Nummern und die Hauptnummer festlegen. Die Nummer können Sie im Aufruf nicht wählen.

FeldPflichtWas es ist
toJaDie Nummer des Gastes mit Ländervorwahl.
template_nameJaDer Name aus dem Listenaufruf.
languageNeinWird aus der freigegebenen Vorlage nachgeschlagen, wenn Sie es weglassen.
body_paramsNeinArray mit Werten für {{1}}, {{2}} usw. in dieser Reihenfolge.
header_paramsNeinArray mit Werten für einen Textkopf.
header_media_url, header_media_typeNeinEin Link und image, video oder document für einen Medienkopf.
button_paramsNeinArray mit Werten für eine Schaltfläche mit dynamischer URL.
idempotency_keyNeinEine Referenz Ihrer Wahl. id und ein Header Idempotency-Key funktionieren ebenfalls.

Ein erfolgreicher Versand gibt ok: true, die message_id, die Nummer to und status: "sent" zurück. Senden Sie denselben Idempotenzschlüssel erneut, erhalten Sie das erste Ergebnis mit duplicate: true zurück, und nichts wird doppelt gesendet. Ein fehlgeschlagener Versand gibt den Schlüssel frei, sodass Sie es erneut versuchen können.

Fehler und Grenzen

Status`error`Bedeutung
400missing_fields, invalid_json, invalid_number, template_errorEin Pflichtfeld fehlt, die Nummer sieht falsch aus, oder die Vorlage passt nicht zu den gesendeten Werten.
404template_not_foundKeine freigegebene Vorlage mit diesem Namen auf Ihrer Standardnummer.
409recipient_opted_outDer Gast hat mit STOP geantwortet. Es wird keine Nachricht gesendet.
409in_progressEine Anfrage mit demselben Idempotenzschlüssel läuft noch.
412no_whatsapp_numberEs ist keine Standard-WhatsApp-Nummer verbunden.
429daily_limit_reached, rate_limitedDas tägliche WhatsApp-Limit Ihrer Nummer ist aufgebraucht, oder der Schlüssel liegt über seinem Limit.
502send_failedWhatsApp war nicht erreichbar. Versuchen Sie es erneut.
Gut zu wissenJeder API-Versand ist eine normale WhatsApp-Nachricht, Meta berechnet sie also wie jede andere. Siehe Was WhatsApp-Nachrichten kosten. Eine Vorlage muss freigegeben sein, bevor sie gesendet werden kann. Siehe Nachrichtenvorlagen.

Fragen

Kann ich über die API eine normale Textnachricht senden?
Nein. Die API sendet nur freigegebene Vorlagen, die auch Gäste außerhalb des 24-Stunden-Fensters erreichen.
Schreibt sie jemandem, der sich abgemeldet hat?
Nein. Ein Gast, der mit STOP geantwortet hat, wird übersprungen, und der Aufruf gibt recipient_opted_out zurück.

Nicht gefunden? Schreiben Sie an help@mail.menuthere.com oder chatten Sie mit uns, 9 bis 21 Uhr.Hilfe-CenterPreisemenuthere.com