AutoSend

Introduction

L’intégration AutoSend envoie un e-mail via l’API e-mail d’AutoSend chaque fois qu’un événement Dodo Payments se produit, des paiements réussis aux tentatives de paiement échouées et aux confirmations de remboursement. Une transformation sur le point de terminaison webhook convertit chaque événement en requête d’envoi AutoSend. Pour la configurer, vous avez besoin d’une clé API AutoSend et d’un domaine d’expéditeur vérifié dans AutoSend. Vous trouverez votre clé API dans le tableau de bord AutoSend, sous Settings → API Keys.

Premiers pas

Suivez ces étapes pour connecter AutoSend à Dodo Payments :

Open Webhook Section

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

Boîte de dialogue d'ajout d'un endpoint avec AutoSend sélectionné dans la liste déroulante Intégration

Select AutoSend Integration

Dans Intégration, sélectionnez Autosend.

Enter API Key

Dans Clé API, collez votre clé API AutoSend. Dodo Payments l’envoie dans l’en-tête Authorization de chaque livraison.

Learn how to create and manage API keys

Consultez la documentation AutoSend pour savoir comment créer et gérer les clés API.

Select Events

Dans Événements abonnés, sélectionnez les événements gérés par votre transformation, tels que payment.succeeded, subscription.active et payment.failed. Un endpoint sans événement sélectionné reçoit tous les types d’événements.

Configure Transformation

Sous Code de transformation, écrivez le gestionnaire JavaScript qui crée l’e-mail pour chaque événement. Commencez avec les exemples de code.

Test & Create

Sous Tester ce code, cliquez sur Simuler pour exécuter le gestionnaire avec un payload d’exemple et vérifier le résultat. Cliquez ensuite sur Créer l’endpoint.

Activation Complete

L’endpoint envoie un e-mail via AutoSend chaque fois qu’un événement auquel vous êtes abonné se produit.

Exemples de code

Chaque gestionnaire vérifie le type d’événement dans webhook.eventType et lit les données de l’événement depuis webhook.payload.data. Il définit webhook.url sur l’endpoint d’envoi d’AutoSend et remplace webhook.payload par la requête d’e-mail. Les montants Dodo Payments, tels que total_amount, sont exprimés dans la plus petite unité monétaire, par exemple en centimes pour l’USD.

E-mail de confirmation de paiement

Envoyez un e-mail de confirmation lorsqu’un paiement est réussi (payment.succeeded) :

payment_confirmation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "payments@mail.yourdomain.com",
        name: "Your Company",
      },
      subject: "Payment Successful - Thank you for your purchase!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.total_amount,
        currency: p.currency,
        paymentId: p.payment_id,
        paymentDate: new Date(p.created_at).toLocaleDateString(),
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

E-mail de bienvenue pour un abonnement

Envoyez un e-mail de bienvenue lorsqu’un abonnement devient actif (subscription.active). L’exemple transmet product_id en tant que planName. Si votre modèle affiche le nom du plan, associez d’abord l’ID à un nom lisible.

subscription_welcome.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: s.customer.email,
        name: s.customer.name,
      },
      from: {
        email: "subscriptions@mail.yourdomain.com",
        name: "Your Company",
      },
      subject: "Welcome to your subscription!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: s.customer.name,
        planName: s.product_id,
        billingInterval: s.payment_frequency_interval,
        nextBillingDate: new Date(s.next_billing_date).toLocaleDateString(),
        subscriptionId: s.subscription_id,
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

Notification d’échec de paiement

Envoyez un e-mail de notification lorsqu’un paiement échoue (payment.failed). Le champ error_message du paiement contient la raison de l’échec.

payment_failure.js

function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "billing@mail.yourdomain.com",
        name: "Your Company Billing",
      },
      subject: "Payment Failed - Action Required",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.total_amount,
        currency: p.currency,
        failureReason: p.error_message,
        paymentId: p.payment_id,
        retryUrl: `https://yourdomain.com/billing/retry/${p.payment_id}`,
      },
      replyTo: {
        email: "billing@yourdomain.com",
        name: "Billing Support",
      },
    };
  }
  return webhook;
}

Bonnes pratiques

Vérifiez votre domaine d’expéditeur : AutoSend envoie uniquement des e-mails depuis un domaine vérifié. Vérifiez donc le domaine de votre adresse from dans AutoSend avant de créer l’endpoint. Un domaine vérifié améliore également la délivrabilité et contribue à éviter que vos e-mails n’arrivent dans les dossiers de spam.
Utilisez des données dynamiques pour la personnalisation : transmettez les valeurs propres au client, comme les noms, les montants des paiements et les détails des abonnements, dans le champ dynamicData, puis référencez-les comme variables dans votre modèle AutoSend.
Rédigez des objets clairs : rédigez des objets qui indiquent clairement le but de l’e-mail. Évitez les mots qui déclenchent les filtres anti-spam et limitez les objets à 50 caractères.
Testez avant la mise en production : exécutez chaque gestionnaire avec Tester ce code, puis envoyez un e-mail de test avant la mise en ligne. Vérifiez que le contenu s’affiche correctement et que chaque valeur dynamicData est associée.

Référence API

Pour connaître tous les paramètres et codes d’erreur de l’endpoint d’envoi, consultez la documentation de l’API AutoSend.

Résolution des problèmes

Emails Not Being Sent

Vérifiez que la clé API est correcte et active.
Vérifiez que le domaine d’expéditeur est vérifié dans AutoSend.
Vérifiez que les adresses e-mail des destinataires sont valides.
Consultez les limites et quotas d’envoi d’AutoSend.
Vérifiez que la transformation définit l’URL de l’endpoint d’envoi : https://api.autosend.com/v1/mails/send.
Vérifiez que le payload contient tous les paramètres requis.
Ouvrez les tentatives de livraison de l’endpoint dans l’onglet Journaux de Développeur → Webhooks pour voir le code de réponse d’AutoSend.

Transformation Errors

Vérifiez que le payload respecte le format de l’API AutoSend.
Vérifiez que tous les champs requis sont présents : to, from et soit templateId, soit html/text. Sans templateId, subject est également requis.
Vérifiez que les adresses e-mail sont correctement formatées.
Si vous utilisez un modèle, vérifiez que templateId est valide.
Vérifiez que les clés dynamicData correspondent aux variables de votre modèle.

Template Issues

Vérifiez que l’ID de votre modèle est correct et que le modèle est actif dans AutoSend.
Vérifiez que les clés dynamicData correspondent aux variables de votre modèle.
Vérifiez que chaque variable de modèle requise possède une valeur.
Testez le modèle séparément dans le tableau de bord AutoSend.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduction

Premiers pas

Learn how to create and manage API keys

Exemples de code

E-mail de confirmation de paiement

E-mail de bienvenue pour un abonnement

Notification d’échec de paiement

Bonnes pratiques

Référence API

Résolution des problèmes

​Introduction

​Premiers pas

Learn how to create and manage API keys

​Exemples de code

​E-mail de confirmation de paiement

​E-mail de bienvenue pour un abonnement

​Notification d’échec de paiement

​Bonnes pratiques

​Référence API

​Résolution des problèmes

Introduction

Premiers pas

Exemples de code

E-mail de confirmation de paiement

E-mail de bienvenue pour un abonnement

Notification d’échec de paiement

Bonnes pratiques

Référence API

Résolution des problèmes