Email

Email

AM permite enviar desde tu propio dominio con firma DKIM para mejorar la entregabilidad.

Incluye plantillas, tracking de entrega y manejo de rebotes.

Envío de Email

Envío directo

POST /api/accounts/:account_id/email-messages/send

Envía con contenido explícito:

• contactos From/To/CC/BCC
• asunto y cuerpo (texto + HTML)

Envío con plantilla

POST /api/accounts/:account_id/email-messages/send-template

Envía usando una plantilla con variables ({{name}}).

Identidades de Email

Las identidades son direcciones de envío aprobadas para una cuenta.

Operación	Endpoint
Crear	POST /api/accounts/:account_id/email-identities
Listar	GET /api/accounts/:account_id/email-identities
Actualizar	PATCH /api/email-identities/:email_identity_id
Eliminar	DELETE /api/email-identities/:email_identity_id

Dominios y DKIM

Flujo de configuración

1. Registrar dominio: POST /api/accounts/:account_id/domains
2. Ejecutar checks: POST /api/domains/:domain_id/checks
3. Crear clave DKIM: POST /api/domains/:domain_id/dkim-keys
4. Activar clave DKIM: PATCH /api/dkim-keys/:dkim_key_id

Registros DNS

Registro	Nombre	Propósito
TXT	_am.mail.example.com	Propiedad del dominio
TXT	selector._domainkey.mail.example.com	Clave pública DKIM

Checks de dominio

AM verifica:

• TXT de propiedad
• CNAME
• A records
• certificados TLS
• SPF, DKIM, DMARC, BIMI
• MX

Plantillas de Email

Crea plantillas reutilizables con variables:

Subject: Welcome, {{name}}!

Hi {{name}},

Your account {{account_name}} is ready.

Operación	Endpoint
Crear	POST /api/accounts/:account_id/email-templates
Listar	GET /api/accounts/:account_id/email-templates
Obtener	GET /api/email-templates/:email_template_id
Actualizar	PATCH /api/email-templates/:email_template_id
Eliminar	DELETE /api/email-templates/:email_template_id

Tracking de entrega

Los eventos rastrean el ciclo de vida del email. event_type depende del proveedor, pero valores comunes incluyen:

Evento	Descripción
queued	Aceptado para entrega
sent	Entregado al MTA receptor
bounced	Fallo permanente

APIs de mensajes y eventos

Operación	Endpoint
Listar mensajes	GET /api/accounts/:account_id/email-messages
Buscar mensajes	POST /api/accounts/:account_id/email-messages/search
Eliminar por búsqueda	POST /api/accounts/:account_id/email-messages/search-delete
Obtener mensaje	GET /api/email-messages/:email_message_id
Listar eventos	GET /api/accounts/:account_id/email-message-events
Buscar eventos	POST /api/accounts/:account_id/email-message-events/search
Eliminar eventos por búsqueda	POST /api/accounts/:account_id/email-message-events/search-delete

Manejo de rebotes

Los rebotes duros generan bloqueos de direcciones para proteger la reputación de envío.

Operación	Endpoint
Listar bans	GET /api/accounts/:account_id/email-address-bans
Crear ban	POST /api/accounts/:account_id/email-address-bans
Eliminar ban	DELETE /api/accounts/:account_id/email-address-bans/:email_address_ban_id

Relacionado

• Dominio - Configuración de dominio
• Clave DKIM - Claves de firma
• Identidad de Email - Remitentes aprobados
• Email Message - Mensajes
• Email Template - Plantillas