Customer.io

Pendahuluan

Integrasi Customer.io mengirim event Dodo Payments ke Track API milik Customer.io, sehingga pembayaran dan perubahan subscription dapat memicu kampanye dan customer journey. Misalnya, customer baru dapat menerima email sambutan, perubahan subscription dapat mengirim pembaruan, dan pembayaran yang gagal dapat mengirim pemberitahuan.

Integrasi ini memerlukan Site ID dan API key Customer.io Anda. Track API menggunakan autentikasi HTTP Basic, dengan Site ID sebagai username dan API key sebagai password.

Memulai

Open the Webhook Section

Di dashboard Dodo Payments, buka Developer → Webhooks dan klik Add endpoint.

Add endpoint dialog with CustomerIO selected in the Integration dropdown

Select Customer.io

Di Integration, pilih CustomerIO.

Enter Credentials

Di API key, tempel API key Customer.io Anda. Dodo Payments mengirim key tersebut di header Authorization sebagai bearer token.Track API mengharapkan autentikasi Basic. Jika pengiriman gagal dengan 401, buka tab Advanced endpoint tersebut dan ganti header Authorization dengan Basic yang diikuti encoding Base64 dari site_id:api_key.

Select Events

Di Subscribed events, pilih event yang ditangani oleh transformation Anda. Contoh di halaman ini menggunakan payment.succeeded, subscription.active, dan subscription.cancelled.

Configure Transformation

Di bawah Transformation code, edit handler untuk memformat event untuk Track API Customer.io. Mulai dari contoh.

Test & Create

Di bawah Test this code, klik Simulate untuk menjalankan handler terhadap sample payload. Lalu klik Create endpoint.

Done

Event yang telah dipilih kini sampai ke Customer.io, tempat event tersebut dapat memicu automasi email Anda.

Contoh Transformation Code

Setiap handler mengirim satu request ke endpoint Track API v2 entity dan mengidentifikasi orang tersebut berdasarkan customer_id Dodo Payments mereka. Untuk mencatat event, request menetapkan action ke event dan menempatkan nama event di name. Untuk memperbarui atribut seseorang, request menetapkan action ke identify. Jumlah Dodo Payments menggunakan unit mata uang terkecil, sehingga contoh-contoh ini membaginya dengan 100.

Melacak Event Pembayaran

Catat event payment_completed saat pembayaran berhasil:

track_payments.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://track.customer.io/api/v2/entity";
    webhook.payload = {
      type: "person",
      identifiers: {
        id: p.customer.customer_id
      },
      action: "event",
      name: "payment_completed",
      attributes: {
        email: p.customer.email,
        name: p.customer.name,
        payment_amount: (p.total_amount / 100).toFixed(2),
        payment_method: p.payment_method || "unknown",
        payment_id: p.payment_id,
        currency: p.currency || "USD"
      }
    };
  }
  return webhook;
}

Melacak Siklus Hidup Subscription

Catat event subscription_started saat subscription menjadi aktif, dan event subscription_cancelled saat subscription dibatalkan:

track_subscriptions.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.url = "https://track.customer.io/api/v2/entity";
      webhook.payload = {
        type: "person",
        identifiers: {
          id: s.customer.customer_id
        },
        action: "event",
        name: "subscription_started",
        attributes: {
          email: s.customer.email,
          subscription_id: s.subscription_id,
          product_id: s.product_id,
          amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
          frequency: s.payment_frequency_interval,
          next_billing: s.next_billing_date
        }
      };
      break;
    case "subscription.cancelled":
      webhook.url = "https://track.customer.io/api/v2/entity";
      webhook.payload = {
        type: "person",
        identifiers: {
          id: s.customer.customer_id
        },
        action: "event",
        name: "subscription_cancelled",
        attributes: {
          email: s.customer.email,
          subscription_id: s.subscription_id,
          cancelled_at: s.cancelled_at,
          cancel_at_next_billing: s.cancel_at_next_billing_date
        }
      };
      break;
  }
  return webhook;
}

Melacak Atribut Customer

Perbarui atribut profil orang tersebut saat pembayaran berhasil. Setiap request identify menimpa atribut yang dikirimkannya, sehingga last_payment_amount dan last_payment_date selalu berisi pembayaran terbaru.

track_attributes.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://track.customer.io/api/v2/entity";
    webhook.payload = {
      type: "person",
      identifiers: {
        id: p.customer.customer_id
      },
      action: "identify",
      name: "Customer Identified",
      attributes: {
        email: p.customer.email,
        name: p.customer.name,
        last_payment_amount: (p.total_amount / 100).toFixed(2),
        payment_method: p.payment_method || "unknown",
        last_payment_date: webhook.payload.timestamp
      }
    };
  }
  return webhook;
}

Tips

Gunakan nama event yang sama dalam transformation dan pemicu kampanye Customer.io Anda, misalnya payment_completed. Pilih nama yang menjelaskan apa yang terjadi.
Sertakan atribut yang digunakan pesan Anda untuk personalisasi.
Identifikasi setiap orang dengan ID yang sama dalam setiap request. Contoh-contoh ini menggunakan customer_id Dodo Payments.
Untuk setiap field request, lihat referensi Customer.io Track API.

Pemecahan Masalah

Events Not Triggering Campaigns

Pastikan Site ID dan API key sudah benar.
Jika pengiriman gagal dengan 401, tetapkan header Authorization ke autentikasi Basic, seperti yang dijelaskan di Memulai.
Periksa apakah nama event cocok dengan pemicu kampanye Customer.io Anda.
Periksa apakah identifier customer telah ditetapkan.
Tinjau batas laju API Customer.io.

Transformation Errors

Periksa apakah payload sesuai dengan format API Customer.io.
Periksa apakah semua field wajib tersedia dan action merupakan action yang didukung Track API, seperti event atau identify.
Periksa apakah nama event dan atribut diformat dengan benar.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Memulai

Contoh Transformation Code

Melacak Event Pembayaran

Melacak Siklus Hidup Subscription

Melacak Atribut Customer

Tips

Pemecahan Masalah

​Pendahuluan

​Memulai

​Contoh Transformation Code

​Melacak Event Pembayaran

​Melacak Siklus Hidup Subscription

​Melacak Atribut Customer

​Tips

​Pemecahan Masalah

Pendahuluan

Memulai

Contoh Transformation Code

Melacak Event Pembayaran

Melacak Siklus Hidup Subscription

Melacak Atribut Customer

Tips

Pemecahan Masalah