Mit der REST-API von Papo können Sie Unternehmen im CRM auflisten, suchen, erstellen, aktualisieren und Kontakte mit ihnen verknüpfen – alles über authentifizierte Anfragen, ohne das Dashboard zu öffnen. Das ist der programmatische Weg, die Verwaltung von B2B-Kunden mit externen Systemen, ERPs, CRMs oder Automatisierungstools synchron zu halten.
Die Papo-API stellt Funktionen des Moduls Unternehmen bereit, damit Ihr Betrieb B2B-Konten organisiert, verknüpfte Kontakte konsolidiert und aktuelle Gespräche jedes Unternehmens verfolgt. Mit Authentifizierung per Secret Key und JSON-Antworten ermöglichen diese Endpunkte die Integration der Kontoansicht in Skripte, Automatisierungen und White-Label-Reseller.
Übersicht der Unternehmen-Operationen über die API
| Vorgang | Funktion | Wann verwenden |
|---|---|---|
| Unternehmen auflisten | Gibt die im CRM registrierten Unternehmen mit Name, Domain und Anzahl der Kontakte zurück. | Die Kontenbasis prüfen oder Unternehmen mit einem anderen System synchronisieren. |
| Nach Name oder Domain suchen | Findet bestimmte Unternehmen im CRM. | Das B2B-Konto finden, bevor Daten aktualisiert oder Kontakte verknüpft werden. |
| Unternehmen im Detail anzeigen | Gibt die Daten eines Unternehmens anhand des Identifikators zurück. | Ein bestimmtes Konto während einer Integration abfragen. |
| Unternehmen erstellen | Erstellt ein neues Unternehmen; der Name ist obligatorisch, Domain und Beschreibung sind optional. | B2B-Konten automatisch aus einem ERP, einer Website oder einem externen Ablauf anlegen. |
| Unternehmen aktualisieren | Aktualisiert Name, Domain und Beschreibung eines bestehenden Unternehmens. | Das CRM stets mit der B2B-Kundenbasis abgeglichen halten. |
| Kontakt verknüpfen | Verknüpft einen bestehenden Kontakt aus dem CRM mit einem Unternehmen. | Die Beziehung und Historie zwischen Kontakten und Konten konsolidieren. |
| Kontakte und Gespräche auflisten | Liefert die mit dem Unternehmen verknüpften Kontakte und die letzten Gespräche dieser Kontakte. | Die vollständige Kontoansicht während des Supports oder Follow-ups erhalten. |
Wie die API-Authentifizierung funktioniert
Alle Schreib-Routen, einschließlich der Unternehmen-Operationen, erfordern den Secret Key des Kontos. Er muss als Bearer-Token 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-Dashboards generiert. Der Secret Key wird bei der Erstellung nur einmal angezeigt; bewahren Sie ihn sicher auf und widerrufen Sie ihn bei Verdacht auf eine Offenlegung.
Da die API REST-basiert ist und JSON verwendet, kann jede Sprache mit HTTP-Unterstützung genutzt werden, um Unternehmen 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.
Unternehmen über die API in der Praxis verwalten
- Rufen Sie den Entwicklerbereich des Papo-Dashboards auf und generieren Sie einen Secret Key. Kopieren Sie auch den Public Key des Kontos.
- 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 in der Dokumentation angegebenen Header.
- Um die Unternehmen des CRM aufzulisten, rufen Sie den Unternehmen-Listendpoint auf. Die Antwort enthält Name, Domain und Anzahl der Kontakte jedes Kontos.
- Um ein bestimmtes Unternehmen zu finden, verwenden Sie den Suchendpoint nach Name oder Domain. So erhalten Sie den Identifikator, der zum Aktualisieren von Daten oder Verknüpfen von Kontakten erforderlich ist.
- Um ein Unternehmen zu erstellen, senden Sie einen JSON-Payload mit dem obligatorischen Namen. Domain und Beschreibung können als optionale Daten angegeben werden.
- Um ein Unternehmen zu aktualisieren, senden Sie die neuen Werte für Name, Domain oder Beschreibung an den Update-Endpoint.
- Um einen bestehenden Kontakt zu verknüpfen, verwenden Sie den Identifikator des Kontakts und den Identifikator des Unternehmens in der Verknüpfungsoperation.
Da die API eine Operation pro Anfrage verarbeitet, erfolgt die Massenverwaltung durch sequenzielles Ausführen von Aufrufen. Ein Skript in Python, Node.js oder eine Automatisierung in Tools wie n8n kann Konten aus einer CSV-Datei oder einem ERP lesen, Unternehmen anlegen, Kontakte verknüpfen und die Antworten zur Fehlerbehandlung sammeln.
Für wen diese Integration sinnvoll ist
- B2B-Unternehmen, die Konten in einem anderen CRM oder ERP verwalten und automatisch mit dem Modul Unternehmen von Papo synchronisieren möchten.
- Vertriebsteams, die mit Account-Kunden arbeiten, wie Agenturen, Beratungen, SaaS und Provider, und Kontakte sowie Gespräche pro Unternehmen konsolidieren müssen.
- Betriebe, die Unternehmen über Formulare, Landingpages oder externe Systeme erfassen und sie ohne manuelle Nacharbeit im CRM anlegen möchten.
- White-Label-Reseller und Integratoren, die Papo mit Kundensystemen verbinden und die Kontenverwaltung über verschiedene Umgebungen hinweg konsistent halten möchten.
- IT-Teams, die benutzerdefinierte Integrationen erstellen und die API als Brücke zwischen der Unternehmensbasis und dem restlichen Betrieb nutzen.
Häufig gestellte Fragen
Muss ich den Kontakt erstellen, bevor ich ihn mit einem Unternehmen verknüpfe?
Ja. Die API verknüpft einen Kontakt, der bereits im CRM existiert. Um einen neuen Kontakt anzulegen, verwenden Sie die Kontakt-Erstellungsendpunkte und führen danach die Verknüpfung mit dem Unternehmen durch.
Welche Daten kann ich bei einem Unternehmen über die API aktualisieren?
Sie können Name, Domain und Beschreibung des Unternehmens aktualisieren. Die Erstellung erfordert den Namen; Domain und Beschreibung sind optional.
Erlaubt die API, die Gespräche eines Unternehmens aufzulisten?
Ja. Das Modul Unternehmen ermöglicht es, die mit einem Unternehmen verknüpften Kontakte und die letzten Gespräche dieser Kontakte aufzulisten, was die Kontoansicht während des Supports erleichtert.
Ist die Authentifizierung dieselbe wie bei den anderen Papo-Endpunkten?
Ja. Die Schreib-Routen erfordern den Secret Key des Kontos, gesendet 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 unter https://papo.global/pt/docs. Dort finden Sie Details zu Authentifizierung, Parametern, Antworten und Codebeispielen für Unternehmen und weitere Ressourcen.
Kann ich die API verwenden, um die Unternehmensbasis mit meinem aktuellen CRM zu synchronisieren?
Ja. Da die API REST-basiert ist und JSON verwendet, können Sie das Auflisten, Erstellen, Aktualisieren und Verknüpfen von Kontakten sequenziell automatisieren und die beiden Systeme abgeglichen halten.
Lesen Sie auch
- So verwenden Sie das Modul Unternehmen im Papo-CRM
- So verwenden Sie die Papo-API zur Verwaltung benutzerdefinierter Kontaktattribute
Starten Sie kostenlos und verwalten Sie Unternehmen im CRM über die API →
Der erste Papo-Benutzer ist für immer kostenlos, ohne Kreditkarte.