Um Follow-up-Sequenzen über die API bei Papo zu verwalten, können Sie die verfügbaren Kadencen auflisten, Kontakte einschreiben und die Teilnahme eines Leads pausieren, indem Sie benutzerdefinierte Attribute aktualisieren – alles über authentifizierte Anfragen, ohne das Panel zu öffnen. So integrieren Sie Lead-Nurturing in CRMs, ERPs und externe Automatisierungs-Workflows.
Zusammenfassung der API-Operationen
| Operation | Beschreibung | Wie die API es umsetzt |
|---|---|---|
| Sequenzen auflisten | Alle Follow-up-Kadencen des Kontos abrufen, mit Name, Kennung und Status (aktiv/inaktiv). | Authentifizierte GET-Anfrage am flows-Endpunkt, gefiltert nach dem Typ "sequence". |
| Kontakt einschreiben | Einen vorhandenen Kontakt in eine aktive Sequenz einfügen und die Nachrichtenreise starten. | POST mit der Kontakt-ID und der Sequenz-ID am Einschreibungs-Endpunkt. |
| Kadenz für einen Kontakt pausieren | Den Versand an einen Lead vorübergehend unterbrechen, ohne ihn aus der Sequenz zu entfernen. | Aktualisierung des benutzerdefinierten Kontaktattributs (z. B. status_pausa) über die Kontakte-API, kombiniert mit einer Bedingung im Flow. |
Wie Authentifizierung und Endpunkte funktionieren
Alle Operationen verwenden die Papo REST-API, authentifiziert mit dem geheimen Schlüssel des Kontos (Bearer-Token). Die Basis-URL ist https://app.papo.global/api/v1. Die Schlüssel werden im Panel im Entwicklerbereich generiert.
Die Sequenzfunktionen sind in den flows-Endpunkten gruppiert. Die API ermöglicht das Auflisten aller Flows, einschließlich der vom Typ "sequence", sowie das Aktivieren/Deaktivieren eines gesamten Flows. Zum Einschreiben eines Kontakts gibt es einen spezifischen Endpunkt, der die Kennung des Kontakts und die des Flows entgegennimmt.
Die genauen Details jedes Endpunkts (Parameter, Payloads und Beispiele) sind in der offiziellen API-Dokumentation von Papo verfügbar. Hier konzentrieren wir uns auf den Workflow zur Verwaltung von Follow-up-Sequenzen.
Schritt für Schritt: Auflisten, Einschreiben und Pausieren
1. Verfügbare Sequenzen auflisten
Bevor Sie Leads einschreiben, müssen Sie wissen, welche Sequenzen existieren und ihre Kennungen. Der Auflistungsaufruf gibt eine Liste mit Name, ID und Status (aktiv/inaktiv) zurück. Nur aktive Sequenzen akzeptieren neue Einschreibungen.
Mit der Liste zur Hand kann Ihr externes System zuordnen, welche Sequenz für welchen Lead verwendet werden soll.
2. Einen Kontakt in eine Sequenz einschreiben
Mit der Kontakt-ID (erhalten über Suche oder Erstellung über die Kontakte-API) und der ID der aktiven Sequenz senden Sie eine Anfrage, um ihn am Anfang der Reise einzufügen. Der Kontakt muss im Papo-CRM existieren; andernfalls erstellen Sie ihn zuvor über den Kontakte-Endpunkt.
Die Einschreibung startet sofort den Versand der geplanten Nachrichten und respektiert die im Flow konfigurierten Intervalle. Die Historie des Kontakts bleibt erhalten.
3. Die Kadenz für einen bestimmten Kontakt pausieren
Die Papo-API hat keinen direkten Befehl zum "Pausieren" der Teilnahme eines Kontakts an einer Sequenz. Sie können jedoch denselben Effekt erzielen, indem Sie die Kontakte-API mit einer Bedingung im Flow kombinieren.
Voraussetzung: Die Sequenz muss mit einem Bedingungsknoten erstellt worden sein, der ein benutzerdefiniertes Attribut prüft (z. B. status_pausa). Wenn das Attribut gleich "pausiert" ist, blockiert die Bedingung den Versand der nächsten Nachrichten; andernfalls gibt sie ihn frei. (Siehe den Artikel über vorübergehende Pause für Details zum Aufbau des Flows.)
Mit dieser Struktur im Flow erfolgt die Pause in zwei Schritten über die API:
- Identifizieren Sie den Kontakt anhand der ID oder suchen Sie ihn per Telefon/E-Mail über den Kontakte-Auflistungs-Endpunkt.
- Aktualisieren Sie das benutzerdefinierte Attribut des Kontakts auf "pausiert" (oder den Wert, den Ihre Bedingung erwartet). Verwenden Sie den Kontakt-Aktualisierungs-Endpunkt und senden Sie das benutzerdefinierte Feld.
Ab diesem Moment, wenn der Flow die Bedingung erreicht, erkennt er den Wert "pausiert" und sendet die Nachricht nicht. Um fortzufahren, aktualisieren Sie einfach das Attribut auf einen anderen Wert (z. B. "aktiv") oder löschen es, und der Kontakt macht dort weiter, wo er aufgehört hat.
Diese Methode behält den Kontakt eingeschrieben und den Fortschritt in der Kadenz bei, ohne die Historie zu verlieren.
Für wen diese Integration nützlich ist
- SDR- und B2B-Vertriebsoperationen, die Sequenzen aus externen Ereignissen auslösen (z. B. ein Lead hat ein Material heruntergeladen, ein Geschäft wurde im CRM erstellt).
- White-Label-Reseller, die Follow-up-Journeys automatisch für neue Kunden bereitstellen und Anfangskontakte ohne manuelle Aktion einschreiben.
- Marketing- und Automatisierungsteams, die Tools wie n8n oder Zapier verwenden, um Papo mit Dutzenden von Systemen zu verbinden und eine granulare Kontrolle über die Kadencen benötigen.
- Unternehmen mit bedingten Pauseprozessen, bei denen ein Lead um Zeit bittet und der Vertriebler die Sequenz unterbrechen möchte, ohne den Punkt der Kadenz zu verlieren – alles per Knopfdruck im externen CRM ausgelöst.
Häufig gestellte Fragen
Benötige ich den geheimen Schlüssel, um Sequenzen aufzulisten?
Ja. Jede Operation, die Kontodaten zurückgibt, erfordert eine Authentifizierung mit dem geheimen Schlüssel, der als Bearer-Token im Header Authorization gesendet wird.
Kann ich einen Kontakt einschreiben, der noch nicht bei Papo existiert?
Nein. Der Kontakt muss im Papo-CRM existieren. Sie können ihn zuerst über die Kontakte-API erstellen (mit Name, Telefon oder E-Mail) und ihn dann in die Sequenz einschreiben.
Erlaubt die API das Entfernen eines Kontakts aus der Sequenz?
Das Entfernen (Stornieren der Einschreibung) ist in der aktuellen Version nicht als spezifischer Endpunkt verfügbar. Die Alternative, um den Versand zu unterbrechen, ist das Pausieren über ein benutzerdefiniertes Attribut, wie beschrieben, oder das Deaktivieren des gesamten Flows, was alle Kontakte betrifft.
Wie weiß ich, ob die Pause per Attribut funktioniert hat?
Nach der Aktualisierung des Attributs verarbeitet die Sequenz weiterhin die Warteknoten. Wenn sie die Bedingung erreicht, prüft sie den Wert. Wenn er "pausiert" ist, wird die Nachricht nicht gesendet. Sie können im Kontaktprofil im Kontakte-Modul bestätigen, dass er eingeschrieben bleibt, aber die nächsten Nachrichten nicht ausgelöst werden.
Kann ich die gesamte Sequenz über die API pausieren?
Ja. Die API ermöglicht das Ändern des Status eines Flows auf inaktiv, wodurch die Sequenz für alle Kontakte pausiert wird. Verwenden Sie den Flow-Aktivierungs-/Deaktivierungs-Endpunkt. Um fortzufahren, aktivieren Sie ihn einfach wieder.
Wo finde ich die genauen Endpunkte und Codebeispiele?
Die vollständige API-Dokumentation ist unter https://papo.global/pt/docs verfügbar. Dort finden Sie die Endpunkte für Flows, Kontakte und die Anforderungsformate.
Lesen Sie auch
- Wie man die Papo-API zur Verwaltung von Automatisierungs-Flows verwendet
- Wie man die Papo-API zum Erstellen und Aktualisieren von Kontakten in Massen verwendet
Starten Sie kostenlos und automatisieren Sie Ihre Sequenzen →
Mit der Papo-API integrieren Sie Lead-Nurturing direkt in Ihren Stack, ohne das Panel zu öffnen – der erste Benutzer ist kostenlos, damit Sie es testen können.