Passer au contenu principal

Introduction

L’intégration d’AutoSend et de Dodo Payments vous permet d’envoyer automatiquement des notifications par email en temps réel pour tous les événements de paiement, des transactions réussies aux tentatives échouées et aux confirmations de remboursement. Envoyez des emails transactionnels pour les événements de paiement en utilisant la puissante API email d’AutoSend.
Cette intégration nécessite votre clé API AutoSend pour l’authentification. Vous pouvez trouver votre clé API dans le tableau de bord AutoSend sous Paramètres > Clés API.

Prise en main

Suivez ces étapes pour intégrer AutoSend avec Dodo Payments :
1

Ouvrir la section Webhook

Accédez à la section Webhooks dans votre tableau de bord Dodo Payments.
Ajouter un point de terminaison et le menu déroulant des intégrations
2

Sélectionner l'intégration AutoSend

Choisissez AutoSend dans la liste des intégrations disponibles.
3

Entrer la clé API

Fournissez votre clé API AutoSend pour l’authentification. Vous pouvez trouver votre clé API dans le tableau de bord AutoSend sous Paramètres > Clés API.

Apprenez à créer et gérer des clés API

Visitez la documentation d’AutoSend pour des instructions détaillées sur la création et la gestion des clés API.
4

Configurer la transformation

Configurez des gestionnaires de transformation JavaScript pour personnaliser le contenu des emails en fonction des événements de paiement.
5

Tester et créer

Testez votre configuration de webhook pour vous assurer que les emails sont envoyés correctement, puis créez l’intégration.
6

Activation terminée

🎉 Votre intégration AutoSend est maintenant active et enverra automatiquement des emails pour les événements de paiement configurés.

Exemples de code

Email de confirmation de paiement

Envoyez un email de confirmation lorsqu’un paiement est traité avec succès :
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: "[email protected]",
        name: "Your Company",
      },
      subject: "Payment Successful - Thank you for your purchase!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.amount,
        currency: p.currency,
        paymentId: p.payment_id,
        paymentDate: new Date(p.created_at).toLocaleDateString(),
      },
      replyTo: {
        email: "[email protected]",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

Email de bienvenue pour l’abonnement

Envoyez un email de bienvenue lorsqu’un nouvel abonnement est créé :
subscription_welcome.js
function handler(webhook) {
  if (webhook.eventType === "subscription.created") {
    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: "[email protected]",
        name: "Your Company",
      },
      subject: "Welcome to your subscription!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: s.customer.name,
        planName: s.plan.name,
        billingInterval: s.billing_interval,
        nextBillingDate: new Date(s.next_billing_at).toLocaleDateString(),
        subscriptionId: s.subscription_id,
      },
      replyTo: {
        email: "[email protected]",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

Notification d’échec de paiement

Envoyez un email de notification lorsqu’un paiement échoue :
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: "[email protected]",
        name: "Your Company Billing",
      },
      subject: "Payment Failed - Action Required",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.amount,
        currency: p.currency,
        failureReason: p.failure_reason,
        paymentId: p.payment_id,
        retryUrl: `https://yourdomain.com/billing/retry/${p.payment_id}`,
      },
      replyTo: {
        email: "[email protected]",
        name: "Billing Support",
      },
    };
  }
  return webhook;
}

Meilleures pratiques

  • Vérifiez votre domaine d’expéditeur : Assurez-vous que votre domaine d’email d’expéditeur est vérifié dans AutoSend pour améliorer la délivrabilité et éviter les problèmes d’authentification. Les domaines vérifiés aident à empêcher les emails de se retrouver dans les dossiers de spam.
  • Utilisez des données dynamiques pour la personnalisation : Utilisez le champ dynamicData pour personnaliser les emails avec des informations spécifiques au client telles que les noms, les montants de paiement et les détails d’abonnement. Les emails personnalisés ont des taux d’engagement plus élevés.
  • Rédigez des lignes d’objet claires : Rédigez des lignes d’objet descriptives qui indiquent clairement le but de l’email. Évitez les mots déclencheurs de spam et gardez les sujets concis (moins de 50 caractères).
  • Testez avant la production : Testez toujours vos emails avant de les envoyer en production. Cela garantit que le contenu de votre email s’affiche correctement et que toutes les données dynamiques sont correctement mappées.

Référence API

Pour des détails complets sur l’API AutoSend, y compris tous les paramètres disponibles et les codes d’erreur, visitez la Documentation de l’API AutoSend.

Dépannage

  • Vérifiez que la clé API est correcte et active
  • Vérifiez que le domaine d’expéditeur est vérifié dans AutoSend
  • Assurez-vous que les adresses email des destinataires sont valides
  • Examinez les limites et quotas d’envoi d’AutoSend
  • Vérifiez que l’URL de point de terminaison API est correcte : https://api.autosend.com/v1/mails/send
  • Vérifiez que les paramètres requis sont présents dans la charge utile
  • Validez que la structure JSON correspond au format de l’API AutoSend
  • Vérifiez que tous les champs requis sont présents (to, from, templateId ou html/text)
  • Assurez-vous que les adresses email sont correctement formatées
  • Vérifiez que templateId est valide si vous utilisez des modèles
  • Vérifiez que les clés dynamicData correspondent à vos variables de modèle
  • Vérifiez que votre ID de modèle est correct et actif dans AutoSend
  • Assurez-vous que les clés dynamicData correspondent aux variables utilisées dans votre modèle
  • Vérifiez que toutes les variables de modèle requises sont fournies
  • Testez votre modèle indépendamment dans le tableau de bord AutoSend