**Mit der REST-API von [Papo](https://papo.global/) kannst du einen Endpoint auf deiner Website erstellen, der die Daten des Registrierungsformulars empfängt und die Kontakt-API aufruft, um automatisch Einträge im CRM anzulegen – inklusive benutzerdefinierter Attribute –, sodass manuelle Eingaben entfallen und die Lead-Integration beschleunigt wird.**

Statt Tabellen zu exportieren oder Daten zwischen Systemen zu kopieren, sorgt diese Integration dafür, dass jede neue Registrierung auf deiner Website in Echtzeit zu einem Kontakt im CRM von Papo wird. Der Ablauf ist einfach: Das Formular sendet die Daten an ein Backend, das du kontrollierst, dieses Backend authentifiziert sich an der Papo-API und legt den Kontakt mit Name, E-Mail, Telefon und allen benutzerdefinierten Feldern an, die dein Betrieb benötigt.

## Zusammenfassung der Integration

| Komponente | Funktion | Beispiel |
| :--- | :--- | :--- |
| Formular auf der Website | Erfasst Name, E-Mail, Telefon und zusätzliche Felder des Leads. | Capture-Seite, Landingpage, Checkout. |
| Zwischengeschalteter Endpoint | Empfängt die Formulardaten und ruft die Papo-API auf. | Skript in Node.js, Python oder Automatisierung in n8n/Zapier. |
| Kontakt-API von Papo | Legt den Kontakt mit den übermittelten Daten im CRM an. | Authentifizierte POST-Anfrage mit geheimem Schlüssel. |
| Benutzerdefinierte Attribute | Fügt dem Kontakt Felder wie Herkunft, Interesse oder Score hinzu. | `custom_attributes` mit `"origem": "site"`, `"plano_interesse": "gold"`. |

## So funktioniert es: Schritt für Schritt

1. **Erzeuge die API-Schlüssel im Papo-Panel**  
   Rufe den Entwicklerbereich deines Papo-Kontos auf und erstelle einen geheimen Schlüssel. Der öffentliche Schlüssel des Kontos ist auf diesem Bildschirm ebenfalls sichtbar. Der geheime Schlüssel wird nur einmal angezeigt; bewahre ihn an einem sicheren Ort auf und gib ihn niemals im Frontend preis.

2. **Erstelle das Formular auf deiner Website**  
   Baue das Formular mit den Feldern auf, die du an das CRM senden möchtest: Name, E-Mail, Telefon und beliebige zusätzliche Daten (Interesse, Herkunft, Stadt usw.). Das Formular muss eine HTTP-Anfrage (POST) an den Endpoint senden, den du im nächsten Schritt erstellst.

3. **Baue den zwischengeschalteten Endpoint**  
   Erstelle auf deinem Server oder in einer serverlosen Funktion (Node.js, Python, PHP usw.) eine Route, die die Formulardaten empfängt. Dieser Code ist für Folgendes zuständig:
   - Die empfangenen Felder validieren.
   - Das JSON-Payload für die Papo-API zusammenstellen.
   - Mit dem geheimen Schlüssel authentifizieren (Bearer-Token) und optional den öffentlichen Schlüssel im Header `X-Papo-Public-Key` senden.
   - Den Endpoint zum Anlegen von Kontakten der Papo aufrufen.

4. **Rufe die Kontakt-API von Papo auf**  
   Verwende den Endpoint zum Anlegen von Kontakten (die genaue Route und das Payload-Format findest du in der offiziellen Dokumentation unter `https://papo.global/pt/docs`). Sende mindestens den Namen und die E-Mail-Adresse oder Telefonnummer. Die Antwort der API bestätigt die Erstellung mit den Daten des neuen Kontakts.

5. **Füge benutzerdefinierte Attribute hinzu**  
   Wenn dein Konto Definitionen für benutzerdefinierte Attribute besitzt (etwa „origem“, „utm_source“, „score“), kannst du sie im selben Payload oder in einem zusätzlichen Aufruf senden. Die API erlaubt es, `custom_attributes` am Kontakt zu definieren bzw. zusammenzuführen, sodass diese Felder später nicht mehr manuell ausgefüllt werden müssen.

6. **Verarbeite die Antwort und gib sie an den Nutzer zurück**  
   Nach erfolgreicher Erstellung kann dein Endpoint den Lead auf eine Dankesseite weiterleiten oder eine Erfolgsmeldung anzeigen. Im Fehlerfall (ungültiger Schlüssel, fehlende Daten) protokolliere den Fehler und gib eine nutzerfreundliche Meldung zurück.

Da die Papo-API REST-basiert ist und JSON verwendet, kann jede Sprache mit HTTP-Unterstützung genutzt werden. Die offizielle Dokumentation enthält Beispiele in JavaScript, Python und curl sowie Details zur Authentifizierung und zu den Fehlercodes.

## Für wen diese Integration sinnvoll ist

- **Websites und Landingpages, die Leads erfassen** und die manuelle Übertragung von Daten ins CRM vermeiden wollen.
- **E-Commerce-Shops und SaaS-Anbieter**, die beim Registrieren oder Kauf automatisch einen Kontakt anlegen möchten.
- **Agenturen und Beratungen**, die Lead-Kampagnen fahren und möchten, dass die Leads in Echtzeit ins CRM gelangen, um sofort nachfassen zu können.
- **White-Label-Reseller und Integratoren**, die individuelle Abläufe für Kunden aufbauen und Formulare von Websites ohne manuellen Eingriff mit Papo verbinden.
- **Marketing- und Vertriebsteams**, die benutzerdefinierte Attribute zur Segmentierung nutzen und möchten, dass diese Felder bereits an der Quelle automatisch befüllt werden.

## Häufig gestellte Fragen

### Brauche ich fortgeschrittene Programmierkenntnisse, um diese Integration umzusetzen?

Ja. Du musst entweder einen Endpoint auf deinem Server entwickeln oder Automatisierungstools (n8n, Zapier) einsetzen, die die Brücke zwischen dem Formular und der Papo-API schlagen. Der Code selbst ist einfach, setzt aber Grundkenntnisse in HTTP und im Umgang mit JSON voraus.

### Kann ich jede Programmiersprache verwenden?

Ja. Die Papo-API ist REST-basiert und antwortet in JSON. Jede Sprache, die HTTP-Anfragen unterstützt (Python, Node.js, PHP, Ruby usw.), kann verwendet werden. Die offizielle Dokumentation liefert Beispiele in JavaScript und Python.

### Können benutzerdefinierte Attribute direkt beim Anlegen des Kontakts erstellt werden?

Ja. Die Papo-API erlaubt es, die `custom_attributes` des Kontakts beim Anlegen zu definieren oder sie später zu aktualisieren. In der Dokumentation findest du das genaue Payload-Format und kannst prüfen, ob die Attributdefinitionen im Konto bereits existieren.

### Wie stelle ich die Sicherheit des geheimen Schlüssels sicher?

Der geheime Schlüssel darf niemals im Frontend (öffentliches HTML/JavaScript) offengelegt werden. Er gehört ausschließlich auf den Server, in Umgebungsvariablen. Verwende HTTPS für die gesamte Kommunikation und widerrufe den Schlüssel sofort, wenn ein Leak vermutet wird.

### Was tun, wenn die API einen Fehler zurückgibt?

Die Papo-API gibt standardisierte Antworten mit `success: false` und einem `error`-Objekt zurück, das Code und Meldung enthält. Behandle diese Fehler in deinem Code: Prüfe, ob die Pflichtfelder gesendet wurden, ob der Schlüssel aktiv ist und ob das Payload-Format korrekt ist. Die Dokumentation listet die wichtigsten Fehlercodes auf.

### Kann ich diese Integration mit Formularen von Plattformen wie WordPress, Typeform oder RD Station nutzen?

Ja. Du kannst in diesen Plattformen Webhooks einrichten, die die Formulardaten an deinen zwischengeschalteten Endpoint senden, der dann die Papo-API aufruft. Alternativ kannst du fertige Integrationen über Zapier oder n8n nutzen und einen Flow erstellen, der das Formular-Event empfängt und die Kontakterstellung in Papo auslöst.

## Lies auch

- [So verwendest du die Papo-API zur Verwaltung von Unternehmen im CRM](/hc/papo/articles/papo-api-unternehmen-crm-verwalten)
- [So integrierst du Papo mit Zapier über API und Webhooks](/hc/papo/articles/papo-mit-zapier-ueber-api-und-webhooks-integrieren)

---

**[Kostenlos starten →](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)**

Erstelle dein kostenloses Papo-Konto und integriere Registrierungsformulare in wenigen Minuten mit dem CRM – ohne manuelle Eingabe.