Do domínio ao primeiro envio, sem atrito.

# Chave gerada no painel — aparece uma única vez
DEXMAIL_API_KEY="dx_sua_chave_aqui"   # nunca no cliente

# Opcional: os SDKs oficiais já usam https://api.dexmail.com.br/api/v1.
# Só precisa definir para apontar a outro ambiente (dev/staging).
# DEXMAIL_API_URL="https://api.dexmail.com.br/api/v1"

import { DexMail } from "@dexmail/node";

// Lê DEXMAIL_API_KEY e DEXMAIL_API_URL do ambiente
const dexmail = new DexMail();

const { id, status } = await dexmail.emails.send({
  from: "Equipe <noreply@mail.suaempresa.com.br>",
  to: "cliente@exemplo.com",        // ou ["a@x.com", "b@x.com"] (até 50)
  subject: "Bem-vindo a bordo",
  html: "<h1>Olá 👋</h1><p>Seu primeiro e-mail transacional.</p>",
  // opcionais: text, reply_to, cc, bcc, headers,
  //   tags: [{ name: "fluxo", value: "onboarding" }],
  //   attachments: [{ filename: "guia.pdf", content: "<base64>" }],
});

// Envio reentrante (evita duplicar em retry): 2º arg com idempotencyKey
// await dexmail.emails.send({ ... }, { idempotencyKey: "pedido-123" });

console.log(id, status); // "ckq…"  "queued"

import { Resend } from "resend";

const resend = new Resend(process.env.RESEND_API_KEY);

await resend.emails.send({
  from: process.env.EMAIL_FROM,
  to: "cliente@exemplo.com",
  subject: "Bem-vindo!",
  html: "<p>Sua conta foi criada.</p>",
});

curl "$DEXMAIL_API_URL/emails/em_18a2c" \
  -H "Authorization: Bearer $DEXMAIL_API_KEY"

# → { "id": "em_18a2c", "status": "delivered", "to": "cliente@exemplo.com" }

// POST assinado para a sua URL (header DEXMail-Signature)
{
  "type": "email.delivered",
  "email_id": "em_18a2c",
  "created_at": "2026-07-08T13:40:11Z"
}

import express from "express";
import { verifyWebhookSignature, WebhookVerificationError } from "@dexmail/node";

app.post(
  "/webhooks/dexmail",
  express.raw({ type: "application/json" }), // precisa do corpo CRU
  (req, res) => {
    try {
      const event = verifyWebhookSignature(
        req.body,                       // Buffer cru — não reserialize o JSON
        req.header("DEXMail-Signature"),
        process.env.DEXMAIL_WEBHOOK_SECRET!,
      );
      // trate de forma idempotente pelo event.id (entrega é at-least-once)
      console.log(event.type, event.data.email_id);
      res.status(200).end();          // responda 2xx rápido
    } catch (err) {
      if (err instanceof WebhookVerificationError) return res.status(400).end();
      throw err;
    }
  },
);

import nodemailer from "nodemailer";

const transport = nodemailer.createTransport({
  host: "smtp.dexmail.com.br",
  port: 465,
  secure: true,
  auth: { user: "dexmail", pass: process.env.DEXMAIL_API_KEY }, // a senha É a API key
});

await transport.sendMail({
  from: "Equipe <noreply@mail.suaempresa.com.br>",
  to: "cliente@exemplo.com",
  subject: "Bem-vindo a bordo",
  html: "<p>Sua conta foi criada.</p>",
});