> ## 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.

# Introdução

> Envie recibos, confirmações e campanhas por e-mail pelo painel ou API, com domínio verificado e rastreamento de entrega.

<Tip>
  E-mail é a **carta registrada digital**: texto longo, HTML, links rastreáveis, ideal para recibo, reset de senha e confirmação de pedido.
</Tip>

## O que é E-mail na Notifique?

É o canal para mandar **mensagens transacionais e campanhas** com remetente do **seu domínio**. Você envia pelo **painel ou API**; a plataforma cuida da fila, da entrega e do status de cada mensagem.

Você pode:

* **Enviar** recibos, confirmações, newsletters e avisos com HTML e links
* **Agendar** envio para data e hora futuras
* **Consultar** histórico e status de cada e-mail
* **Rastrear** entrega, abertura e clique por webhook
* **Cancelar** agendamentos antes da fila

Pense numa carta com AR: o destinatário recebe na caixa de entrada, você sabe se foi entregue e se abriu.

<Note>
  Diferente do WhatsApp, e-mail **não usa instância**. Basta domínio **VERIFIED**, API Key com os escopos certos e destinatários válidos.
</Note>

## Quando usar?

Funciona muito bem para **recibo**, **reset de senha**, **confirmação de pedido** e **texto longo com links**. Para aviso urgente no celular em segundos, prefira [SMS](/sms-api/como-funciona/introducao) ou push. Para conversa em tempo real, use [WhatsApp](/whatsapp-api/como-funciona/introducao).

## Como funciona na prática

1. **Registre e verifique um domínio** no DNS (prova que você controla o `@seudominio.com`)
2. **Envie** com remetente verificado, destinatários, assunto e corpo (`text` e/ou `html`)
3. A plataforma **enfileira, envia e atualiza o status**; seu backend recebe avisos se configurou [webhooks](/emails-api/como-funciona/eventos-do-webhooks)

<Info>
  Cada **API Key** pertence a **um** workspace. Na v1 **não envie** `x-workspace-id`.
</Info>

## Domínio verificado

Antes do primeiro envio, o domínio do **`from`** precisa estar **VERIFIED**. Cadastre no painel ou API, configure os registros DNS que a Notifique mostra e chame verify até confirmar.

* **PENDING**, domínio cadastrado, DNS ainda não validado
* **VERIFIED**, pronto para usar no remetente
* **FAILED**, verificação falhou; confira TXT/CNAME no provedor DNS

Sem domínio verificado, o envio retorna **400** com `DOMAIN_NOT_VERIFIED`. Códigos de verify: [Respostas de erro](/guides/conceitos/resposta-de-erros#e-mail-verificar-domínio-post-v1emaildomainsidverify).

## Ciclo da mensagem

Depois do `POST`, o e-mail passa por `QUEUED` ou `SCHEDULED`, depois `SENT`, `DELIVERED`, `OPENED` ou `CLICKED` conforme engajamento. Falhas viram `FAILED`; reclamação de spam vira `COMPLAINED`; cancelamento de agendamento vira `CANCELLED`.

Cancelamento pela API só funciona enquanto o status for **`SCHEDULED`**.

## O que dá para fazer

* **Enviar** para 1 a 100 destinatários por chamada
* **Agendar** com `schedule.sendAt`
* **Consultar** histórico ou um envio pelo id
* **Cancelar** agendamento antes da fila
* **Idempotência** com header `Idempotency-Key` para evitar duplicata
* **One-click unsubscribe** (RFC 8058) em campanhas, guia: [One-click unsubscribe](/emails-api/como-funciona/one-click-unsubscribe-rfc-8058)

Cada e-mail costuma consumir **1 crédito** (plano) ou saldo em **Pague pelo uso**. Veja [Cobrança](/guides/introducao/cobranca-e-pague-pelo-uso).

Detalhe de campos e erros: **referência da API** na aba E-mails.

## Depois do primeiro envio

* **Acompanhe** entrega, abertura e clique por [webhooks](/emails-api/como-funciona/eventos-do-webhooks) (`email.sent`, `email.delivered`, `email.opened`, …)
* **Suprima** endereços que reclamaram spam ao receber `email.complained`
* **Teste** no [Sandbox](/guides/sandbox/index) com `sk_test_...` antes de ir para produção

## Próximos passos

* [Quick Start](/emails-api/como-funciona/quick-start): domínio, primeiro envio e consulta
* [Escopos da API Key](/emails-api/como-funciona/escopos-da-api-key): permissões
* [Eventos dos webhooks](/emails-api/como-funciona/eventos-do-webhooks): o que chega na sua URL
* [Comece aqui](/guides/introducao/comece-aqui): integração geral da plataforma