**Um Deals im Kanban programmatisch zu erstellen und zu aktualisieren, verwenden Sie die REST-API von [Papo](https://papo.global/). Mit der Authentifizierung über einen geheimen Schlüssel (Bearer-Token) und dem öffentlichen Schlüssel des Kontos können Sie Anfragen senden, die Karten erstellen, Opportunities zwischen Phasen verschieben und Ergebnisse markieren, wodurch der Verkaufstrichter ohne manuellen Eingriff in externe Systeme integriert wird.**

Die Papo-API bietet Schreiboperationen für das Kanban und ermöglicht die Arbeit mit Funnels, Phasen und Karten des CRM. Dies ermöglicht die Synchronisierung eines ERP, einer Landingpage oder eines Zahlungstools mit dem Verkaufstrichter, sodass Opportunities stets aktuell bleiben.

## Zusammenfassung der Kanban-Integration

| Schritt | Aktion | Wichtiges Detail |
| :--- | :--- | :--- |
| 1. Schlüssel erhalten | Generieren Sie den geheimen Schlüssel (`sk_live_…`) und kopieren Sie den öffentlichen Schlüssel (`pk_live_…`) im Papo-Dashboard. | Der geheime Schlüssel wird nur einmal angezeigt; bewahren Sie ihn an einem sicheren Ort auf. |
| 2. Aufrufe authentifizieren | Fügen Sie den Header `Authorization: Bearer sk_live_…` in alle Schreibanfragen ein. | Der öffentliche Schlüssel kann im Header `X-Papo-Public-Key` gesendet werden (optional). |
| 3. Funnels und Phasen kennenlernen | Listen Sie die Kanban-Funnels und ihre Phasen auf, um die erforderlichen Identifikatoren zu erhalten. | Die API-Antwort enthält die Identifikatoren, die in den nächsten Aufrufen verwendet werden. |
| 4. Karten erstellen oder verschieben | Senden Sie die Operation, um eine Karte in einer Phase zu erstellen, eine Karte eines Kontakts in eine andere Phase zu verschieben oder ein Ergebnis zu markieren. | Jede Operation verarbeitet eine Aktion; für viele Datensätze automatisieren Sie das Senden in einer Schleife. |
| 5. Antwort validieren | Die API gibt `success: true` und die Daten der Karte oder der Liste zurück. | Im Fehlerfall enthält der Antworttext einen Code und eine Nachricht zur Korrektur. |

## Was die API im Kanban ermöglicht

Mit den Kanban-Endpunkten können Sie programmatisch:

- Verfügbare Funnels und ihre Phasen mit Name und Position auflisten.
- CRM-Karten auflisten.
- Alle gewonnenen Karten für Berichte über abgeschlossene Verkäufe auflisten.
- Eine Karte in einer Phase erstellen, optional verknüpft mit einem vorhandenen Kontakt.
- Die Karte eines Kontakts in eine andere Phase des Funnels verschieben.
- Karten als gewonnen oder verloren markieren.
- Einen Kanban-Funnel mit Standard- oder benutzerdefinierten Phasen erstellen.

Diese Operationen ermöglichen es dem Funnel, automatisch widerzuspiegeln, was außerhalb von Papo geschieht, wie ein bestätigter Kauf, ein geplantes Meeting oder eine Anmeldung von der Website.

## Wie die Authentifizierung und die Aufrufe funktionieren

Jeder Aufruf, der Daten ändert, erfordert den **geheimen Schlüssel** des Kontos. Dieser muss als Bearer-Token im Header `Authorization` oder alternativ im Header `X-Papo-Secret-Key` gesendet werden. Der **öffentliche Schlüssel** kann die Anfrage im Header `X-Papo-Public-Key` begleiten; seine Verwendung ist optional, aber wenn er gesendet wird, muss er zum selben Konto wie der geheime Schlüssel gehören.

Die Basis-URL der API ist `https://app.papo.global/api/v1`. Von dort aus akzeptieren die Kanban-Endpunkte die entsprechenden HTTP-Verben zum Erstellen, Verschieben, Aktualisieren und Auflisten. Da die vollständige Dokumentation die Pfade, Parameter und akzeptierten Felder detailliert beschreibt, empfehlen wir, die [offizielle API-Referenz](https://papo.global/pt/docs) vor dem Codieren zu konsultieren.

Um zu überprüfen, ob Ihre Schlüssel funktionieren, können Sie den Endpunkt `GET /api/v1/me` aufrufen, der die Kontodaten zurückgibt. Das Authentifizierungsmuster ist dasselbe wie bei den anderen Endpunkten:

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

Die erfolgreiche Antwort enthält `success: true` und das Objekt `data` mit den Kontoinformationen.

## Typischer Integrationsablauf mit externen Systemen

Ein Skript in Python, Node.js oder eine Automatisierung in Tools wie n8n kann den vollständigen Funnel-Zyklus ausführen:

1. Funnels und Phasen auflisten, um die Identifikatoren jeder Spalte zu erhalten.
2. Eine Karte in der Startphase erstellen, bei Bedarf mit einem Kontakt verknüpfen.
3. Die Karte in eine neue Phase verschieben, wenn ein externes Ereignis eintritt – zum Beispiel bestätigte Zahlung oder geplantes Meeting.
4. Die Karte als gewonnen oder verloren markieren, wenn die Opportunity abgeschlossen ist.
5. Gewonnene Karten auflisten, um Berichte, Dashboards oder BI-Systeme zu speisen.

Da die API REST ist und JSON verwendet, funktioniert jede Sprache mit HTTP-Unterstützung. Die Details zu Payload und Feldern jeder Operation finden Sie in der offiziellen Dokumentation.

## Für wen diese Integration geeignet ist

- **Unternehmen, die Opportunities in externen Systemen erfassen**, wie Landingpages, ERPs oder E-Commerce, und möchten, dass diese automatisch in den Papo-Funnel gelangen.
- **Betriebe, die Karten aufgrund von Zahlungsereignissen verschieben müssen**, wie Gateways oder Abrechnungsplattformen, ohne das CRM manuell zu öffnen.
- **BI- und Datenteams**, die gewonnene Karten und Werte für Echtzeit-Dashboards abrufen möchten.
- **IT-Teams, die benutzerdefinierte Integrationen** zwischen Papo und internen Tools erstellen und die API als Brücke zwischen dem Verkaufstrichter und dem Rest des Betriebs nutzen.

## Häufig gestellte Fragen

### Muss ich den öffentlichen Schlüssel bei allen Aufrufen verwenden?
Nein. Der öffentliche Schlüssel ist optional, aber wenn er im Header `X-Papo-Public-Key` gesendet wird, muss er zum selben Konto wie der geheime Schlüssel gehören.

### Woher weiß ich, welche Phasen in meinem Funnel existieren?
Listen Sie die Kanban-Funnels über die API auf. Die Antwort gibt die Phasen jedes Funnels mit ihren Identifikatoren zurück, die zum Erstellen oder Verschieben von Karten verwendet werden.

### Kann ich eine Karte erstellen, die bereits mit einem Kontakt verknüpft ist?
Ja. Die Kartenerstellung ermöglicht optional die Verknüpfung mit einem vorhandenen Kontakt, wodurch der Verlauf und die Kundendaten mit der Opportunity verknüpft bleiben.

### Ermöglicht die API die Aktualisierung des Werts einer Karte?
Die API bietet Schreiboperationen für Kanban-Karten. Die genauen Felder, die aktualisiert werden können, einschließlich Werte, sind in der offiziellen API-Dokumentation detailliert beschrieben.

### Ist es möglich, eine Karte über die API als gewonnen oder verloren zu markieren?
Ja. Die API ermöglicht das Markieren von Karten als gewonnen und verloren sowie das Auflisten aller gewonnenen Karten für Berichte und Dashboards.

### Muss ich programmieren oder kann ich Automatisierungstools verwenden?
Sie können jede Sprache mit HTTP-Unterstützung oder Automatisierungstools wie n8n verwenden und die Aufrufe in der gewünschten Reihenfolge ausführen.

## Lesen Sie auch

- [So verwenden Sie die Papo-API zum Massenerstellen und -aktualisieren von Kontakten](/hc/papo/articles/papo-api-kontakte-in-grossen-mengen-erstellen-aktualisieren)
- [So empfangen Sie Echtzeit-Ereignisse von Papo über Webhook (outbound)](/hc/papo/articles/echtzeit-events-von-papo-per-webhook-outbound-empfangen)

---

**[Kostenlos starten →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=papo-api-deals-kanban-erstellen-aktualisieren&utm_content=de)**

Der erste Benutzer ist kostenlos und erfordert keine Kreditkarte.