Skip to main content

परिचय

Close CRM integration, Dodo Payments events से Close में रिकॉर्ड बनाता है। सफल भुगतान से संपर्क बनाया जा सकता है और नए सब्सक्रिप्शन से अवसर बनाया जा सकता है, जिससे आपकी बिक्री टीम अपनी लीड के साथ राजस्व गतिविधि भी देख सकती है।
इस integration के लिए ऐसे Close API key की आवश्यकता होती है, जिसमें संपर्क और अवसर बनाने की अनुमति हो। Close में एक key बनाने के लिए Settings → Developer → API Keys पर जाएँ और New API Key पर क्लिक करें।

प्रारंभ करना

1

Open the Webhook Section

Dodo Payments डैशबोर्ड में, डेवलपर → Webhooks पर जाएँ और एंडपॉइंट जोड़ें पर क्लिक करें।
Integration ड्रॉपडाउन में CloseCRM चयनित होने वाला एंडपॉइंट जोड़ें डायलॉग
2

Select Close CRM

Integration में CloseCRM चुनें।
3

Enter API Key

API key में अपनी Close API key पेस्ट करें। Dodo Payments इसे हर delivery के header में Authorization के रूप में भेजता है।
4

Select Events

Subscribed events में वे events चुनें जिन्हें आपका transformation संभालता है। इस पेज के उदाहरण payment.succeeded और subscription.active का उपयोग करते हैं।
5

Configure Transformation

Transformation code के अंतर्गत, payment data को Close objects में map करने के लिए handler को संपादित करें। उदाहरणों से शुरुआत करें।
6

Test & Create

Test this code के अंतर्गत, sample payload के विरुद्ध handler चलाने के लिए Simulate पर क्लिक करें। फिर Create endpoint पर क्लिक करें।
7

Done

अब प्रत्येक subscribed event Close में एक रिकॉर्ड बनाता है।

Transformation Code के उदाहरण

प्रत्येक handler webhook.url को Close API endpoint पर सेट करता है और webhook.payload को request body से replace करता है। Close, custom.cf_<field_id> keys के माध्यम से custom fields सेट करता है, इसलिए उदाहरणों में मौजूद cf_ keys को अपने custom fields की IDs से replace करें। Dodo Payments की राशियाँ currency की सबसे छोटी इकाई में होती हैं, जैसे USD के लिए cents।

Payment से Contact बनाएँ

जब payment सफल हो जाए, तो एक contact बनाएँ। Close, emails और phones को objects की lists के रूप में स्वीकार करता है। यदि request में lead_id नहीं है, तो Close contact के नाम पर एक नया lead बनाता है।
create_contact.js

Subscription से Opportunity बनाएँ

जब कोई subscription active हो जाए, तो एक opportunity बनाएँ। Close, value को cents में integer के रूप में और value_period को one_time, monthly या annual के रूप में स्वीकार करता है, इसलिए उदाहरण subscription के payment_frequency_interval को एक period पर map करता है। lead_id एक Close lead ID होना चाहिए, Dodo Payments customer ID नहीं। उदाहरण इसे subscription के metadata से पढ़ता है, इसलिए subscription बनाते समय lead ID को वहाँ store करें। lead_id के बिना, Close एक नया, बिना नाम वाला lead बनाता है।
create_opportunity.js

सुझाव

  • Fields को map करने से पहले Close API documentation में field names और types जाँचें।
  • Payment से संबंधित data, जैसे amount और payment method, custom fields में store करें। पहले Close में fields बनाएँ, फिर उनकी IDs का उपयोग करें।
  • Subscription के recurring_pre_tax_amount को opportunity के value से और उसके billing interval को value_period से map करें।
  • Records को link करने के लिए IDs का उपयोग करें: Dodo Payments customer_id को Close contact पर store करें और Close lead ID को Dodo Payments metadata में store करें।
  • Contact example प्रत्येक payment.succeeded पर चलता है, जिसमें renewals और repeat purchases भी शामिल हैं, इसलिए लौटने वाला customer एक और contact बनाता है।

समस्या निवारण

  • सुनिश्चित करें कि API key में write permissions हों।
  • जाँचें कि आवश्यक fields शामिल हैं।
  • जाँचें कि प्रत्येक email address मान्य है।
  • Close API rate limits की समीक्षा करें।
  • यदि deliveries 401 के साथ विफल होती हैं, तो Close को Basic authentication की आवश्यकता हो सकती है। Endpoint के Advanced tab में Authorization header को समायोजित करें।
  • Close से response देखने के लिए Developer → Webhooks के Logs tab में endpoint के delivery attempts खोलें।
  • जाँचें कि payload Close API format से मेल खाता है।
  • जाँचें कि सभी आवश्यक fields मौजूद हैं।
  • जाँचें कि field names Close schema से बिल्कुल मेल खाते हैं और custom fields में custom.cf_ IDs का उपयोग होता है।
अंतिम संशोधन 26 सितंबर 2026