**Mit der REST-API von [Papo](https://papo.global/) können Sie die Teamverwaltung automatisieren, ohne das Dashboard zu öffnen: Teams auflisten, Teams erstellen, Teammitglieder auflisten, Benutzer zu einem Team hinzufügen und Posteingänge auflisten oder erstellen. Dies ist die programmatische Möglichkeit, die Service-Struktur mit externen Systemen, großen Betrieben und White-Label-Resellern synchron zu halten.**

Die Papo-API bietet Team- und Posteingangsressourcen mit derselben Authentifizierung wie die anderen Endpunkte der Plattform. Damit kann Ihr Team neue Strukturen bereitstellen, überprüfen, wer zu jeder Gruppe gehört, und das Routing von Konversationen ohne manuellen Eingriff im Dashboard vorbereiten.

## Übersicht der Team- und Mitgliederoperationen über die API

| Operation | Was sie bewirkt | Wann sie verwendet wird |
| :--- | :--- | :--- |
| Teams auflisten | Gibt die in der Kontn registrierten Teams zurück. | Die Struktur überprüfen, bevor ein neues Team erstellt wird. |
| Team erstellen | Erstellt ein Team mit Name und optionaler Beschreibung. | Ein neues Team per Skript, ERP oder CRM bereitstellen. |
| Teammitglieder auflisten | Gibt die Benutzer zurück, die zu diesem Team gehören. | Überprüfen, wer enthalten ist, und falsche Zugriffe vermeiden. |
| Benutzer zum Team hinzufügen | Fügt einen oder mehrere Benutzer hinzu, indem die IDs durch Kommas getrennt angegeben werden. | Das Team mit dem aktuellen Agentenbestand synchronisieren. |
| Posteingänge auflisten | Gibt die Posteingänge mit dem Kanal in der Administratoransicht zurück. | Verfügbare Kanäle und deren Organisation überprüfen. |
| Posteingang erstellen | Erstellt einen neuen Posteingang. | Neue Kanäle zusammen mit der Teamstruktur bereitstellen. |

## Wie die API-Authentifizierung funktioniert

Schreiboperationen, einschließlich der für Teams und Mitglieder, erfordern den geheimen Schlüssel des Kontos. Dieser muss als Bearer-Token im Autorisierungsheader gesendet werden. Der öffentliche Schlüssel des Kontos ist optional, muss jedoch, falls gesendet, mit demselben Konto wie der geheime Schlüssel übereinstimmen.

Die Basis-URL der API ist `https://app.papo.global/api/v1`. Die Schlüssel werden im Entwicklerbereich des Papo-Dashboards 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 Offenlegung.

## Schritt-für-Schritt-Anleitung zur Verwaltung von Teams und Mitgliedern über die API

1. Greifen Sie auf den Entwickler-/API-Bereich im Papo-Dashboard zu und generieren Sie einen geheimen Schlüssel. Kopieren Sie auch den öffentlichen Schlüssel des Kontos, wenn Sie eine zusätzliche Validierung wünschen.
2. Authentifizieren Sie sich bei jeder Anfrage mit dem geheimen Schlüssel als Bearer-Token. Wenn Sie die Validierung verstärken möchten, senden Sie den öffentlichen Schlüssel im in der Dokumentation angegebenen Header.
3. Listen Sie die vorhandenen Teams auf, um die aktuelle Struktur zu erfassen, bevor Sie neue erstellen.
4. Erstellen Sie ein Team, indem Sie eine JSON-Nutzlast mit Name und, falls erforderlich, Beschreibung senden. Konsultieren Sie die offizielle Dokumentation für das genaue Format.
5. Listen Sie die Teammitglieder auf, um zu überprüfen, wer bereits enthalten ist, und Duplikate zu vermeiden.
6. Fügen Sie Benutzer zum Team hinzu, indem Sie die IDs durch Kommas getrennt angeben. Dieser Schritt synchronisiert das Team mit dem aktuellen Agentenbestand.
7. Listen Sie die Posteingänge in der Administratoransicht auf, um die vorhandenen Kanäle zu überprüfen und die API auch zum Erstellen von Posteingängen zu verwenden, wenn dies erforderlich ist.

Da die API REST ist und JSON verwendet, kann jede Sprache mit HTTP-Unterstützung verwendet werden, um Teams und Mitglieder in Skripte, ERPs, CRMs oder Automatisierungstools 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

- **Große Betriebe**, die Teams häufig erstellen und anpassen müssen, ohne das Dashboard manuell zu öffnen.
- **IT- und Automatisierungsteams**, die die Agentenstruktur mit Verzeichnissen, HR oder internen Systemen synchronisieren.
- **White-Label-Reseller**, die Kundenkonten standardisiert bereitstellen und dabei dieselbe Logik für Teams und Posteingänge wiederverwenden.
- **Unternehmen, die die Papo-API bereits für Kontakte und Konversationen nutzen** und den Workflow mit der Teamverwaltung vervollständigen möchten.

Die API verwaltet die Teamstruktur und die Aufnahme von Mitgliedern. Benutzerrollen wie Agent oder Administrator und granulare Berechtigungen werden weiterhin im Dashboard festgelegt. Wenn Sie einen Benutzer zu einem Team hinzufügen und ihn mit den relevanten Posteingängen verbinden, steuern Sie den operativen Zugriff auf die Konversationen.

## Häufig gestellte Fragen

### Definiert die Papo-API die Benutzerrolle, wie Agent oder Administrator?

Nein. Die Team- und Mitglieder-API konzentriert sich auf die Erstellung von Teams, die Auflistung von Mitgliedern und die Aufnahme von Benutzern. Die Definition von Rolle und Berechtigungen jedes Benutzers erfolgt im Dashboard. Wenn Sie einen Benutzer in ein Team und in die richtigen Posteingänge aufnehmen, beschränken Sie den Zugriff auf die operativen Konversationen.

### Kann ich ein Team erstellen, ohne im selben Schritt Mitglieder hinzuzufügen?

Ja. Die API ermöglicht es, ein Team mit Name und optionaler Beschreibung zu erstellen, ohne sofort Benutzer aufzunehmen. Anschließend können Sie Mitglieder über die Batch-Hinzufügen-Operation hinzufügen.

### Wie identifiziert die API das Konto bei Anfragen?

Durch den geheimen Schlüssel, der als Bearer-Token gesendet wird. Der öffentliche Schlüssel ist optional und muss, falls gesendet, mit demselben Konto wie der geheime Schlüssel übereinstimmen.

### Funktioniert diese API für White-Label-Reseller?

Ja. Reseller können die API verwenden, um Teams und Mitglieder in Kundenkonten standardisiert bereitzustellen, wodurch manuelle Konfiguration reduziert und Konsistenz zwischen den Betrieben gewahrt wird.

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

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

## Lesen Sie auch

- [Wie man die Papo-API zum Erstellen und Verwalten von Tags (Etiketten) verwendet](/hc/papo/articles/papo-api-etiketten-tags-erstellen-verwalten)
- [Wie man Benutzer und Berechtigungen in Ihrer White-Label-Plattform verwaltet](/hc/papo/articles/benutzer-berechtigungen-white-label-plattform-verwalten)

---

**[Starten Sie kostenlos und automatisieren Sie Teams und Mitglieder über die API →](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)**

Der erste Benutzer ist für immer kostenlos, sodass Sie die Integration validieren können, bevor Sie Ihre Betriebsstruktur aufbauen.