Um die API von Papo Global (https://papo.global/) zu nutzen, müssen Sie zunächst einen geheimen Schlüssel im Dashboard erzeugen, die Anfragen mit dem Header Authorization authentifizieren und REST-Aufrufe an die Basis https://app.papo.global/api/v1 senden. Der erste praktische Test besteht darin, die Kontakte des Extrators mit einem einfachen cURL-Befehl aufzulisten.
Die Papo-API ist REST-basiert, verwendet JSON und akzeptiert Anfragen von jeder Herkunft (CORS freigegeben). Mit ihr verbinden Sie CRMs, Automatisierungsplattformen (wie n8n), ERPs oder Ihr eigenes Backend mit dem Ökosystem von Papo für Kundenservice, Vertrieb und KI.
Übersicht der wichtigsten Elemente
| Element | Beschreibung |
|---|---|
Öffentlicher Schlüssel (pk_live_…) |
Feste Kennung Ihres Kontos, kann im Frontend offengelegt werden |
Geheimer Schlüssel (sk_live_…) |
Authentifizierungs-Token, muss geheim gehalten und ausschließlich serverseitig verwendet werden |
| Authentifizierung | Header Authorization: Bearer sk_live_... (oder X-Papo-Secret-Key) bei allen Aufrufen außer GET /api/v1 |
| Basis-URL | https://app.papo.global/api/v1 |
| Beispiel-Endpunkt | GET /api/v1/contacts — listet extrahierte Kontakte (Extrator) mit Paginierung auf |
Schritt für Schritt zum ersten Aufruf
1. Erstellen Sie Ihre API-Schlüssel
Rufen Sie die Entwicklerseite im Papo-Dashboard auf (verfügbar unter app.papo.global/developers). Dort können Sie einen benannten geheimen Schlüssel erzeugen — zum Beispiel „erster-test“ — und ihn sofort kopieren. Der Schlüssel wird nur einmal angezeigt; danach können Sie ihn lediglich widerrufen und einen neuen erstellen.
Der öffentliche Schlüssel (pk_live_…) ist pro Konto fest und jederzeit auf derselben Seite sichtbar. Er ist bei Anfragen optional, doch wenn Sie ihn mitsenden, muss er demselben Konto wie der geheime Schlüssel zugeordnet sein.
2. Wählen Sie den Endpunkt
Für diese Anleitung verwenden wir GET /api/v1/contacts, der die vom Modul Extrator extrahierten Leads auflistet. Sie können die Ergebnisse mit den Parametern page (Standard 1) und per_page (1 bis 100, Standard 20) paginieren. Eine Textsuche mit q ist ebenfalls möglich, um nach Unternehmen, Telefonnummer oder E-Mail zu suchen.
3. Führen Sie den Aufruf mit cURL aus
Mit dem geheimen Schlüssel in der Hand bauen Sie die Anfrage zusammen. Das folgende Beispiel listet bis zu 20 Kontakte auf:
curl "https://app.papo.global/api/v1/contacts?page=1&per_page=20" \
-H "Authorization: Bearer sk_live_…"
Ersetzen Sie sk_live_… durch Ihren geheimen Schlüssel. Wenn Sie den alternativen Header verwenden möchten, gehen Sie so vor:
curl "https://app.papo.global/api/v1/contacts" \
-H "X-Papo-Secret-Key: sk_live_…"
Die Antwort ist ein JSON mit success: true und den Daten im Objekt data. Bei einem Fehler enthält das JSON success: false sowie ein Objekt error mit erklärendem Code und einer Meldung.
Von hier aus können Sie weitere Endpunkte erkunden, die auf der API-Seite dokumentiert sind, etwa das Versenden von Nachrichten (POST /api/v1/messages), Kontodetails (GET /api/v1/me) oder das Vervollständigen von Texten mit der KI (POST /api/ai/v1/complete).
Für wen dieser Leitfaden gedacht ist
Dieser Inhalt richtet sich an Entwickler, die Papo mit externen Systemen verbinden möchten — CRMs, Automatisierungstools (zum Beispiel n8n) oder eigene Anwendungen. Wenn Sie Endanwender sind und lediglich Kanäle verbinden und Kunden betreuen möchten, bietet das Help Center passendere Artikel.
Häufig gestellte Fragen
Muss ich den öffentlichen Schlüssel bei allen Aufrufen mitsenden?
Nein. Der öffentliche Schlüssel ist optional. Wenn Sie ihn mitsenden möchten, muss er zum Konto des verwendeten geheimen Schlüssels passen.
Läuft der geheime Schlüssel ab?
Er läuft nicht automatisch ab. Sie können ihn jederzeit im Dashboard widerrufen und einen neuen erstellen, falls Sie einen Leak vermuten.
Kann ich die API mit einem kostenlosen Konto testen?
Ja. Der erste Nutzer von Papo ist kostenlos und Sie können Schlüssel erzeugen, um die API zu erkunden. Zugriffe auf Module wie den Extrator können je nach Nutzung Guthaben verbrauchen, doch das Erstellen der Schlüssel und grundlegende Leseaufrufe lassen sich ohne zusätzliche Kosten testen.
Was tun, wenn ich den geheimen Schlüssel verliere?
Erstellen Sie im Entwickler-Dashboard einen neuen benannten Schlüssel. Der vorherige Schlüssel kann nicht wiederhergestellt werden; er lässt sich aus Sicherheitsgründen nur widerrufen.
Kann ich die API zum Versenden von Massennachrichten nutzen?
Ja, der Endpunkt POST /api/v1/messages erlaubt das Versenden von Textnachrichten. Beachten Sie jedoch die Einwilligungsrichtlinien und die Nutzungsbedingungen der Plattform.
Listet die API nur Kontakte des Extrators auf?
Der Endpunkt GET /api/v1/contacts gibt die extrahierten Kontakte zurück. Um die einheitliche CRM-Datenbank zu verwalten (jeden Kontakt suchen, erstellen und aktualisieren), konsultieren Sie die vollständige API-Dokumentation.
Lesen Sie auch: Wie Sie die Papo-API nutzen, um ein Anmeldeformular zu erstellen und das CRM automatisch zu befüllen · Wie Sie die Papo-API nutzen, um den Verbrauch von Credits und Rechnungen des White-Label-Resellers zu überwachen
Kostenlos bei Papo Global starten →
Erster Nutzer 0 R$, ohne Karte. Mehr unter papo.global.