परिचय
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 पर जाएँ और एंडपॉइंट जोड़ें पर क्लिक करें।

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 के उदाहरण
प्रत्येक handlerwebhook.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 Paymentsmetadataमें store करें। - Contact example प्रत्येक
payment.succeededपर चलता है, जिसमें renewals और repeat purchases भी शामिल हैं, इसलिए लौटने वाला customer एक और contact बनाता है।
समस्या निवारण
Records Not Created in Close CRM
Records Not Created in Close CRM
- सुनिश्चित करें कि API key में write permissions हों।
- जाँचें कि आवश्यक fields शामिल हैं।
- जाँचें कि प्रत्येक email address मान्य है।
- Close API rate limits की समीक्षा करें।
- यदि deliveries
401के साथ विफल होती हैं, तो Close को Basic authentication की आवश्यकता हो सकती है। Endpoint के Advanced tab मेंAuthorizationheader को समायोजित करें। - Close से response देखने के लिए Developer → Webhooks के Logs tab में endpoint के delivery attempts खोलें।
Transformation Errors
Transformation Errors
- जाँचें कि payload Close API format से मेल खाता है।
- जाँचें कि सभी आवश्यक fields मौजूद हैं।
- जाँचें कि field names Close schema से बिल्कुल मेल खाते हैं और custom fields में
custom.cf_IDs का उपयोग होता है।