Skip to main content

Einführung

Die Close CRM-Integration erstellt aus Dodo Payments-Ereignissen Datensätze in Close. Eine erfolgreiche Zahlung kann einen Kontakt erstellen, und ein neues Abonnement kann eine Chance erstellen, sodass Ihr Vertriebsteam Umsatzaktivitäten neben seinen Leads sieht.
Diese Integration erfordert einen Close API key mit der Berechtigung, Kontakte und Chancen zu erstellen. Um einen in Close zu erstellen, gehen Sie zu Settings → Developer → API Keys und klicken Sie auf New API Key.

Erste Schritte

1

Open the Webhook Section

Gehen Sie im Dodo Payments-Dashboard zu Developer → Webhooks und klicken Sie auf Add endpoint.
Add endpoint dialog with CloseCRM selected in the Integration dropdown
2

Select Close CRM

Wählen Sie unter Integration die Option CloseCRM aus.
3

Enter API Key

Fügen Sie unter API key Ihren Close API key ein. Dodo Payments sendet ihn im Authorization-Header jeder Zustellung.
4

Select Events

Wählen Sie unter Subscribed events die Ereignisse aus, die Ihre Transformation verarbeitet. Die Beispiele auf dieser Seite verwenden payment.succeeded und subscription.active.
5

Configure Transformation

Bearbeiten Sie unter Transformation code den Handler, um Zahlungsdaten Close-Objekten zuzuordnen. Beginnen Sie mit den Beispielen.
6

Test & Create

Klicken Sie unter Test this code auf Simulate, um den Handler mit einem Beispiel-Payload auszuführen. Klicken Sie anschließend auf Create endpoint.
7

Done

Jedes abonnierte Ereignis erstellt nun einen Datensatz in Close.

Beispiele für Transformationscode

Jeder Handler setzt webhook.url auf einen Close API-Endpunkt und ersetzt webhook.payload durch den Request-Body. Close legt benutzerdefinierte Felder über custom.cf_<field_id>-Schlüssel fest. Ersetzen Sie daher die cf_-Schlüssel in den Beispielen durch die IDs Ihrer eigenen benutzerdefinierten Felder. Dodo Payments-Beträge werden in der kleinsten Währungseinheit angegeben, zum Beispiel in Cent für USD.

Kontakt aus Zahlung erstellen

Wenn eine Zahlung erfolgreich ist, erstellen Sie einen Kontakt. Close erwartet emails und phones als Listen von Objekten. Wenn der Request kein lead_id enthält, erstellt Close einen neuen Lead mit dem Namen des Kontakts.
create_contact.js

Chance aus Abonnement erstellen

Wenn ein Abonnement aktiv wird, erstellen Sie eine Chance. Close erwartet value als Ganzzahl in Cent und value_period als one_time, monthly oder annual. Daher ordnet das Beispiel payment_frequency_interval des Abonnements einem Zeitraum zu. lead_id muss eine Close-Lead-ID und darf keine Dodo Payments-Kunden-ID sein. Das Beispiel liest sie aus dem metadata des Abonnements. Speichern Sie die Lead-ID dort, wenn Sie das Abonnement erstellen. Ohne ein lead_id erstellt Close einen neuen Lead ohne Titel.
create_opportunity.js

Tipps

  • Prüfen Sie die Feldnamen und -typen in der Close API-Dokumentation, bevor Sie Felder zuordnen.
  • Speichern Sie zahlungsspezifische Daten wie Betrag und Zahlungsmethode in benutzerdefinierten Feldern. Erstellen Sie die Felder zuerst in Close und verwenden Sie anschließend deren IDs.
  • Ordnen Sie recurring_pre_tax_amount des Abonnements value der Chance und dessen Abrechnungsintervall value_period zu.
  • Verwenden Sie IDs, um Datensätze zu verknüpfen: Speichern Sie customer_id von Dodo Payments beim Close-Kontakt und die Close-Lead-ID in metadata von Dodo Payments.
  • Das Kontaktbeispiel wird bei jedem payment.succeeded ausgeführt, einschließlich Verlängerungen und wiederholten Käufen. Daher erstellt ein wiederkehrender Kunde einen weiteren Kontakt.

Fehlerbehebung

  • Stellen Sie sicher, dass der API key über Schreibberechtigungen verfügt.
  • Prüfen Sie, ob die erforderlichen Felder enthalten sind.
  • Prüfen Sie, ob jede E-Mail-Adresse gültig ist.
  • Überprüfen Sie die Close API-Ratenlimits.
  • Wenn Zustellungen mit einem 401 fehlschlagen, erwartet Close möglicherweise die Basic-Authentifizierung. Passen Sie den Authorization-Header auf der Registerkarte Advanced des Endpunkts an.
  • Öffnen Sie die Zustellversuche des Endpunkts auf der Registerkarte Logs unter Developer → Webhooks, um die Antwort von Close anzuzeigen.
  • Prüfen Sie, ob das Payload dem Close API-Format entspricht.
  • Prüfen Sie, ob alle erforderlichen Felder vorhanden sind.
  • Prüfen Sie, ob die Feldnamen exakt dem Close-Schema entsprechen und benutzerdefinierte Felder die custom.cf_-IDs verwenden.
Zuletzt geändert am 26. September 2026