Mit der REST-API von Papo (https://papo.global/) automatisieren Sie die Erstellung, Auflistung und Stornierung geplanter Nachrichten für WhatsApp und SMS und integrieren die Terminierung von Kommunikation direkt in Ihre Systeme, CRMs oder Automatisierungsabläufe – ohne manuell auf das Dashboard zugreifen zu müssen.
Die Papo-Plattform bietet bereits einen zentralen Bereich zur Verwaltung geplanter Nachrichten, aber wenn das Volumen der Terminierungen hoch ist oder wenn Sie möchten, dass eine andere Software die Sendungen auslöst, ist die API der richtige Weg. Mit ihr können Sie Erinnerungen, Follow-ups und Benachrichtigungen programmatisch erstellen und behalten dabei die gleiche Kontrolle wie in der visuellen Oberfläche.
Übersicht der Operationen für geplante Nachrichten über die API
| Operation | Was sie bewirkt | Wann sie verwendet wird |
|---|---|---|
| Terminierung erstellen | Plant eine WhatsApp- oder SMS-Nachricht für einen Kontakt zu einem bestimmten Datum und einer bestimmten Uhrzeit. | Erinnerungen an Termine, Vertriebs-Follow-ups oder Zahlungsbenachrichtigungen aus einem externen System planen. |
| Terminierungen auflisten | Gibt alle geplanten Nachrichten zurück, mit der Möglichkeit, nach Status zu filtern (ausstehend, gesendet, storniert, fehlgeschlagen). | Den Versandkalender mit einem Dashboard synchronisieren, ausstehende Elemente vor dem Erstellen neuer Terminierungen überprüfen oder geplante Kommunikationen prüfen. |
| Terminierung stornieren | Storniert einen geplanten Versand vor dem Auslösezeitpunkt. | Eine Nachricht unterbrechen, die nicht mehr relevant ist, wie eine Erinnerung an eine abgesagte Veranstaltung oder ein Follow-up, das seinen Sinn verloren hat. |
Wie die Integration funktioniert
Die Papo-API folgt dem REST-Standard und verwendet die Authentifizierung über einen Bearer-Token. Alle Schreiboperationen (Erstellung und Stornierung) erfordern den geheimen Schlüssel Ihres Kontos, der im Entwicklerbereich des Dashboards generiert wird. Die Basis-URL lautet https://app.papo.global/api/v1.
Um die Funktionen für geplante Nachrichten zu nutzen:
- Generieren Sie einen geheimen Schlüssel im Papo-Dashboard (Entwickler-/API-Bereich). Bewahren Sie ihn an einem sicheren Ort auf – er wird nur einmal angezeigt.
- Fügen Sie bei jeder Anfrage den Header
Authorization: Bearer {Ihr_geheimer_Schlüssel}hinzu. - Verwenden Sie die spezifischen Endpunkte für geplante Nachrichten gemäß der offiziellen Dokumentation unter https://papo.global/pt/docs. Dort finden Sie die genauen Pfade, die erforderlichen Parameter (wie Kontakt-ID, Kanal, Inhalt, Datum/Uhrzeit) und Beispiele für Payloads im JSON-Format.
- Zum Auflisten von Terminierungen können Sie Filter nach Status anwenden, sodass Sie nur ausstehende oder bereits abgeschlossene Sendungen abfragen können.
Die API spiegelt das Verhalten des Moduls Geplante Nachrichten der Plattform wider: Über die API erstellte Terminierungen erscheinen in der Dashboard-Liste, und jede über die API vorgenommene Stornierung aktualisiert den Status sofort.
Für wen sich diese Automatisierung eignet
- Entwickler und IT-Teams, die die Terminierung von Nachrichten in eigene Systeme wie ERPs, CRMs oder Terminplanungsplattformen integrieren müssen.
- White-Label-Wiederverkäufer, die ihren Kunden die Möglichkeit bieten möchten, Sendungen über die API zu planen, um den Wert der Lösung zu steigern.
- Betriebe mit hohem Follow-up-Volumen (Vertrieb, Inkasso, Anwesenheitsbestätigung), die die Erstellung von Erinnerungen ohne manuellen Eingriff automatisieren möchten.
- Unternehmen, die Automatisierungsabläufe nutzen und die Erstellung von Terminierungen durch Ereignisse in anderen Tools auslösen.
Häufig gestellte Fragen
Muss ich das Modul für geplante Nachrichten aktiviert haben, um die API zu nutzen?
Ja. Die API arbeitet mit derselben Funktionalität, die Sie im Dashboard finden. Wenn das Modul in Ihrem Plan verfügbar ist, sind auch die entsprechenden Endpunkte zugänglich.
Erlaubt die API das Planen von Nachrichten mit Anhängen oder Medien?
Die offizielle Dokumentation beschreibt die unterstützten Inhaltstypen. Derzeit ist die Terminierung über die Plattform auf Textnachrichten ausgerichtet. Konsultieren Sie die API-Referenz, um zu prüfen, ob zum Zeitpunkt Ihrer Integration Medien unterstützt werden.
Wie authentifiziere ich die Anfragen?
Verwenden Sie den geheimen Schlüssel Ihres Papo-Kontos als Bearer-Token im Header Authorization. Der Schlüssel wird im Entwicklerbereich des Dashboards generiert.
Kann ich Nachrichten für mehrere Kontakte gleichzeitig planen?
Die API ermöglicht die Erstellung einer Terminierung pro Anfrage. Für mehrere Kontakte können Sie sequenzielle Aufrufe durchführen. Prüfen Sie in der Dokumentation, ob Batch-Endpunkte für Ihren Anwendungsfall vorhanden sind.
Was passiert, wenn ich versuche, eine bereits gesendete Nachricht zu stornieren?
Die API gibt einen Fehler zurück, da nur Terminierungen mit dem Status „ausstehend“ storniert werden können. Nach dem Auslösen kann die Nachricht nicht mehr geändert werden.
Wo finde ich die API-Schlüssel?
Greifen Sie im Papo-Dashboard auf den Entwicklerbereich oder die API-Einstellungen zu. Der geheime Schlüssel wird zum Zeitpunkt der Erstellung angezeigt; wenn er verloren geht, muss ein neuer generiert werden.
Lesen Sie auch
- So verwalten Sie geplante Nachrichten in Papo: bearbeiten, stornieren und anzeigen
- So verwenden Sie die Papo-API zum Auflisten von Konversationen und Senden programmatischer Nachrichten
Beginnen Sie jetzt mit der Automatisierung Ihrer Terminierungen →
Mit Papo integrieren Sie WhatsApp, CRM und KI an einem Ort, ohne Anfangskosten.