Skip to main content

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.
Add endpoint dialog with CloseCRM selected in the Integration dropdown
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 i webhook.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 emot emails 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 emot value 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_amount till affärsmöjlighetens value och dess faktureringsintervall till value_period.
  • Använd ID:n för att länka poster: spara Dodo Payments customer_id på Close-kontakten och Close lead-ID:t i Dodo Payments metadata.
  • Kontaktexemplet körs vid varje payment.succeeded, inklusive förnyelser och upprepade köp, så en återkommande kund skapar ytterligare en kontakt.

Felsökning

  • 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 401 kan Close förvänta sig Basic-autentisering. Justera headern Authorization under endpointens flik Advanced.
  • Öppna endpointens leveransförsök under fliken Logs i Developer → Webhooks för att se svaret från Close.
  • 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_.
Senast ändrad 26 september 2026