Dominio de envío propio

Por defecto, el correo de un comprobante sale desde el dominio de Chaski, con el nombre de tu marca: "Snappli vía Chaski" <[email protected]>. Con un dominio de envío propio, sale desde una dirección tuya, como [email protected].

Viene en el plan Business, o como complemento en los demás planes. Sin él, POST /v1/email-domains responde 403 plan_limit_reached con el complemento en addon_offer.

1. Agrega el dominio

Mejor usa un subdominio (facturas.tuempresa.com) y no el dominio principal: así los registros no chocan con el correo que ya usas.

curl https://api.chaski.ec/v1/email-domains \
  -H "Authorization: Bearer $CHASKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "facturas.snappli.com" }'

La respuesta trae los registros DNS que hay que publicar:

{
  "id": "edm_01jbx3k9q2f8m4tn6vwz0yh5ce",
  "name": "facturas.snappli.com",
  "status": "pending",
  "records": [
    { "record": "DKIM", "type": "TXT", "name": "resend._domainkey.facturas", "value": "p=MIGfMA0…", "priority": null, "status": "not_started" },
    { "record": "SPF", "type": "MX", "name": "send.facturas", "value": "feedback-smtp.us-east-1.amazonses.com", "priority": 10, "status": "not_started" },
    { "record": "SPF", "type": "TXT", "name": "send.facturas", "value": "v=spf1 include:amazonses.com ~all", "priority": null, "status": "not_started" }
  ],
  "verified_at": null
}

2. Publica los registros y verifica

Crea cada registro en el DNS de tu dominio (Cloudflare, GoDaddy, Route 53…). El name es relativo a tu zona: send.facturas en la zona snappli.com es send.facturas.snappli.com. Después pide la verificación:

curl -X POST https://api.chaski.ec/v1/email-domains/edm_…/verify \
  -H "Authorization: Bearer $CHASKI_API_KEY"

El DNS puede tardar en propagarse. Mientras tanto el estado es pending, y se actualiza solo cuando el proveedor de correo termina de revisar. Si queda en failed, revisa los registros y vuelve a verificar.

3. Úsalo en un perfil de marca

El remitente se elige en el perfil de marca del punto de emisión, con sender_email:

curl -X PATCH https://api.chaski.ec/v1/branding-profiles/brd_… \
  -H "Authorization: Bearer $CHASKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "sender_email": "[email protected]" }'

La dirección tiene que ser de un dominio verificado de tu cuenta (si no, 422 email_domain_not_verified). Las respuestas siguen llegando a reply_to_email.

Si el dominio deja de estar verificado, lo eliminas o tu plan ya no lo incluye, los correos vuelven a salir desde el dominio de Chaski: no se pierde ningún envío. Al eliminar un dominio, los perfiles que lo usaban quedan sin sender_email.