**Mit der REST-API von [Papo](https://papo.global/) können Sie alle in Ihrem Konto verfügbaren Flows auflisten, Journeys aktivieren oder deaktivieren und Kontakte programmatisch in Automatisierungen einschreiben – alles über authentifizierte Anfragen, ohne das Panel zu öffnen. So integrieren Sie die Flow-Engine mit externen Systemen, n8n-Workflows, CRMs oder internen Skripten.**

Die Papo-API stellt Flow-Ressourcen bereit, mit denen Sie Automatisierungen genauso verwalten können wie bereits Posteingänge oder Kontakte. Damit können Entwicklungsteams, Integratoren und White-Label-Reseller in großen Mengen steuern, welche Journeys aktiv sind, Kontakte in Sequenzen starten und den Status der Automatisierungen mit Geschäftsprozessen synchronisieren.

## Zusammenfassung der Flow-Operationen über die API

| Vorgang | Beschreibung | Anwendungsbeispiel |
| :--- | :--- | :--- |
| Flows auflisten | Gibt die verfügbaren Flows und Sequenzen mit Kennung, Name, Typ und Status (Aktiv/Inaktiv) zurück. | Automatisierungen prüfen, mit externen Dashboards synchronisieren oder prüfen, was ausgeführt wird. |
| Flow aktivieren/deaktivieren | Ändert den Status eines bestimmten Flows, gibt den Empfang und die Verarbeitung von Kontakten frei oder pausiert sie. | Eine Journey während Wartungsarbeiten pausieren, nach Anpassungen freigeben oder eine beendete Kampagne deaktivieren. |
| Kontakt einschreiben | Fügt einen vorhandenen Kontakt am Anfang eines aktiven Flows ein und startet die konfigurierte Journey. | Leads aus einem externen CRM einfügen, einen Willkommens-Flow nach der Integration auslösen oder manuelle Eingänge korrigieren. |

## Wie die API-Authentifizierung funktioniert

Alle API-Aufrufe, auch die mit Flows, erfordern den **geheimen Schlüssel** des Kontos. Er muss als Bearer-Token im `Authorization`-Header gesendet werden. Der **öffentliche Schlüssel** des Kontos ist optional, muss aber, wenn er gesendet wird, zum selben Konto wie der geheime Schlüssel gehören.

Die Basis-URL der API ist `https://app.papo.global/api/v1`. Die Schlüssel werden im Entwicklerbereich des Papo-Panels generiert. Der geheime Schlüssel wird bei der Erstellung nur einmal angezeigt; bewahren Sie ihn an einem sicheren Ort auf und widerrufen Sie ihn bei Verdacht auf ein Leck.

Das Authentifizierungsmuster ist dasselbe wie bei allen Endpunkten:

```
curl https://app.papo.global/api/v1/me \
  -H "Authorization: Bearer sk_live_…" \
  -H "X-Papo-Public-Key: pk_live_…"
```

## Flows über die API in der Praxis verwalten

Obwohl die genauen Details jedes Endpunkts und seiner Parameter in der offiziellen API-Dokumentation stehen, folgt der allgemeine Arbeitsablauf diesen konzeptionellen Schritten:

1. **Authentifizieren Sie sich** mit dem geheimen Schlüssel (und, falls gewünscht, dem öffentlichen Schlüssel), um das Konto zu validieren.
2. **Listen Sie die Flows auf**, um die aktuelle Liste der Journeys einschließlich ihrer Kennungen und Status zu erhalten. So können Sie abbilden, was bereits existiert, und den richtigen Flow für die nächsten Vorgänge auswählen.
3. **Ändern Sie den Status** eines bestimmten Flows, falls nötig. Senden Sie eine Anfrage, die den Flow als aktiv (freigegeben für den Empfang von Kontakten) oder inaktiv (pausiert) festlegt. Nur aktive Flows verarbeiten Kontakte und akzeptieren Einschreibungen.
4. **Schreiben Sie einen Kontakt** in einen aktiven Flow ein. Geben Sie die Kennung des Kontakts und die Kennung des gewünschten Flows an, um ihn am Anfang der Journey einzufügen. Der Verlauf des Kontakts im CRM bleibt erhalten.
5. **Integrieren Sie mit externen Systemen** – über Webhooks oder direkte Aufrufe können Sie Kontakte aus einem externen Formular, einem Ereignis in einem anderen System oder einer Datenpipeline starten.

Die Plattform unterstützt außerdem die Erstellung leerer und inaktiver Flows sowie das Befüllen ihrer Knoten über die API, sodass komplette Automatisierungen programmatisch bereitgestellt werden können. Für die genauen Payload-Formate, Pflichtfelder und Codebeispiele lesen Sie den Abschnitt zu Flows in der Papo-API-Dokumentation.

## Für wen diese Integration sinnvoll ist

- **IT-Teams, die mehrere Automatisierungen betreiben** und Flows in großen Mengen pausieren, reaktivieren oder überwachen müssen, ohne manuell auf das Panel zuzugreifen.
- **White-Label-Reseller**, die standardisierte Journeys für jeden neuen Kunden automatisch bereitstellen, erste Kontakte einschreiben und die Abstimmung zwischen Plattformen aufrechterhalten möchten.
- **Integratoren und Entwickler**, die Papo mit CRMs, ERPs oder Tools wie n8n verbinden und Flows durch externe Ereignisse auslösen (ein Kauf, eine Registrierung, ein Termin).
- **Betriebsteams, die mit bedingter Einschreibung arbeiten**, bei der Kontakte nur dann in Flows aufgenommen werden, nachdem sie Geschäftsregeln in anderen Systemen erfüllt haben.

## Häufig gestellte Fragen

### Brauche ich den geheimen Schlüssel, um die Flows aufzulisten?

Ja. Die Auflistung der Flows sowie jeder Vorgang, der Kontodaten zurückgibt, erfordert die Authentifizierung mit dem geheimen Schlüssel. Das Muster ist dasselbe wie bei allen anderen Endpunkten: Senden Sie das Bearer-Token im `Authorization`-Header.

### Kann ich einen Flow über die API aktivieren oder deaktivieren?

Ja. Die API ermöglicht es, den Status eines Flows zwischen aktiv und inaktiv zu ändern. Sie benötigen die Kennung des Flows und den geheimen Schlüssel. Inaktive Flows empfangen keine Kontakte und durchlaufen die Journey nicht weiter, selbst wenn eine Einschreibung versucht wird.

### Wie schreibe ich einen Kontakt über die API in einen Flow ein?

Geben Sie die Kennung des Kontakts und die Kennung des aktiven Flows im Einschreibungsaufruf an. Der Kontakt wird am Anfang der Journey eingefügt, ohne den Gesprächsverlauf oder Profildaten zu löschen. Die offizielle Dokumentation beschreibt das genaue Format der Parameter.

### Ist es möglich, einen Flow über die API von Grund auf zu erstellen?

Ja. Die API ermöglicht es, einen leeren Flow (nur mit dem Start-Knoten) und inaktiv zu erstellen sowie seine Knoten mit Fragen, Nachrichten und Bedingungen zu befüllen. Das ist nützlich, um Automatisierungen skalierbar bereitzustellen, insbesondere in Reseller- oder Onboarding-Szenarien für neue Kunden.

### Gibt die API beim Auflisten den Status jedes Flows zurück?

Ja. Die Auflistung enthält den Status (Aktiv oder Inaktiv) jedes Flows und jeder Sequenz sowie Kennung, Name und Typ, sodass externe Systeme überwachen können, was funktioniert und was pausiert ist.

### Wo finde ich die vollständige Dokumentation der Flow-Routen?

Die offizielle Dokumentation ist unter [https://papo.global/pt/docs](https://papo.global/pt/docs) verfügbar. Dort finden Sie alle Endpunkte, akzeptierten Parameter, Fehlercodes und Beispiele in mehreren Sprachen. Die Flow-Routen folgen demselben REST- und Authentifizierungsmuster wie die anderen Module.

## Lesen Sie auch

- [So verwenden Sie die Papo-API zum Erstellen und Aktualisieren von Kontakten in großen Mengen](/hc/papo/articles/papo-api-kontakte-in-grossen-mengen-erstellen-aktualisieren)
- [So verwenden Sie die Papo-API zum Erstellen und Verwalten von Tags](/hc/papo/articles/papo-api-etiketten-tags-erstellen-verwalten)

---

**[Beginnen Sie jetzt mit der Integration Ihrer Flows →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

Erstellen Sie Ihr kostenloses Papo-Konto, greifen Sie auf die API-Schlüssel zu und verbinden Sie Ihre Automatisierungen mit der Außenwelt.