WhatsApp-Nachricht per API senden: cURL, Node, Python, PHP

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-updates \
  -F destinationNo=971500000000 \
  -F messageType=TEMPLATE \
  -F templateName=order_update \
  -F templateLanguage=en_US \
  -F bodyTemplateVariables=INV-400

// Node.js 18+ (integriertes fetch und FormData)
const form = new FormData();
form.append("batchId", "0");
form.append("campaignName", "order-updates");
form.append("destinationNo", "971500000000");
form.append("messageType", "TEMPLATE");
form.append("templateName", "order_update");
form.append("templateLanguage", "en_US");
form.append("bodyTemplateVariables", "INV-400");

const res = await fetch("https://api.broadnet.me/whatsapp/message/sendbulk", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.BROADNET_TOKEN}` }, // fetch setzt die Multipart-Grenze
  body: form,
});
console.log(await res.json());

import os
import requests

fields = {
    "batchId": "0",
    "campaignName": "order-updates",
    "destinationNo": "971500000000",
    "messageType": "TEMPLATE",
    "templateName": "order_update",
    "templateLanguage": "en_US",
    "bodyTemplateVariables": "INV-400",
}
# Jedes Feld als Multipart-Teil senden (files=) statt URL-kodiert (data=).
r = requests.post(
    "https://api.broadnet.me/whatsapp/message/sendbulk",
    headers={"Authorization": f"Bearer {os.environ['BROADNET_TOKEN']}"},
    files={k: (None, v) for k, v in fields.items()},
    timeout=30,
)
print(r.json())

<?php
$ch = curl_init("https://api.broadnet.me/whatsapp/message/sendbulk");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("BROADNET_TOKEN")],
    // Ein Array (kein String) lässt cURL multipart/form-data senden.
    CURLOPT_POSTFIELDS => [
        "batchId" => "0",
        "campaignName" => "order-updates",
        "destinationNo" => "971500000000",
        "messageType" => "TEMPLATE",
        "templateName" => "order_update",
        "templateLanguage" => "en_US",
        "bodyTemplateVariables" => "INV-400",
    ],
]);
echo curl_exec($ch);
curl_close($ch);

{
  "totalFiles": 1,
  "totalSuccess": 1,
  "totalFailed": 0,
  "totalDuplicates": 0,
  "batchId": "2609091405000000001",
  "fileResults": [
    {
      "fileName": "direct",
      "totalRecords": 1,
      "successCount": 1,
      "failedRecipients": [],
      "duplicateRecipients": []
    }
  ],
  "message": "Messages queued for delivery"
}

Welche Anfragefelder sind am wichtigsten?

Welche Felder erforderlich sind, hängt von messageType ab. Dies sind die gängigen.

Die Planung nutzt scheduled, scheduleTime und gmt, und delay drosselt die Zustellung. Die vollständige Liste steht in der WhatsApp-API-Referenz.

Wie sende ich eine Vorlage mit Button oder OTP?

Fügen Sie den Button-Wert in buttonsTemplateVariable hinzu. Für eine Authentifizierungsvorlage mit Button zum Kopieren des Codes übergeben Sie den Code sowohl im Body- als auch im Button-Feld.

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F destinationNo=971500000000 \
  -F messageType=TEMPLATE \
  -F templateName=login_code \
  -F templateLanguage=en_US \
  -F bodyTemplateVariables=482913 \
  -F buttonsTemplateVariable=482913

Hier ist login_code ein Platzhalter für Ihre eigene freigegebene Authentifizierungsvorlage. Bei mehreren Buttons nimmt buttonsTemplateVariable ein JSON-Array entgegen. Erzeugen Sie den Code auf Ihrem Server, speichern Sie ihn gehasht mit Ablaufzeit und protokollieren Sie ihn nie. Unser OTP-Leitfaden behandelt One-Tap-, Zero-Tap- und Copy-Code-Zustellung.

Wie antworte ich innerhalb des Kundenservice-Fensters?

Verwenden Sie einen Session-Nachrichtentyp. Eine einfache Textantwort braucht messageType=TEXT und content.

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F destinationNo=971500000000 \
  -F messageType=TEXT \
  -F campaignName=support \
  -F "content=Your order has shipped. Reply here if you need anything."

Für Antwort-Buttons senden Sie messageType=INTERACTIVE und einen interactivePayload im Format von Metas Interactive-Nachrichten.

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F destinationNo=971500000000 \
  -F messageType=INTERACTIVE \
  -F campaignName=support \
  -F 'interactivePayload={"type":"button","body":{"text":"Confirm your delivery slot?"},"action":{"buttons":[{"type":"reply","reply":{"id":"slot_ok","title":"Confirm"}},{"type":"reply","reply":{"id":"slot_change","title":"Change"}}]}}'

Um eine eingehende Nachricht als gelesen zu markieren und optional eine Tipp-Anzeige zu zeigen, rufen Sie POST /whatsapp/message/read mit JSON auf:

curl -X POST https://api.broadnet.me/whatsapp/message/read \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "messageId": "wamid.HBgMOTcxNTAwMDAwMDAwFQIAEhgg", "typing": true }'

Hinweise zur Gestaltung finden Sie in unserem Leitfaden zu interaktiven Nachrichten.

Wie verfolge ich die Zustellung?

Status werden an den in Ihrem Account konfigurierten Webhook gesendet und lassen sich auch je Batch abrufen. Jeder Empfänger durchläuft SUBMITTED, SENT, DELIVERED und READ oder endet als FAILED bzw. REJECTED mit einem Grund.

curl "https://api.broadnet.me/whatsapp/message/bulk-insights?batch_Id=2609091405000000001&status=FAILED&page=0&size=50" \
  -H "Authorization: Bearer $BROADNET_TOKEN"

batch_Id ist erforderlich; status, destination, search, page und size sind optional, und page ist nullbasiert. Nutzen Sie Polling als Absicherung gegen verpasste Ereignisse und bauen Sie Ihren Empfänger wie in unserem Webhooks-Leitfaden beschrieben. Batches lassen sich außerdem mit den Batch-Endpunkten der Referenz pausieren, fortsetzen und abbrechen.

Welche Fehler muss ich behandeln?

Lesen Sie zuerst den HTTP-Status, dann den Fehler-Body. Die API meldet Fehler in einem JSON-Body mit fünf Feldern, und WhatsApp-spezifische Fehler können von Meta kommen.

Unser Leitfaden zu Fehlercodes erklärt gängige Meta-Codes. Da es keinen Idempotency-Key gibt, befolgen Sie die Schritte zum Schutz vor Duplikaten unter Fehler und Limits: zuerst einen ausstehenden Datensatz schreiben, die zurückgegebene batchId speichern und nach einem Timeout den Status prüfen, bevor Sie erneut senden.

Praxisbeispiel: ein Dienst für Bestellbenachrichtigungen

„Souq Rafiq“ (fiktiv), ein Händler in den VAE, sendet eine Vorlage order_update, wenn eine Bestellung versandt wird.

1. Der Bestelldienst schreibt eine Zeile mit dem Schlüssel order-8842-shipped und dem Status pending.
2. Er ruft sendbulk mit der Vorlage und der Bestellnummer als bodyTemplateVariables auf.
3. Bei 200 speichert er die batchId und markiert die Zeile als accepted.
4. Der Webhook-Handler setzt die Zeile auf DELIVERED oder READ bzw. auf FAILED mit einem Grund.
5. Antwortet der Kunde, nutzt das Support-Tool innerhalb des Fensters eine Session-Nachricht vom Typ TEXT.
6. Ein nächtlicher Job liest bulk-insights für die Batches des Vortags und gleicht fehlende Status ab.

Welche typischen Fehler gibt es?

• JSON senden. Der WhatsApp-Sendeendpunkt ist Multipart; Content-Type: application/json funktioniert nicht.
• Python data= statt files=, was das Formular URL-kodiert.
• Freitext außerhalb des Fensters, der fehlschlägt. Nutzen Sie eine Vorlage.
• Falscher Sprachcode, etwa en statt en_US der Vorlage.
• 200 als zugestellt werten. Es bedeutet: in der Warteschlange.
• Blinde Wiederholungen nach einem Timeout, die einen Kunden doppelt anschreiben können.
• Token im Client-Code. Rufen Sie die API nur aus Ihrem Backend auf.
• Grenzen: Die Payload-Details variieren je Vorlage. Bestätigen Sie das Variablenlayout für Ihre erste personalisierte Kampagne mit unserem Team.

So unterstützt OmniChannels.ai

BroadNet ist ein offizieller Meta Business Solution Provider, und das Onboarding für die WhatsApp Business API nutzt Meta Embedded Signup; unser Team bereitet die Registrierung gemeinsam mit Ihnen vor, die Freigaben bleiben bei Meta. Die REST-API ist mit einer OpenAPI-3.1-Spezifikation und einem TypeScript-SDK, @broadnet/cpaas-sdk, dokumentiert, und Zustellstatus werden kanalübergreifend normalisiert. Beginnen Sie mit der WhatsApp-API-Dokumentation oder dem Quickstart.