**Mit der REST-API von [Papo](https://papo.global/) können Sie bestehende Posteingänge auflisten und neue Verbindungen für Kanäle wie WhatsApp und Instagram erstellen – alles über authentifizierte Anfragen, ohne das Panel zu öffnen. Das ist der programmatische Weg, Servicekanäle bereitzustellen, externe Systeme zu integrieren und den Multichannel-Betrieb mit der Automatisierung abzustimmen.**

Die Papo-API stellt Posteingangsressourcen bereit, mit denen Sie die aktuelle Konfiguration abfragen und neue Kanäle hinzufügen können. So können IT-Teams, Integratoren und White-Label-Reseller Verbindungen in großen Mengen verwalten, Setups zwischen Konten replizieren und die Kanalaktivierung automatisieren, ohne von der Oberfläche abhängig zu sein.

## Überblick über die Posteingangsoperationen via API

| Vorgang | Was er tut | Wann verwenden |
| :--- | :--- | :--- |
| Posteingänge auflisten | Gibt die Posteingänge des Kontos zurück, mit dem zugehörigen Kanal (WhatsApp, Instagram, E-Mail usw.) und Details der Konfiguration. | Aktive Kanäle prüfen, mit Monitoring-Systemen synchronisieren oder Migrationen vorbereiten. |
| Posteingang erstellen | Erstellt einen neuen Posteingang und legt Kanal, Namen und Agenten mit Zugriff fest. | Kanäle automatisch bereitstellen, wenn neue Kunden, Einheiten oder Marken integriert werden. |

## Wie die API-Authentifizierung funktioniert

Alle API-Aufrufe, einschließlich der Auflistung von Posteingängen, erfordern den **Secret Key** des Kontos. Er muss als Bearer-Token im Header `Authorization` gesendet werden. Der **Public Key** des Kontos ist optional, muss aber, wenn er gesendet wird, zum selben Konto wie der Secret Key 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 Secret Key wird bei der Erstellung nur einmal angezeigt; bewahren Sie ihn an einem sicheren Ort auf und widerrufen Sie ihn bei Verdacht auf Offenlegung.

Um die Authentifizierung zu validieren, können Sie den Endpoint `GET /api/v1/me` aufrufen, der die Kontodaten zurückgibt. Das Authentifizierungsmuster ist dasselbe wie bei allen anderen Endpoints:

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

## Posteingänge in der Praxis verwalten

1. Rufen Sie den Entwickler-/API-Bereich im Papo-Panel auf und generieren Sie einen Secret Key. Kopieren Sie auch den Public Key des Kontos.
2. Authentifizieren Sie sich bei jeder Anfrage mit dem Secret Key als Bearer-Token. Wenn Sie die Validierung verstärken möchten, senden Sie den Public Key im Header `X-Papo-Public-Key`.
3. Um **Posteingänge aufzulisten**, rufen Sie den Endpoint zum Auflisten von Posteingängen auf. Die Antwort enthält die Kennung jedes Posteingangs, den konfigurierten Kanal und weitere Eigenschaften, sodass Sie erfassen können, was bereits existiert, bevor Sie neue erstellen.
4. Um **einen neuen Posteingang zu erstellen**, senden Sie ein JSON-Payload mit den Informationen des gewünschten Kanals – zum Beispiel WhatsApp (offizielle Meta-API), Instagram, E-Mail oder Telegram. Fügen Sie den Namen des Posteingangs und die Kennungen der Agenten hinzu, die Zugriff haben sollen. Konsultieren Sie die offizielle Dokumentation für das genaue Format der Felder und akzeptierten Werte.
5. Nach der Erstellung ist der Posteingang sofort im Panel verfügbar und beginnt Nachrichten zu empfangen, sobald die Verbindung des Kanals abgeschlossen ist (bei Kanälen, die eine Kopplung erfordern, wie WhatsApp, gibt die API die erforderlichen Anweisungen zurück).

Da die API REST ist und JSON verwendet, kann jede Sprache mit HTTP-Unterstützung verwendet werden, um die Posteingangsverwaltung in Skripte, Automatisierungstools (wie n8n) oder Provisionierungssysteme zu integrieren. Die offizielle Dokumentation unter `https://papo.global/pt/docs` enthält Details zu Authentifizierung, Parametern, Antworten und Codebeispielen.

## Für wen diese Integration sinnvoll ist

- **IT-Teams, die Kanäle in großen Mengen bereitstellen** für neue Einheiten, Franchises oder Marken, ohne das Panel einzeln aufrufen zu müssen.
- **White-Label-Reseller**, die die Erstellung von Posteingängen für jeden neuen Kunden automatisieren möchten und dabei eine standardisierte Konfiguration beibehalten.
- **Betriebe, die Konfigurationen zwischen Konten migrieren oder replizieren** und die Auflistung zum Prüfen sowie die Erstellung zum Spiegeln von Kanälen nutzen.
- **Integratoren, die Papo mit externen Systemen verbinden** zur Kanalverwaltung, damit die Serviceumgebung Änderungen automatisch widerspiegelt.

## Häufig gestellte Fragen

### Benötige ich den Secret Key, um die Posteingänge aufzulisten?

Ja. Die Auflistung von Posteingängen erfordert Authentifizierung mit dem Secret Key des Kontos, da sie sensible Konfigurationsinformationen zurückgibt. Das Muster ist dasselbe wie bei den übrigen API-Aufrufen: Senden Sie den Bearer-Token im Header `Authorization`.

### Kann ich einen Posteingang für WhatsApp via API erstellen?

Ja. Beim Erstellen eines Posteingangs geben Sie den gewünschten Kanaltyp an – einschließlich WhatsApp (offizielle Meta-API) und anderer unterstützter Kanäle. Das Payload muss dem erwarteten Format für den gewählten Kanal entsprechen, gemäß der offiziellen Dokumentation.

### Ist es möglich, einen bestehenden Posteingang über die API zu aktualisieren?

Die aktuelle API ermöglicht das Auflisten und Erstellen von Posteingängen. Um Einstellungen eines bereits bestehenden Posteingangs zu ändern (z. B. Agenten austauschen oder umbenennen), können Sie das Papo-Panel verwenden oder, falls nötig, den Posteingang mit den neuen Parametern neu erstellen.

### Wie ordne ich Agenten einem Posteingang während der Erstellung zu?

Im Erstellungs-Payload können Sie die Kennungen der Agenten angeben, die Zugriff auf den Posteingang haben sollen. Diese IDs können über die API für Teams und Mitglieder abgerufen werden. Konsultieren Sie die Dokumentation für das genaue Format.

### Ist die Authentifizierung dieselbe wie bei anderen Papo-Endpoints?

Ja. Alle Aufrufe, die auf Kontoresourcen zugreifen, verwenden den Secret Key als Bearer-Token. Der Public Key ist optional und muss, wenn er gesendet wird, zum selben Konto gehören.

### Wo finde ich die genauen Pfade und das Payload-Format?

In der offiziellen API-Dokumentation, verfügbar unter `https://papo.global/pt/docs`. Dort finden Sie Details zu Authentifizierung, Parametern, Antworten und Codebeispielen für Posteingänge und weitere Ressourcen.

## Lesen Sie auch

- [So verwenden Sie die Papo-API zur Verwaltung von Teams und Mitgliedern](/hc/papo/articles/papo-api-teams-mitglieder-verwalten)
- [So verwenden Sie die Papo-API zum Erstellen und Verwalten von Labels (Tags)](/hc/papo/articles/papo-api-etiketten-tags-erstellen-verwalten)

---

**[Starten Sie jetzt mit der Automatisierung Ihrer Verbindungen →](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 ein kostenloses Konto und integrieren Sie Kanäle via API, ohne das Panel zu öffnen.