Introduktion
Close CRM-integrationen skapar poster i Close från händelser i Dodo Payments. En lyckad betalning kan skapa en kontakt och en ny prenumeration kan skapa en affärsmöjlighet, så att ditt säljteam ser intäktsaktivitet bredvid sina leads.Den här integrationen kräver en Close API-nyckel med behörighet att skapa kontakter och affärsmöjligheter. Om du vill skapa en i Close går du till Settings → Developer → API Keys och klickar på New API Key.
Komma igång
1
Open the Webhook Section
Gå till Developer → Webhooks i Dodo Payments-dashboarden och klicka på Add endpoint.

2
Select Close CRM
Välj CloseCRM under Integration.
3
Enter API Key
Klistra in din Close API-nyckel under API key. Dodo Payments skickar den i headern
Authorization vid varje leverans.4
Select Events
Välj de händelser som din transformation hanterar under Subscribed events. Exemplen på den här sidan använder
payment.succeeded och subscription.active.5
Configure Transformation
Redigera hanteraren under Transformation code så att betalningsdata mappas till Close-objekt. Börja med exemplen.
6
Test & Create
Klicka på Simulate under Test this code för att köra hanteraren mot ett exempelpayload. Klicka sedan på Create endpoint.
7
Done
Varje prenumererad händelse skapar nu en post i Close.
Exempel på transformationskod
Varje hanterare anger en Close API-endpoint iwebhook.url och ersätter webhook.payload med request body. Close anger anpassade fält via nycklarna custom.cf_<field_id>, så ersätt nycklarna cf_ i exemplen med ID:na för dina egna anpassade fält. Belopp i Dodo Payments anges i den minsta valutaenheten, till exempel cent för USD.
Skapa kontakt från betalning
När en betalning lyckas skapar du en kontakt. Close tar emotemails och phones som listor med objekt. Om request saknar lead_id skapar Close ett nytt lead med kontaktens namn.
create_contact.js
Skapa affärsmöjlighet från prenumeration
När en prenumeration blir aktiv skapar du en affärsmöjlighet. Close tar emotvalue som ett heltal i cent och value_period som one_time, monthly eller annual, så exemplet mappar prenumerationens payment_frequency_interval till en period. lead_id måste vara ett Close lead-ID, inte ett kund-ID i Dodo Payments. Exemplet läser det från prenumerationens metadata, så spara lead-ID:t där när du skapar prenumerationen. Utan ett lead_id skapar Close ett nytt namnlöst lead.
create_opportunity.js
Tips
- Kontrollera fältnamn och typer i Close API-dokumentationen innan du mappar fält.
- Spara betalningsspecifika data, till exempel belopp och betalningsmetod, i anpassade fält. Skapa fälten i Close först och använd sedan deras ID:n.
- Mappa prenumerationens
recurring_pre_tax_amounttill affärsmöjlighetensvalueoch dess faktureringsintervall tillvalue_period. - Använd ID:n för att länka poster: spara Dodo Payments
customer_idpå Close-kontakten och Close lead-ID:t i Dodo Paymentsmetadata. - Kontaktexemplet körs vid varje
payment.succeeded, inklusive förnyelser och upprepade köp, så en återkommande kund skapar ytterligare en kontakt.
Felsökning
Records Not Created in Close CRM
Records Not Created in Close CRM
- Kontrollera att API-nyckeln har skrivbehörighet.
- Kontrollera att de obligatoriska fälten finns med.
- Kontrollera att varje e-postadress är giltig.
- Läs mer om Close API:s rate limits.
- Om leveranser misslyckas med en
401kan Close förvänta sig Basic-autentisering. Justera headernAuthorizationunder endpointens flik Advanced. - Öppna endpointens leveransförsök under fliken Logs i Developer → Webhooks för att se svaret från Close.
Transformation Errors
Transformation Errors
- Kontrollera att payloaden följer Close API-formatet.
- Kontrollera att alla obligatoriska fält finns med.
- Kontrollera att fältnamnen exakt överensstämmer med Close-schemat och att anpassade fält använder ID:n från
custom.cf_.