AutoSend

परिचय

AutoSend integration, Dodo Payments की प्रत्येक घटना पर AutoSend के email API के माध्यम से एक email भेजता है—सफल payments से लेकर विफल payment attempts और refund confirmations तक। webhook endpoint पर किया गया transformation प्रत्येक घटना को AutoSend send request में बदल देता है। इसे सेट अप करने के लिए, आपको AutoSend API key और AutoSend में verified sender domain की आवश्यकता होगी। अपनी API key AutoSend dashboard में Settings → API Keys के अंतर्गत मिल सकती है।

शुरुआत करना

AutoSend को Dodo Payments से connect करने के लिए इन steps का पालन करें:

Open Webhook Section

Dodo Payments dashboard में Developer → Webhooks पर जाएँ और Add endpoint पर click करें।

Integration ड्रॉपडाउन में AutoSend चुने हुए endpoint जोड़ने का डायलॉग

Select AutoSend Integration

Integration में, Autosend चुनें।

Enter API Key

API key में अपनी AutoSend API key पेस्ट करें। Dodo Payments इसे हर delivery के Authorization header में भेजता है।

Learn how to create and manage API keys

API keys बनाने और manage करने का तरीका जानने के लिए AutoSend documentation देखें।

Select Events

Subscribed events में, वे events चुनें जिन्हें आपका transformation handle करता है, जैसे payment.succeeded, subscription.active और payment.failed। जिन endpoints के लिए कोई event चयनित नहीं है, उन्हें हर event type प्राप्त होता है।

Configure Transformation

Transformation code के अंतर्गत, ऐसा JavaScript handler लिखें जो हर event के लिए email तैयार करे। code examples से शुरुआत करें।

Test & Create

Test this code के अंतर्गत, sample payload के विरुद्ध handler चलाने और परिणाम जाँचने के लिए Simulate पर क्लिक करें। फिर Create endpoint पर क्लिक करें।

Activation Complete

जब भी कोई subscribed event होता है, endpoint AutoSend के माध्यम से email भेजता है।

Code Examples

हर handler webhook.eventType में event type की जाँच करता है और event data को webhook.payload.data से पढ़ता है। यह webhook.url को AutoSend के send endpoint पर सेट करता है और webhook.payload को email request से बदल देता है। Dodo Payments की राशियाँ, जैसे total_amount, currency की सबसे छोटी इकाई में होती हैं; उदाहरण के लिए, USD के लिए cents।

Payment Confirmation Email

जब payment सफल हो जाए (payment.succeeded), तब confirmation email भेजें:

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

Subscription Welcome Email

जब subscription active हो जाए (subscription.active), तब welcome email भेजें। उदाहरण में product_id को planName के रूप में भेजा गया है। यदि आपके template में plan name दिखता है, तो पहले ID को display name से map करें।

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

Payment Failure Notification

जब payment विफल हो जाए (payment.failed), तब notification email भेजें। Payment का error_message field विफलता का कारण रखता है।

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

Best Practices

अपने sender domain को verify करें: AutoSend केवल verified domain से भेजता है, इसलिए endpoint बनाने से पहले AutoSend में अपने from address के domain को verify करें। Verified domain deliverability को भी बेहतर बनाता है और आपके emails को spam folders में जाने से रोकने में मदद करता है।
Personalization के लिए dynamic data का उपयोग करें: customer-specific values, जैसे names, payment amounts और subscription details, dynamicData field में भेजें और उन्हें अपने AutoSend template में variables के रूप में reference करें।
स्पष्ट subject lines लिखें: ऐसी subject lines लिखें जो email का उद्देश्य स्पष्ट करें। Spam filters को trigger करने वाले शब्दों से बचें और subjects को 50 characters से कम रखें।
Production से पहले test करें: हर handler को Test this code से चलाएँ, फिर live होने से पहले एक test email भेजें। जाँचें कि content सही तरीके से render हो रहा है और हर dynamicData value mapped है।

API Reference

Send endpoint के हर parameter और error code के लिए AutoSend API documentation देखें।

Troubleshooting

Emails Not Being Sent

जाँचें कि API key सही और active है।
जाँचें कि sender domain AutoSend में verified है।
जाँचें कि recipient email addresses मान्य हैं।
अपनी AutoSend sending limits और quotas की समीक्षा करें।
जाँचें कि transformation send endpoint URL सेट करता है: https://api.autosend.com/v1/mails/send।
जाँचें कि payload में हर required parameter शामिल है।
AutoSend के response code को देखने के लिए Developer → Webhooks के Logs tab में endpoint के delivery attempts खोलें।

Transformation Errors

जाँचें कि payload AutoSend API format से मेल खाता है।
जाँचें कि सभी required fields मौजूद हैं: to, from और या तो templateId या html/text। templateId के बिना, subject भी required है।
जाँचें कि email addresses सही format में हैं।
यदि आप template का उपयोग करते हैं, तो जाँचें कि templateId मान्य है।
जाँचें कि dynamicData keys आपके template variables से मेल खाती हैं।

Template Issues

जाँचें कि आपका template ID सही है और template AutoSend में active है।
जाँचें कि dynamicData keys आपके template के variables से मेल खाती हैं।
जाँचें कि हर required template variable का कोई value है।
AutoSend dashboard में template को अलग से test करें।

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

परिचय

शुरुआत करना

Learn how to create and manage API keys

Code Examples

Payment Confirmation Email

Subscription Welcome Email

Payment Failure Notification

Best Practices

API Reference

Troubleshooting

​परिचय

​शुरुआत करना

Learn how to create and manage API keys

​Code Examples

​Payment Confirmation Email

​Subscription Welcome Email

​Payment Failure Notification

​Best Practices

​API Reference

​Troubleshooting

परिचय

शुरुआत करना

Code Examples

Payment Confirmation Email

Subscription Welcome Email

Payment Failure Notification

Best Practices

API Reference

Troubleshooting