Unter Entwickler > Anmeldeinformationen erstellen Sie ein Token für die Integration messages:write. Kopieren Sie es bei der Erstellung, speichern Sie es in Ihrem Backend und konfigurieren Sie die WhatsApp-Verbindung im Dashboard, bevor Sie senden.
API-Entwickler
API zum Verbinden von WhatsApp mit Ihren Systemen und Anwendungen.
Integrieren Sie CRM, ERP, Apps und interne Systeme mit WhatsApp über die WPP Marketing REST-API. Senden Sie Text und Medien, rufen Sie Nachrichten ab und verfolgen Sie Zustellungen per Webhooks. Verwenden Sie außerdem MCP, um Ihre Flows mit der Official API zu integrieren. MCP kennenlernen.
Wann verwenden
Verwenden Sie die Messaging-API, wenn Ihr System WhatsApp-Nachrichten senden muss.
Verwenden Sie Ihr CRM, um einen Kontakt zu starten, Ihr ERP, um ein Update zu senden, oder Ihre App, um einen Kunden zu benachrichtigen. Die Logik, wann gesendet wird, bleibt in Ihrem System; die API übernimmt das Senden über die in Ihrem Konto konfigurierte Verbindung. Für fertige kommerzielle Automatisierungen verwenden Sie die Events API.
Verwenden Sie POST /send-text für Text oder POST /send-media für Medien. Bei der offiziellen Verbindung verwenden Text und Bild die konfigurierten Vorlagen; Audio, Video und Dokumente erfordern eine vom Kunden innerhalb der letzten 24 Stunden empfangene Nachricht.
HTTP 200 bedeutet Annahme, nicht Zustellung. Mit messages:read rufen Sie GET /messages auf und prüfen die verfügbaren Status für den Kanal.
Registrieren Sie die HTTPS-URL und aktivieren Sie Ereignisse im Dashboard. Verwenden Sie webhooks:read, um Versuche mit GET /webhooks abzufragen; dieser Endpunkt listet Zustellungen auf, er registriert keine Abonnements.
Vom Token bis zum ersten inbegriffenen Versand.
Auf Ihrem Server ersetzen Sie SEU_TOKEN durch die Zugangsdaten und die Nummer durch den für den Test autorisierten Empfänger. Verwenden Sie für jede Sendung einen eindeutigen Schlüssel und verwenden Sie denselben Schlüssel nur, wenn Sie dieselbe Anfrage erneut senden.
Prüfen Sie den HTTP-Status und den Antwortkörper. Bei 401 prüfen Sie das Token und seine Gültigkeit; bei 403 überprüfen Sie die Scopes und Kontobedingungen. Bei 409 prüfen Sie, ob der Schlüssel bereits mit anderem Inhalt verwendet wurde. Bei 429 beachten Sie Retry-After, bevor Sie einen neuen Versuch starten.
Prüfen Sie anschließend GET /messages mit messages:read oder überwachen Sie die konfigurierten Webhooks. Die Lieferbestätigung hängt von der Antwort des Kanals ab.
cURLPOST /send-text
curl --request POST 'https://api.wppmarketing.com/send-text' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: pedido-10231-aviso-1' \
--data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'Text, Medien, Verlauf und Nachverfolgung von Sendungen.
Verwenden Sie die REST-Endpunkte, um WhatsApp in Ihre Anwendung zu integrieren. Die WPP Marketing API verwendet die im Konto konfigurierte Verbindung; um mit der offiziellen WhatsApp-API zu arbeiten, konfigurieren Sie diese Verbindung im Dashboard. Siehe OpenAPI für die Formate, Scopes, Limits und Antworten jeder Operation.
POST
/send-text
Sendet eine Textnachricht an eine WhatsApp-Nummer.
Texto
POST
/send-media
Sende Bild, Audio, Video oder Dokument über eine öffentliche HTTPS-URL, entsprechend dem Format und den Verbindungsbedingungen. Audio verwendet denselben Endpoint.
Mídia
GET
/messages
Prüfen Sie die Historie gesendeter Nachrichten mit Status und Paginierung.
Histórico
GET
/webhooks
Prüfen Sie Webhook-Zustellungen mit Ereignis, HTTP-Ergebnis, Versuchen und Paginierung.
Webhooks
DOC
Swagger / OpenAPI
Interaktive Dokumentation mit Verträgen, Beispielen, Pflichtfeldern und erwarteten Antworten.
Docs
Technische Trennung
Wählen Sie die richtige Funktion für jede Phase der Integration.
Senden Sie Nachrichten mit der Messaging API, lösen Sie Geschäftsautomatisierungen mit der Events API aus und empfangen Sie Rückmeldungen über Webhooks. Ihre Anwendung kann diese Funktionen je nach benötigtem Ablauf kombinieren.
Die offizielle Verbindung ist der Kommunikationskanal; die WPP Marketing API ist die Schnittstelle, die Ihr System verwendet. Prüfen Sie die Anforderungen unter Offizielle WhatsApp-API und Koexistenz.
Ihr System ruft WPP Marketing auf, um Text- oder Mediendaten zu senden und Nachrichtenverläufe sowie Webhook-Zustellungen abzufragen.
Ihr System sendet kommerzielle Ereignisse wie Bestellung erstellt, Zahlung genehmigt, Versand oder abgebrochener Warenkorb.
Verstehen Sie die verfügbaren Ereignisse und AutomatisierungenWPP Marketing sendet standardisierte Ereignisse für Erstellung, Zustellung, Lesen und Fehler an eine von Ihnen bereitgestellte URL.
Sehen Sie Rückgabeereignisse und SendungsverfolgungVerwenden Sie die interaktive Dokumentation, um Payloads, Authentifizierung und Antworten zu überprüfen, bevor Sie in Produktion gehen.
Tokens müssen im Backend bleiben. Legen Sie keine Zugangsdaten auf öffentlichen Seiten, Frontend-Apps oder in Repositories offen.
Bei /send-text und /send-media ermöglicht Idempotency-Key, dieselbe Anfrage bis zu 48 Stunden mit erfolgreicher Antwort zu wiederholen. Wird der Schlüssel mit anderem Inhalt erneut verwendet, wird 409 zurückgegeben. Ohne Schlüssel kann ein erneuter Aufruf die Sendung duplizieren. Beachten Sie die Header RateLimit und Retry-After; die Anfragegrenzen unterscheiden sich vom Plan-Kontingent.
Eine Anmeldeinformation pro Integration, mit den erforderlichen Berechtigungen.
Benennen Sie den Token im Dashboard, wählen Sie die Bereiche (Scopes) aus und legen Sie optional eine Ablaufzeit fest. Der vollständige Token wird bei der Erstellung nur einmal angezeigt. Die Liste ermöglicht es, die letzte Verwendung, das Ablaufdatum zu prüfen und bei Bedarf den Zugang zu widerrufen.
Wenn Sie eine Anmeldeinformation austauschen, aktualisieren Sie das Geheimnis auf Ihrem Server und widerrufen Sie die vorherige. Verwenden Sie niemals das Token des WhatsApp-Anbieters anstelle der API-Anmeldeinformation.
Ermöglicht das Senden von Text und Medien. Gewähren Sie dies nur Integrationen, die Sendungen initiieren müssen.
Sie erlauben jeweils die Abfrage des Nachrichtenverlaufs bzw. der Webhook-Zustellungen. Eine Sende-Anmeldeinformation erhält diese Berechtigungen nicht automatisch.
Ermöglicht das Übermitteln von Kunden, Warenkörben und Bestellungen über die Events API an die im Konto konfigurierten Automatisierungen.
Prüft gespeicherte Einstellungen, Automatisierungen, Zählungen und kürzliche Protokolle zur Diagnose. Kann personenbezogene Daten und Nachrichteninhalte enthalten: Zugriff nur für autorisierte Integrationen und Support gewähren. Diese Abfrage überprüft nicht live die Verbindung zum Anbieter.
MCP und offizielle WhatsApp-API.
Verbinden Sie KI‑Tools mit Ihrem WhatsApp‑Betrieb über das MCP von WPP Marketing. Integrieren Sie WhatsApp in die Workflows Ihrer Assistenten und Agenten, wobei die Offizielle API als Nachrichtenverbindung dient.
MCP verbindet die Abläufe Ihrer Agenten mit der Integration; die Messaging-API führt die Sendungen aus und die offizielle Verbindung folgt den Regeln von WhatsApp. Das macht MCP nicht zu einem nativen Chatbot und ersetzt nicht die Kontoeinrichtung. Das Team weist auf die Maßnahmen und Integrationsanforderungen für Ihren Anwendungsfall hin.
Verwenden Sie MCP als Integrationsweg zwischen KI-Tools und WhatsApp und ergänzen Sie damit die Abläufe Ihrer Systeme und Ihres Teams.
Sprechen Sie mit unserem Team über das KI-Tool, das Sie verwenden, und die Aktionen, die Sie mit WhatsApp verbinden möchten. Prüfen Sie die Anforderungen und den geeigneten Umfang für Ihren Betrieb.
Über die MCP-Integration sprechenBereit, Ihr System mit WPP Marketing zu integrieren?
Öffnen Sie das Swagger, um die Endpunkte der Messaging API, Payload-Beispiele, die Authentifizierung per Bearer-Token und erwartete Antworten einzusehen. Informationen zu Shop-Ereignissen und Lieferfeedback finden Sie ebenfalls Events API und Webhooks de status.