Vai al contenuto principale

​
Introduzione

Sincronizza i tuoi dati di pagamento direttamente con HubSpot CRM. Crea contatti da pagamenti riusciti, monitora il ciclo di vita degli abbonamenti e costruisci profili clienti completi—tutto attivato automaticamente dagli eventi di Dodo Payments.
Questa integrazione richiede l’accesso admin a HubSpot per configurare gli ambiti OAuth e le autorizzazioni API.

​
Iniziare

1

Open the Webhook Section

Nel tuo cruscotto Dodo Payments, vai su Webhooks → + Add Endpoint e espandi il menu a discesa delle integrazioni.
Add Endpoint and integrations dropdown
2

Select HubSpot

Scegli la scheda integrazione HubSpot.
3

Connect HubSpot

Fai clic su Connect to HubSpot e autorizza gli ambiti OAuth richiesti.
4

Configure Transformation

Modifica il codice di trasformazione per mappare i dati di pagamento agli oggetti CRM di HubSpot.
5

Test & Create

Testa con payload di esempio e fai clic su Create per attivare la sincronizzazione.
6

Done!

🎉 Gli eventi di pagamento ora creeranno/aggiorneranno automaticamente i record nel tuo CRM HubSpot.

​
Esempi di Codice di Trasformazione

​
Crea Contatto da Pagamento

create_contact.js
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;
}

​
Aggiorna Contatto con Abbonamento

update_contact.js
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;
}

​
Crea Affare da Pagamento

create_deal.js
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;
}

​
Suggerimenti

  • Usa l’esploratore API di HubSpot per testare la creazione di oggetti
  • Mappa gli importi di pagamento ai campi di valuta di HubSpot
  • Includi gli ID cliente per associazioni corrette
  • Imposta le fasi di affare appropriate in base allo stato del pagamento

​
Risoluzione dei Problemi

  • Verifica che gli ambiti OAuth includano autorizzazioni di scrittura
  • Controlla che le proprietà richieste esistano in HubSpot
  • Assicurati che l’email del cliente sia valida e univoca
  • Esamina i limiti di velocità dell’API HubSpot
  • Convalida che la struttura JSON corrisponda al formato dell’API HubSpot
  • Controlla che tutte le proprietà richieste siano incluse
  • Assicurati che i nomi delle proprietà corrispondano esattamente ai campi HubSpot