Mit Papo (https://papo.global/) können Sie die REST-API verwenden, um genehmigte Nachrichtenvorlagen (HSM) über WhatsApp zu senden und so Transaktionsbenachrichtigungen und Kampagnen zu automatisieren, ohne auf die Benutzeroberfläche zugreifen zu müssen. Die API ermöglicht es Ihnen, die Cloud-API-Posteingänge Ihres Kontos aufzulisten, die von Meta genehmigten Vorlagen abzurufen und sie an einen oder mehrere Kontakte zu senden, sofern Sie über ein API-Token verfügen und die Vorlagen in der Plattform synchronisiert sind.
| API-Aktion | Was sie bewirkt | Anwendungsbeispiel |
|---|---|---|
| WhatsApp-Posteingänge auflisten | Gibt die mit dem Konto verknüpften WhatsApp Cloud API-Posteingänge zurück | Den richtigen Posteingang vor dem Versand auswählen |
| Genehmigte Vorlagen auflisten | Gibt die Nachrichtenvorlagen (HSM) mit dem Status „genehmigt“ für einen bestimmten Posteingang zurück | Die verfügbaren HSMs für den Versand prüfen |
| HSM an einen Kontakt senden | Sendet eine genehmigte Vorlage an eine einzelne Telefonnummer und füllt die Variablen aus | Auftragsbestätigung, Terminerinnerung |
| HSM an mehrere Kontakte senden | Sendet dieselbe Vorlage gleichzeitig an eine Liste von Kontakten | Marketingkampagne, Massenmitteilung |
Wie der HSM-Versand über die API funktioniert
Die Papo-API spiegelt die Funktionen der Plattform wider. Um eine WhatsApp-Nachrichtenvorlage zu senden, müssen Sie nichts Neues per Code erstellen: Die Vorlagen werden direkt im Meta Business Manager erstellt und eingereicht und erscheinen nach der Genehmigung automatisch in Ihrem Papo-Konto. Die API fragt lediglich die Liste der genehmigten Vorlagen ab und führt den Versand durch.
Der typische Integrationsablauf besteht aus:
- Generieren Sie ein API-Token im Papo-Dashboard.
- Identifizieren Sie den WhatsApp Cloud API-Posteingang, in dem die Vorlage synchronisiert wurde.
- Rufen Sie die Liste der genehmigten Vorlagen (HSM) dieses Posteingangs ab.
- Bereiten Sie die Anfrage mit den erforderlichen Parametern vor: Vorlagen-ID, Sprache, Empfängernummer mit Ländervorwahl und die Werte der Variablen (falls die Vorlage
{{1}},{{2}}usw. enthält). - Senden Sie die Anfrage – entweder an einen einzelnen Kontakt oder an eine Gruppe von Nummern, jede mit ihren eigenen benutzerdefinierten Variablen.
Schritt-für-Schritt-Anleitung zur Verwendung der API
1. Generieren Sie ein API-Token
Greifen Sie im Einstellungsmenü Ihres Papo-Kontos auf den Bereich API oder Zugriffstoken zu. Erstellen Sie ein Token mit den erforderlichen Berechtigungen zur Verwaltung von Konversationen und Nachrichten. Bewahren Sie das Token an einem sicheren Ort auf; es wird im Header aller Anfragen gesendet.
2. Listen Sie die verfügbaren WhatsApp-Posteingänge auf
Bevor Sie eine Vorlage senden, müssen Sie wissen, welcher Posteingang (Inbox) die genehmigten Vorlagen enthält. Verwenden Sie den Endpunkt, der die WhatsApp Cloud API-Posteingänge Ihres Kontos zurückgibt. Notieren Sie die Kennung des Posteingangs, den Sie verwenden möchten – sie ist in den folgenden Schritten erforderlich.
3. Rufen Sie die genehmigten Vorlagen (HSM) ab
Rufen Sie mit der Posteingangs-ID den Endpunkt auf, der die Vorlagen mit dem Status APPROVED auflistet. Die Antwort enthält für jede Vorlage den Namen, die verfügbare Sprache, die Kategorie (Marketing, Utility oder Authentifizierung) und die erwarteten Parameter. Dieser Schritt ist wichtig, um zu bestätigen, dass die Vorlage freigegeben ist, und um zu wissen, welche Variablen ausgefüllt werden müssen.
4. Erstellen Sie die Sendeanfrage
Der Vorgang zum Senden an einen einzelnen Kontakt erfordert im Wesentlichen:
- Die Vorlagen-ID (oder den Namen, je nach Implementierung).
- Die Sprache der Vorlage (z. B.
pt_BR). - Die Telefonnummer des Kontakts, einschließlich Ländervorwahl (z. B.
5511999999999). - Ein Objekt mit den Werten der Variablen, falls die Vorlage Platzhalter enthält.
Für den Massenversand (mehrere Kontakte) akzeptiert der Aufruf eine Liste von Empfängern, jeder mit seiner Nummer und optional seinen eigenen Variablen. Die Vorlage ist für alle dieselbe.
5. Senden Sie und überprüfen Sie die Antwort
Die API gibt eine synchrone Bestätigung zurück, dass die Sendeanfrage akzeptiert wurde. Um den tatsächlichen Lieferstatus (zugestellt, gelesen, fehlgeschlagen) zu verfolgen, können Sie einen Outbound-Webhook konfigurieren – Papo benachrichtigt in Echtzeit über die Konversationsereignisse. Der Artikel zum Empfang von Echtzeitereignissen (aufgeführt unter „Siehe auch“) erklärt, wie Sie diese Funktion aktivieren.
Wer sollte die API für den HSM-Versand verwenden
Jedes Unternehmen, das Transaktionskommunikation aus externen Systemen automatisieren möchte, profitiert von der API. Anstatt für jede Benachrichtigung auf die Papo-Oberfläche angewiesen zu sein, können Sie den Versand direkt in Ihr ERP, CRM oder Ihre E-Commerce-Plattform integrieren. Häufige Beispiele:
- Kaufbestätigung oder Aktualisierung des Bestellstatus.
- Termin- oder Buchungserinnerung, die 24 Stunden vorher gesendet wird.
- Mahnung für eine überfällige Rechnung mit dem Zahlungslink.
- Mitteilung über Flug- oder Reservierungsänderungen.
Die API ist besonders nützlich, wenn die Regel, die bestimmt, wann die Vorlage gesendet werden soll, in einer anderen Software lebt – zum Beispiel ein Logistiksystem, das die Lieferbenachrichtigung auslöst, sobald das Paket zum Transport freigegeben wird.
Häufig gestellte Fragen
Hat die Papo-API zusätzliche Kosten?
Die API ist in den Papo-Tarifen verfügbar. Sie können Token generieren und die Endpunkte gemäß Ihrem gebuchten Tarif nutzen. Details zu Limits und Gebühren pro Anfrage finden Sie auf der Tarifseite und in der API-Dokumentation.
Muss ich die Nachrichtenvorlagen über die API erstellen?
Nein. Die Vorlagen müssen im Meta Business Manager erstellt und zur Genehmigung eingereicht werden. Sobald sie genehmigt sind, werden sie automatisch in Papo synchronisiert und erscheinen in der Vorlagenliste der API.
Kann ich HSM an Nummern senden, die nicht im Papo-CRM sind?
Ja. Der Empfänger muss nicht vorher im CRM der Plattform registriert sein. Es genügt, die WhatsApp-Nummer (mit Ländervorwahl und Vorwahl) in der Anfrage anzugeben. Sie müssen jedoch die Zustimmung (Opt-in) des Kunden für den Empfang der Kommunikation haben, insbesondere wenn die Vorlage zur Kategorie Marketing gehört.
Woher weiß ich, ob die Nachricht zugestellt wurde?
Die sofortige Antwort der API bestätigt, dass die Anfrage akzeptiert und an WhatsApp gesendet wurde. Um Fehler, Zustellungen und Lesebestätigungen in Echtzeit zu überwachen, müssen Sie den Papo-Event-Webhook (Outbound) aktivieren. Weitere Informationen finden Sie im Webhook-Leitfaden im Help Center.
Gibt es eine Geschwindigkeitsbegrenzung für den Versand über die API?
Ja. Papo wendet Ratenbegrenzungen an, um die Stabilität des Dienstes zu schützen und die WhatsApp-Richtlinien einzuhalten. Es wird empfohlen, moderate Geschwindigkeiten beizubehalten – plötzliche Spitzen zu vermeiden hilft, die Gesundheit der Nummer zu erhalten. Die genauen Werte finden Sie in der API-Dokumentation.
Kann ich die API für Massen-Marketingkampagnen verwenden?
Ja, sofern Sie ausschließlich genehmigte Vorlagen der Kategorie Marketing verwenden und eine ausdrückliche Opt-in-Erklärung der Empfänger haben. Das Senden unerwünschter Nachrichten kann zu Beschwerden führen und Ihre Nummer einem Sperrrisiko aussetzen. Planen Sie die Sendungen mit Kontrolle der Frequenz und beachten Sie stets die WhatsApp-Richtlinien.
Siehe auch
- Wie man Echtzeitereignisse von Papo über Webhook (Outbound) empfängt
- Wie man die Papo-API verwendet, um Kontakte in Massen zu erstellen und zu aktualisieren
Beginnen Sie jetzt mit der Automatisierung Ihrer HSM-Versendungen – kostenlos testen →
Erstellen Sie Ihr Papo-Konto und senden Sie genehmigte Nachrichtenvorlagen ohne Kosten für den ersten Benutzer.