Deliverability

# Check SPF record
dig TXT daimon.email +short

# Expected output:
# "v=spf1 include:_spf.daimon.email ~all"

nslookup -type=TXT daimon.email

# Expected output:
# daimon.email text = "v=spf1 include:_spf.daimon.email ~all"

// Get DKIM DNS records for custom domain
const domain = await client.domains.get('yourdomain.com');

console.log(domain.dkim_records);
// [
//   {
//     type: "TXT",
//     name: "daimon._domainkey.yourdomain.com",
//     value: "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC..."
//   }
// ]

// Add these records to your DNS, then verify
await client.domains.verifyDkim('yourdomain.com');

# Get DKIM DNS records
domain = client.domains.get('yourdomain.com')

for record in domain.dkim_records:
    print(f"{record['type']} {record['name']} = {record['value']}")

# Add to DNS, then verify
client.domains.verify_dkim('yourdomain.com')

// Get deliverability metrics
const metrics = await client.account.getDeliverability();

console.log(metrics);
// {
//   sends_30d: 12450,
//   bounces_30d: 215,
//   bounce_rate: 0.017, // 1.7% (healthy)
//   complaints_30d: 3,
//   complaint_rate: 0.0002, // 0.02% (excellent)
//   spam_score: 0.2, // Lower is better (0-10 scale)
//   reputation: "excellent" // "excellent" | "good" | "fair" | "poor"
// }

if (metrics.bounce_rate > 0.05) {
  console.warn('Bounce rate above 5%! Clean your email list.');
}

if (metrics.complaint_rate > 0.001) {
  console.warn('Complaint rate above 0.1%! Review content and targeting.');
}

# Get deliverability metrics
metrics = client.account.get_deliverability()

print(f"Bounce rate: {metrics['bounce_rate'] * 100:.2f}%")
print(f"Complaint rate: {metrics['complaint_rate'] * 100:.3f}%")
print(f"Reputation: {metrics['reputation']}")

if metrics['bounce_rate'] > 0.05:
    print('WARNING: Bounce rate above 5%!')

if metrics['complaint_rate'] > 0.001:
    print('WARNING: Complaint rate above 0.1%!')

// Subscribe to bounce events
await client.webhooks.create({
  url: 'https://your-agent.com/webhooks/daimon',
  events: ['message.bounced', 'message.complained'],
});

// Handle bounces
app.post('/webhooks/daimon', async (req, res) => {
  const event = req.body;

  if (event.type === 'message.bounced') {
    const { to, bounce_type, bounce_reason } = event.data;

    if (bounce_type === 'permanent') {
      // Remove from your mailing list
      await removeEmailFromList(to[0]);
      console.log(`Removed ${to[0]} due to hard bounce`);
    }
  }

  if (event.type === 'message.complained') {
    const { to } = event.data;

    // Mark as unsubscribed
    await unsubscribeEmail(to[0]);
    console.log(`Unsubscribed ${to[0]} due to spam complaint`);
  }

  res.json({ received: true });
});

# Handle bounce webhook
@app.route('/webhooks/daimon', methods=['POST'])
def handle_webhook():
    event = request.json

    if event['type'] == 'message.bounced':
        to_email = event['data']['to'][0]
        bounce_type = event['data']['bounce_type']

        if bounce_type == 'permanent':
            remove_email_from_list(to_email)
            print(f"Removed {to_email} due to hard bounce")

    if event['type'] == 'message.complained':
        to_email = event['data']['to'][0]
        unsubscribe_email(to_email)
        print(f"Unsubscribed {to_email} due to spam complaint")

    return {'received': True}

// Add custom domain to your account
const domain = await client.domains.create({
  domain: 'yourdomain.com',
});

console.log(domain.dns_records);
// [
//   { type: "MX", name: "yourdomain.com", value: "mx1.daimon.email", priority: 10 },
//   { type: "MX", name: "yourdomain.com", value: "mx2.daimon.email", priority: 20 },
//   { type: "TXT", name: "yourdomain.com", value: "v=spf1 include:_spf.daimon.email ~all" },
//   { type: "TXT", name: "daimon._domainkey.yourdomain.com", value: "v=DKIM1; k=rsa; p=..." },
//   { type: "TXT", name: "_dmarc.yourdomain.com", value: "v=DMARC1; p=quarantine; rua=..." }
// ]

// Add these records to your DNS provider, then verify
await client.domains.verify('yourdomain.com');

# Add custom domain
domain = client.domains.create(domain='yourdomain.com')

for record in domain.dns_records:
    print(f"{record['type']} {record['name']} = {record['value']}")

# Add to DNS, then verify
client.domains.verify('yourdomain.com')