Customer.io

Introduction

L’intégration Customer.io envoie les événements Dodo Payments à la Track API de Customer.io, afin que les paiements et les modifications d’abonnement puissent déclencher des campagnes et des parcours client. Par exemple, un nouveau client peut recevoir un e-mail de bienvenue, une modification d’abonnement peut envoyer une mise à jour et un paiement échoué peut envoyer une notification.

Cette intégration nécessite votre Customer.io Site ID et votre clé API. La Track API utilise l’authentification HTTP Basic, avec le Site ID comme nom d’utilisateur et la clé API comme mot de passe.

Prise en main

Open the Webhook Section

Dans le dashboard Dodo Payments, accédez à Developer → Webhooks et cliquez sur Add endpoint.

Add endpoint dialog with CustomerIO selected in the Integration dropdown

Select Customer.io

Dans Integration, sélectionnez CustomerIO.

Enter Credentials

Dans API key, collez votre clé API Customer.io. Dodo Payments envoie la clé dans l’en-tête Authorization sous forme de bearer token.La Track API attend une authentification Basic. Si les livraisons échouent avec un 401, ouvrez l’onglet Advanced de l’endpoint et remplacez l’en-tête Authorization par Basic suivi de l’encodage Base64 de site_id:api_key.

Select Events

Dans Subscribed events, sélectionnez les événements gérés par votre transformation. Les exemples de cette page utilisent payment.succeeded, subscription.active et subscription.cancelled.

Configure Transformation

Dans Transformation code, modifiez le gestionnaire pour formater les événements destinés à la Track API de Customer.io. Commencez par les exemples.

Test & Create

Dans Test this code, cliquez sur Simulate pour exécuter le gestionnaire avec un exemple de payload. Cliquez ensuite sur Create endpoint.

Done

Les événements auxquels vous êtes abonné parviennent désormais à Customer.io, où ils peuvent déclencher vos automatisations e-mail.

Exemples de code de transformation

Chaque gestionnaire envoie une requête à l’endpoint Track API v2 entity et identifie la personne à l’aide de l’customer_id Dodo Payments. Pour enregistrer un événement, la requête définit action sur event et place le nom de l’événement dans name. Pour mettre à jour les attributs d’une personne, elle définit action sur identify. Les montants Dodo Payments sont exprimés dans la plus petite unité monétaire, c’est pourquoi les exemples les divisent par 100.

Suivre les événements de paiement

Enregistrez un événement payment_completed lorsqu’un paiement est réussi :

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;
}

Suivre le cycle de vie d’un abonnement

Enregistrez un événement subscription_started lorsqu’un abonnement devient actif et un événement subscription_cancelled lorsqu’il est annulé :

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;
}

Suivre les attributs client

Mettez à jour les attributs du profil de la personne lorsqu’un paiement est réussi. Chaque requête identify remplace les attributs qu’elle envoie. last_payment_amount et last_payment_date contiennent donc toujours les informations du dernier paiement.

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;
}

Conseils

Utilisez les mêmes noms d’événements dans la transformation et dans les déclencheurs de vos campagnes Customer.io, par exemple payment_completed. Choisissez des noms qui décrivent ce qui s’est produit.
Incluez les attributs utilisés par vos messages pour la personnalisation.
Identifiez chaque personne avec le même ID dans toutes les requêtes. Les exemples utilisent l’customer_id Dodo Payments.
Pour connaître tous les champs de requête, consultez la référence de la Customer.io Track API.

Résolution des problèmes

Events Not Triggering Campaigns

Vérifiez que le Site ID et la clé API sont corrects.
Si les livraisons échouent avec un 401, définissez l’en-tête Authorization sur l’authentification Basic, comme indiqué dans Premiers pas.
Vérifiez que les noms d’événements correspondent aux déclencheurs de vos campagnes Customer.io.
Vérifiez que les identifiants client sont définis.
Consultez les limites de débit de l’API Customer.io.

Transformation Errors

Vérifiez que le payload respecte le format de l’API Customer.io.
Vérifiez que tous les champs obligatoires sont présents et que action correspond à une action prise en charge par la Track API, telle que event ou identify.
Vérifiez que les noms d’événements et les attributs sont correctement formatés.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduction

Prise en main

Exemples de code de transformation

Suivre les événements de paiement

Suivre le cycle de vie d’un abonnement

Suivre les attributs client

Conseils

Résolution des problèmes

​Introduction

​Prise en main

​Exemples de code de transformation

​Suivre les événements de paiement

​Suivre le cycle de vie d’un abonnement

​Suivre les attributs client

​Conseils

​Résolution des problèmes

Introduction

Prise en main

Exemples de code de transformation

Suivre les événements de paiement

Suivre le cycle de vie d’un abonnement

Suivre les attributs client

Conseils

Résolution des problèmes