> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> Dodo Payments घटनाओं से HubSpot में संपर्क, कंपनियों और सौदों को स्वचालित रूप से बनाएं और अपडेट करें।

## परिचय

अपने भुगतान डेटा को सीधे HubSpot CRM में समन्वयित करें। सफल भुगतानों से संपर्क बनाएं, सदस्यता जीवनचक्र को ट्रैक करें, और व्यापक ग्राहक प्रोफाइल बनाएं—सभी स्वचालित रूप से Dodo Payments घटनाओं द्वारा ट्रिगर किए गए।

<Info>
  इस इंटीग्रेशन को OAuth स्कोप्स और API अनुमतियों को कॉन्फ़िगर करने के लिए HubSpot एडमिन एक्सेस की आवश्यकता होती है।
</Info>

## प्रारंभ करना

<Steps>
  <Step title="Open the Webhook Section">
    अपने Dodo Payments डैशबोर्ड में, <b>Webhooks → + Add Endpoint</b> पर जाएँ और इंटीग्रेशन ड्रॉपडाउन को विस्तृत करें।

    <Frame>
      <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/hubspot.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=73c4881df63edfb05bd24d804f01caab" alt="Add Endpoint and integrations dropdown" style={{ maxHeight: '500px', width: 'auto' }} width="1724" height="942" data-path="images/integrations/hubspot.png" />
    </Frame>
  </Step>

  <Step title="Select HubSpot">
    <b>HubSpot</b> इंटीग्रेशन कार्ड चुनें।
  </Step>

  <Step title="Connect HubSpot">
    <b>Connect to HubSpot</b> पर क्लिक करें और आवश्यक OAuth स्कोप्स को अधिकृत करें।
  </Step>

  <Step title="Configure Transformation">
    HubSpot CRM ऑब्जेक्ट्स के साथ भुगतान डेटा मैप करने के लिए ट्रांसफ़ॉर्मेशन कोड को एडिट करें।
  </Step>

  <Step title="Test & Create">
    सैम्पल पेलोड्स के साथ टेस्ट करें और सिंक सक्रिय करने के लिए <b>Create</b> पर क्लिक करें।
  </Step>

  <Step title="Done!">
    🎉 भुगतान इवेंट अब स्वचालित रूप से आपके HubSpot CRM में रिकॉर्ड बनाएँगे/अपडेट करेंगे।
  </Step>
</Steps>

## परिवर्तन कोड उदाहरण

### भुगतान से संपर्क बनाएं

```javascript create_contact.js icon="js" expandable theme={null}
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.hubapi.com/crm/v3/objects/contacts";
    webhook.payload = {
      properties: {
        email: p.customer.email,
        firstname: p.customer.name.split(' ')[0] || '',
        lastname: p.customer.name.split(' ').slice(1).join(' ') || '',
        phone: p.customer.phone || '',
        company: p.customer.company || '',
        amount: (p.total_amount / 100).toString(),
        payment_method: p.payment_method || '',
        currency: p.currency || 'USD'
      }
    };
  }
  return webhook;
}
```

### सदस्यता के साथ संपर्क अपडेट करें

```javascript update_contact.js icon="js" expandable theme={null}
function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = `https://api.hubapi.com/crm/v3/objects/contacts/${s.customer.customer_id}`;
    webhook.method = "PATCH";
    webhook.payload = {
      properties: {
        subscription_status: "active",
        subscription_amount: (s.recurring_pre_tax_amount / 100).toString(),
        subscription_frequency: s.payment_frequency_interval,
        next_billing_date: s.next_billing_date,
        product_id: s.product_id
      }
    };
  }
  return webhook;
}
```

### भुगतान से सौदा बनाएं

```javascript create_deal.js icon="js" expandable theme={null}
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.hubapi.com/crm/v3/objects/deals";
    webhook.payload = {
      properties: {
        dealname: `Payment - ${p.customer.email}`,
        amount: (p.total_amount / 100).toString(),
        dealstage: "closedwon",
        closedate: new Date().toISOString(),
        hs_currency: p.currency || "USD"
      },
      associations: [
        {
          to: {
            id: p.customer.customer_id
          },
          types: [
            {
              associationCategory: "HUBSPOT_DEFINED",
              associationTypeId: 3
            }
          ]
        }
      ]
    };
  }
  return webhook;
}
```

## सुझाव

* वस्तु निर्माण का परीक्षण करने के लिए HubSpot के API एक्सप्लोरर का उपयोग करें
* भुगतान राशियों को HubSpot मुद्रा क्षेत्रों से मैप करें
* उचित संघों के लिए ग्राहक आईडी शामिल करें
* भुगतान स्थिति के आधार पर उचित सौदा चरण सेट करें

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

<AccordionGroup>
  <Accordion title="Records not created in HubSpot">
    * OAuth स्कोप्स में लिखने की अनुमतियाँ शामिल हैं या नहीं, इसकी जाँच करें
    * सुनिश्चित करें कि आवश्यक HubSpot प्रॉपर्टीज मौजूद हैं
    * ग्राहक ईमेल मान्य और अद्वितीय है यह सुनिश्चित करें
    * HubSpot API रेट सीमाओं की समीक्षा करें
  </Accordion>

  <Accordion title="Transformation errors">
    * JSON संरचना की HubSpot API प्रारूप से मेल खाती है या नहीं, यह सत्यापित करें
    * सुनिश्चित करें कि सभी आवश्यक प्रॉपर्टीज शामिल हैं
    * प्रॉपर्टी नाम HubSpot फ़ील्ड नामों के बिल्कुल समान होना चाहिए
  </Accordion>
</AccordionGroup>
