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.

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 setztwebhook.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 erwartetemails 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 erwartetvalue 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_amountdes Abonnementsvalueder Chance und dessen Abrechnungsintervallvalue_periodzu. - Verwenden Sie IDs, um Datensätze zu verknüpfen: Speichern Sie
customer_idvon Dodo Payments beim Close-Kontakt und die Close-Lead-ID inmetadatavon Dodo Payments. - Das Kontaktbeispiel wird bei jedem
payment.succeededausgeführt, einschließlich Verlängerungen und wiederholten Käufen. Daher erstellt ein wiederkehrender Kunde einen weiteren Kontakt.
Fehlerbehebung
Records Not Created in Close CRM
Records Not Created in Close CRM
- 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
401fehlschlagen, erwartet Close möglicherweise die Basic-Authentifizierung. Passen Sie denAuthorization-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.
Transformation Errors
Transformation Errors
- 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.