AutoSend

Introduktion

AutoSend-integrationen skickar ett e-postmeddelande via AutoSends email-API varje gång en händelse i Dodo Payments inträffar, från lyckade betalningar till misslyckade betalningsförsök och bekräftelser av återbetalningar. En transformation på webhook-endpointen omvandlar varje händelse till en send-begäran till AutoSend. För att konfigurera detta behöver du en AutoSend API key och en avsändardomän som har verifierats i AutoSend. Du hittar din API key i AutoSend-dashboarden under Settings → API Keys.

Kom igång

Följ dessa steg för att ansluta AutoSend till Dodo Payments:

Open Webhook Section

Gå till Developer → Webhooks i Dodo Payments-dashboarden och klicka på Add endpoint.

Dialogrutan för att lägga till en endpoint med AutoSend valt i rullgardinsmenyn Integration

Select AutoSend Integration

I Integration väljer du Autosend.

Enter API Key

I API key klistrar du in din AutoSend API key. Dodo Payments skickar den i Authorization-headern för varje leverans.

Learn how to create and manage API keys

Se AutoSend-dokumentationen för information om hur du skapar och hanterar API keys.

Select Events

Under Subscribed events väljer du de händelser som din transformation hanterar, till exempel payment.succeeded, subscription.active och payment.failed. En endpoint där inga händelser har valts tar emot alla händelsetyper.

Configure Transformation

Under Transformation code skriver du JavaScript-handlern som bygger e-postmeddelandet för varje händelse. Börja med kodexemplen.

Test & Create

Under Test this code klickar du på Simulate för att köra handlern mot en exempelpayload och kontrollera resultatet. Klicka sedan på Create endpoint.

Activation Complete

Endpointen skickar ett e-postmeddelande via AutoSend varje gång en prenumererad händelse inträffar.

Kodexempel

Varje handler kontrollerar händelsetypen i webhook.eventType och läser händelsedata från webhook.payload.data. Den anger webhook.url till AutoSends send endpoint och ersätter webhook.payload med e-postbegäran. Belopp i Dodo Payments, till exempel total_amount, anges i den minsta valutaenheten, till exempel cent för USD.

Bekräftelse via e-post av betalning

Skicka ett bekräftelsemeddelande via e-post när en betalning lyckas (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;
}

Välkomstmeddelande via e-post för prenumeration

Skicka ett välkomstmeddelande via e-post när en prenumeration blir aktiv (subscription.active). Exemplet skickar product_id som planName. Om din mall visar plannamnet mappar du först ID:t till ett visningsnamn.

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

Avisering om misslyckad betalning

Skicka ett aviseringsmeddelande via e-post när en betalning misslyckas (payment.failed). Betalningens error_message-fält innehåller orsaken till felet.

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

Bästa praxis

Verifiera din avsändardomän: AutoSend skickar endast från en verifierad domän, så verifiera domänen för din from-adress i AutoSend innan du skapar endpointen. En verifierad domän förbättrar också leveransbarheten och hjälper till att hålla dina e-postmeddelanden borta från skräppostmappar.
Använd dynamiska data för personalisering: Skicka kundspecifika värden, till exempel namn, betalningsbelopp och prenumerationsuppgifter, i fältet dynamicData och referera till dem som variabler i din AutoSend-mall.
Skriv tydliga ämnesrader: Skriv ämnesrader som anger e-postmeddelandets syfte. Undvik ord som utlöser skräppostfilter och håll ämnena under 50 tecken.
Testa före produktion: Kör varje handler med Test this code och skicka sedan ett testmeddelande innan du går live. Kontrollera att innehållet återges korrekt och att varje dynamicData-värde är mappat.

API-referens

Information om alla parametrar och felkoder för send endpoint finns i AutoSend API-dokumentationen.

Felsökning

Emails Not Being Sent

Kontrollera att API key är korrekt och aktiv.
Kontrollera att avsändardomänen är verifierad i AutoSend.
Kontrollera att mottagarnas e-postadresser är giltiga.
Granska dina sändningsgränser och quotas i AutoSend.
Kontrollera att transformationen anger URL:en för send endpoint: https://api.autosend.com/v1/mails/send.
Kontrollera att payloaden innehåller alla obligatoriska parametrar.
Öppna endpointens leveransförsök på fliken Logs under Developer → Webhooks för att se AutoSends svarskod.

Transformation Errors

Kontrollera att payloaden följer AutoSend API-formatet.
Kontrollera att alla obligatoriska fält finns: to, from och antingen templateId eller html/text. Utan templateId krävs även subject.
Kontrollera att e-postadresserna är korrekt formaterade.
Om du använder en mall ska du kontrollera att templateId är giltigt.
Kontrollera att nycklarna i dynamicData matchar variablerna i din mall.

Template Issues

Kontrollera att mall-ID:t är korrekt och att mallen är aktiv i AutoSend.
Kontrollera att nycklarna i dynamicData matchar variablerna i din mall.
Kontrollera att varje obligatorisk mallvariabel har ett värde.
Testa mallen separat i AutoSend-dashboarden.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduktion

Kom igång

Learn how to create and manage API keys

Kodexempel

Bekräftelse via e-post av betalning

Välkomstmeddelande via e-post för prenumeration

Avisering om misslyckad betalning

Bästa praxis

API-referens

Felsökning

​Introduktion

​Kom igång

Learn how to create and manage API keys

​Kodexempel

​Bekräftelse via e-post av betalning

​Välkomstmeddelande via e-post för prenumeration

​Avisering om misslyckad betalning

​Bästa praxis

​API-referens

​Felsökning

Introduktion

Kom igång

Kodexempel

Bekräftelse via e-post av betalning

Välkomstmeddelande via e-post för prenumeration

Avisering om misslyckad betalning

Bästa praxis

API-referens

Felsökning