REST-API · Nachrichten

POST https://api.pulpo.chat/v1/messages
Token: TU_CLAVE_DE_API
Content-Type: application/json

{
  "phone": "+14155550187",
  "message": "Ihre Bestellung liegt im Geschäft zur Abholung bereit."
}

Nachricht erstellt · 201

HTTP/1.1 201 Created
{"id":"ID_MENSAJE_DE_EJEMPLO"}

Die WhatsApp-API für Ihr System

Ihr System benachrichtigt.Ihr Team behält den Gesprächsverlauf.

Wenn eine Bestellung bereit ist, kann Ihr System die Nachricht erstellen. Ihr Team setzt das Gespräch in Pulpo fort.

Kostenlos starten In Aktion sehen

Fiktive Daten. Verwenden Sie ein autorisiertes Konto, eine aktive Nummer und die jeweils geltenden Versandbedingungen.

Anfrage, Ereignis und Vorlage.

Beispiele dokumentierter Vorgänge. Prüfen Sie das vollständige Schema und testen Sie mit Ihrem Konto, bevor Sie die Integration umsetzen.

Die Bestellung ist bereit

Nachricht erstellen

Mitteilen, dass die Bestellung abgeholt werden kann.

Ihr Server verwendet den Token-Header und den Anfragekörper. Empfänger und Text dieses Beispiels sind fiktiv.

PulpoChatREST-API · Nachrichten

Beispielanfrage

POST https://api.pulpo.chat/v1/messages
Token: TU_CLAVE_DE_API
Content-Type: application/json

{
  "phone": "+14155550187",
  "message": "Ihre Bestellung liegt im Geschäft zur Abholung bereit."
}

Nachricht erstellt · 201

HTTP/1.1 201 Created
{"id":"ID_MENSAJE_DE_EJEMPLO"}

201 bestätigt die Erstellung der Nachricht. Prüfen Sie ihren weiteren Status, bevor Sie davon ausgehen, dass sie beim Empfänger angekommen ist.

Prüfen Sie den Zugriff auf die Nummer, die Zustimmung des Empfängers und die Versandregeln. Wenn Sie mehrere Nummern haben, lesen Sie die Dokumentation zum Feld device.

Ein neues Gespräch geht ein

Ereignis empfangen

Ihr System über eine eingehende Nachricht informieren.

Sie richten Ihre Webhook-URL und die benötigten Ereignisse ein. Dieser Ausschnitt zeigt Felder eines Ereignisses, nicht dessen vollständiges Schema.

PulpoChatWebhook · eingehende Nachricht

POST an Ihren Server · Beispiel

POST https://tu-servidor.example/webhooks/pulpo
Content-Type: application/json
X-Idempotency-Key: ID_EVENTO_DE_EJEMPLO

{
  "id": "ID_MENSAJE_DE_EJEMPLO",
  "object": "message",
  "event": "message:in:new"
}

Antwort Ihres Servers · Beispiel

HTTP/1.1 200 OK

Ihr Server verarbeitet das Ereignis und entscheidet, was damit geschieht. Richten Sie die Behandlung von Wiederholungsversuchen ein, damit dasselbe Ereignis nicht mehrfach verarbeitet wird.

Nutzen Sie HTTPS im Produktivbetrieb und validieren Sie das vollständige Schema. Der Empfang eines Webhooks sendet nicht von selbst eine WhatsApp-Antwort.

Sie bereiten eine proaktive Benachrichtigung vor

Vorlagen abrufen

Eine genehmigte Vorlage für die Benachrichtigung finden.

Rufen Sie die Vorlagen des Kontos ab und prüfen Sie Namen, Sprache und Inhalt, bevor Sie den Versand vorbereiten.

PulpoChatREST-API · Vorlagen

Beispielabfrage

GET https://api.pulpo.chat/v1/waba/templates?status=approved
Token: TU_CLAVE_DE_API

Antwortausschnitt · Beispiel

{"data":[{"name":"PLANTILLA_DE_EJEMPLO",
"status":"approved","language":"es"}],
"total":1,"page":0,"size":1}

Die Abfrage gibt die Vorlagen zurück, die Sie prüfen können. Beachten Sie zum Senden das Format und die Voraussetzungen der Dokumentation.

Genehmigte Vorlagen sind erforderlich, wenn die WhatsApp-Regeln dies verlangen. Diese Abfrage erstellt oder sendet keine Nachricht.

Vom Beispiel zur Integration.

Testen Sie die Anfrage, richten Sie den Ereignisempfänger ein oder prüfen Sie das Vorlagenschema.

Nachricht aus Ihrem System erstellen

Prüfen Sie das Nachrichtenschema und testen Sie die Anfrage mit einem vorbereiteten Konto im API-Testtool.

Öffnen Sie den API-Tester

WhatsApp-Ereignisse empfangen

Richten Sie Ihren HTTPS-Empfänger ein, wählen Sie die Ereignisse aus und behandeln Sie Wiederholungsversuche, bevor Sie ihn produktiv einsetzen.

Webhook-Anleitung lesen

Vorlagen des Kontos prüfen

Prüfen Sie genehmigte Vorlagen und Versandformate mit ihrer Sprache und ihren Variablen.

API-Dokumentation öffnen

Möchten Sie lieber einen visuellen Workflow erstellen?

Flows verbindet Schritte und Verbindungen, die Sie einrichten und testen müssen. Über den MCP-Server können Sie Aufgaben aus einem autorisierten Client wie ChatGPT oder Claude anfordern.

Siehe Flows Siehe den MCP-Server

Ein Schlüssel. Eine Nummer. Ein Test.

Bewahren Sie die Zugangsdaten auf Ihrem Server auf und prüfen Sie den Vorgang, bevor Sie ihn im Arbeitsalltag einsetzen.

Erstellen und schützen Sie Ihren Schlüssel
Verwenden Sie einen für Ihr Konto autorisierten Schlüssel. Speichern Sie ihn auf dem Server und prüfen Sie seine Zugriffsrechte, bevor Sie eine Integration teilen.
Prüfen Sie die Nummer
Prüfen Sie, ob die Nummer aktiv ist und Ihr Konto den nötigen Zugriff und die Kapazität für den Vorgang hat.
Testen Sie Anfrage und Ereignisse
Prüfen Sie das Schema, stellen Sie eine Testanfrage und validieren Sie die Antwort. Wenn Sie Webhooks nutzen, richten Sie den Empfänger und die Behandlung von Wiederholungsversuchen ein.

Bevor Sie starten

Ein autorisiertes Konto und eine aktive Nummer.
Geschützte Zugangsdaten auf Ihrem Server; die Beispiele enthalten keinen echten Schlüssel.
Die Einwilligung des Empfängers und genehmigte Vorlagen, wenn der Versand dies erfordert.
Ein HTTPS-Empfänger und die Behandlung von Wiederholungsversuchen, wenn Sie Webhooks nutzen.

Kostenlos starten Tarife und Bedingungen ansehen

Bevor Sie Ihr System verbinden.

Bedeutet 201, dass die Nachricht angekommen ist?

201 bestätigt, dass die Nachricht erstellt wurde. Prüfen Sie ihren Status und die verfügbaren Ereignisse, um den weiteren Verlauf zu verfolgen; verwenden Sie dies nicht als Zustell- oder Lesebestätigung.

Kann ich meinen Schlüssel in die Webseite einbauen?

Bewahren Sie den Schlüssel auf Ihrem Server auf. Geben Sie ihn nicht im Browser, in öffentlichen Repositories oder in geteilten Beispielen preis.

Wann benötige ich eine genehmigte Vorlage?

Wenn die WhatsApp-Regeln dies verlangen, etwa bei proaktiven Nachrichten außerhalb des Kundenservice-Zeitfensters. Prüfen Sie die Voraussetzungen und das Versandformat in der Dokumentation.

Bereiten Sie die Benachrichtigung vor, die Ihr System benötigt.

Kostenlos starten

Erstellen Sie Ihr Konto, prüfen Sie den Zugriff und lesen Sie die Dokumentation, um den Vorgang zu testen.