> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Envíe recibos, confirmaciones y campañas por correo electrónico desde el panel o API, con dominio verificado y seguimiento de entrega.

<Tip>
  Email is **registered mail, digital edition**: long text, HTML, trackable links, ideal for receipts, password resets, and order confirmations.
</Tip>

## ¿Qué es el correo electrónico en Notifique?

Es el canal para **mensajes y campañas transaccionales** de **tu dominio** como remitente. Envías desde el **panel o API**; la plataforma maneja la cola, la entrega y el estado de cada mensaje.

Puede:

* **Enviar** recibos, confirmaciones, boletines y alertas con HTML y enlaces
* **Programar** envíos para una fecha y hora futuras
* **Consulta** historial y estado de cada correo electrónico
* **Seguimiento** de entregas, aperturas y clics mediante webhook
* **Cancelar** los envíos programados antes de que lleguen a la cola

Think of it as certified mail: it lands in the inbox, and you know if it was delivered and opened.

<Note>
  A diferencia de WhatsApp, el correo electrónico **no utiliza una instancia**. Solo necesita un dominio **VERIFICADO**, una clave API con los alcances correctos y destinatarios válidos.
</Note>

## ¿Cuándo usarlo?

Funciona muy bien para **recibos**, **restablecimiento de contraseña**, **confirmaciones de pedidos** y **textos largos con enlaces**. Para alertas telefónicas urgentes en segundos, prefiera [SMS](/es/sms-api/como-funciona/introducao) o push. Para conversaciones en tiempo real, utilice [WhatsApp](/es/whatsapp-api/como-funciona/introducao).

## Cómo funciona en la práctica

1. **Registrar y verificar un dominio** en DNS (demuestra que controlas `@yourdomain.com`)
2. **Enviar** con un remitente, destinatarios, asunto y cuerpo verificados (`text` y/o `html`)
3. La plataforma **pone en cola, envía y actualiza el estado**; tu backend recibe alertas si configuraste [webhooks](/es/emails-api/como-funciona/eventos-do-webhooks)

<Info>
  Each **API Key** belongs to **one** workspace. On v1 **do not send** `x-workspace-id`.
</Info>

## Dominio verificado

Antes del primer envío, el dominio **`from`** debe estar **VERIFICADO**. Regístrese en el panel o API, agregue los registros DNS que muestra Notifique y llame a verificar hasta que se confirme.

* **PENDIENTE**, dominio registrado, DNS aún no validado
* **VERIFICADO**, listo para usar como remitente
* **FALLADO**, verificación fallida; verifique TXT/CNAME en su proveedor de DNS

Sin un dominio verificado, envíe devoluciones **400** con `DOMAIN_NOT_VERIFIED`. Verificar códigos: [Respuestas de error](/es/guides/conceitos/resposta-de-erros#email-verify-domain-post-v1emaildomainsidverify).

## Ciclo de vida del mensaje

Después de `POST`, el correo electrónico pasa por `QUEUED` o `SCHEDULED`, luego `SENT`, `DELIVERED`, `OPENED` o `CLICKED` a medida que se produce la interacción. Los fracasos se convierten en `FAILED`; las quejas de spam pasan a ser `COMPLAINED`; los horarios cancelados se convierten en `CANCELLED`.

La cancelación de API solo funciona mientras el estado es **`SCHEDULED`**.

## Qué puedes hacer

* **Enviar** a entre 1 y 100 destinatarios por llamada
* **Horario** con `schedule.sendAt`
* Historial de **consultas** o un envío por identificación
* **Cancelar** envíos programados antes de la cola
* **Idempotencia** con encabezado `Idempotency-Key` para evitar duplicados
* **Cancelar suscripción con un clic** (RFC 8058) en campañas, guía: [Cancelar suscripción con un clic](/es/emails-api/como-funciona/one-click-unsubscribe-rfc-8058)

Cada correo electrónico normalmente consume **1 crédito** (plan) o saldo en **Pago por uso**. Ver [Facturación](/es/guides/introducao/cobranca-e-pague-pelo-uso).

Detalles de campo y error: **Referencia de API** en la pestaña Correo electrónico.

## Después de tu primer envío

* **Seguimiento** de entregas, aperturas y clics a través de [webhooks](/es/emails-api/como-funciona/eventos-do-webhooks) (`email.sent`, `email.delivered`, `email.opened`, …)
* **Suprime** las direcciones que se quejaron cuando recibas `email.complained`
* **Prueba** en [Sandbox](/es/guides/sandbox/index) con `sk_test_...` antes de la producción

## Próximos pasos

* [Inicio Rápido](/es/emails-api/como-funciona/quick-start): dominio, primer envío y consulta
* [Ámbitos de clave API](/es/emails-api/como-funciona/escopos-da-api-key): permisos
* [Eventos de webhook](/es/emails-api/como-funciona/eventos-do-webhooks): qué llega a tu URL
* [Comenzar](/es/guides/introducao/comece-aqui): integración general de la plataforma
