# Como o Emailit funciona

> O modelo mental do Emailit em uma página. Workspaces, domínios e chaves de API, as formas de enviar e receber, a vida de um e-mail, os créditos e o modo sandbox.

Esta página explica as principais peças do Emailit e como elas se encaixam. Leia-a uma vez antes de desenvolver qualquer coisa. O restante da documentação pressupõe que você conhece estes termos.

## Contas e workspaces

A sua **conta** é você: um endereço de e-mail, uma senha e, opcionalmente, autenticação de dois fatores ou passkeys. Tudo o que você envia fica em um workspace. Uma conta pode pertencer a vários workspaces, e você alterna entre eles com o seletor de workspaces no topo da barra lateral. Uma configuração comum é um workspace por produto ou por ambiente, por exemplo `Acme` e `Acme Staging`.

Cada workspace tem os seus próprios:

| Recurso | O que é |
| --- | --- |
| Domínios de envio | Domínios que você verifica com registros DNS para que o Emailit possa enviar por eles. Todo endereço From precisa estar em um domínio de envio verificado. |
| Chaves de API | Segredos que começam com `secret_`. Eles autenticam a API REST, o servidor MCP e o SMTP relay. Uma chave é **Full Access** ou **Sending Only**. |
| Membros | As pessoas que podem abrir o workspace, como **Admin** ou **Member**. Os administradores também gerenciam as configurações, as chaves de API, os membros e a cobrança. |
| Cobrança | Um plano, um saldo de créditos, as configurações de recarga automática e as faturas. |
| Dados | E-mails, eventos, logs, contatos, listas de contatos, templates, webhooks e supressões. |

Chaves de API, domínios, contatos e créditos pertencem a um único workspace. Uma chave de API nunca funciona em outro workspace.

## Formas de enviar, e uma forma de receber

| Canal | Use para | Como |
| --- | --- | --- |
| API REST | E-mails transacionais a partir do seu código: cadastros, redefinições de senha, recibos | `POST https://api.emailit.com/v2/emails` com uma chave de API, ou um [SDK](/pt/docs/sdks/) |
| SMTP relay | Apps, frameworks e ferramentas que já falam SMTP | Host `smtp.emailit.com`, usuário `emailit`, a sua chave de API como senha |
| Campanhas e automações | Newsletters, comunicados e sequências de onboarding para os seus contatos | Criadas no painel em **Email Marketing** |
| Recebimento | Receber e-mails no seu domínio, para respostas ou suporte | Um registro MX em `inbound.<your domain>`. Cada mensagem dispara `email.received`. |

Todos os canais usam os mesmos domínios verificados e a mesma lista de supressão. A API e o SMTP relay também compartilham as chaves de API, os logs de requisições e um único conjunto de limites de envio. Para escolher entre os dois, consulte [API ou SMTP](/pt/docs/get-started/api-or-smtp/).

## A vida de um e-mail

Todo e-mail segue o mesmo caminho, seja qual for a forma de envio:

1. **Aceito.** A API ou o SMTP relay verifica a requisição: uma chave de API válida, um endereço From em um domínio verificado, as regras do sandbox, os limites de envio e os créditos. Cada destinatário vira um e-mail separado, com o seu próprio ID `em_` e o status `accepted`, ou `scheduled` se você definir um horário de envio. A API emite `email.accepted` ou `email.scheduled`.
2. **Na fila e verificado.** Um processo de entrega pega o e-mail e o verifica de novo. Um destinatário na sua [lista de supressão](/pt/docs/suppressions/) torna o e-mail `suppressed`. Um domínio pausado, um workspace suspenso ou um saldo de créditos zerado o torna `held`.
3. **Assinado e pontuado.** O Emailit assina a mensagem com DKIM para o seu domínio e define o return path como `emailit.<your domain>`. Se o rastreamento estiver ativado, ele reescreve os links e adiciona um pixel de abertura. Depois, executa uma verificação de spam. Uma mensagem com pontuação 7 ou mais fica `held`, e as regras acionadas aparecem em **Spam Checks** na página do e-mail.
4. **Tentativas de entrega.** O Emailit se conecta ao servidor de e-mail do destinatário. Uma rejeição permanente (uma resposta 5xx) torna o e-mail `bounced`. Uma falha temporária (uma resposta 4xx ou um timeout) o torna `attempted`, e o Emailit tenta de novo até 7 vezes ao longo de cerca de 21 horas antes de desistir e marcá-lo como `bounced`.
5. **Entregue.** O servidor de destino aceitou a mensagem, então o e-mail fica `delivered`. Um relatório de bounce que chegue depois ainda pode transformá-lo em `bounced`, e uma reclamação de spam do provedor de e-mail o torna `complained`. Os endereços com bounce e com reclamação podem ser adicionados à sua lista de supressão automaticamente.
6. **Aberto e clicado.** Se o domínio tiver um [subdomínio de rastreamento](/pt/docs/tracking/) verificado, as aberturas tornam o e-mail `loaded` e os cliques o tornam `clicked`.

Cada mudança de status é registrada como um **evento**. Os eventos aparecem na página do e-mail e em **Email API → Events**. Eles também são enviados aos seus [webhooks](/pt/docs/webhooks/) como JSON assinado, em lotes de até 100 eventos por requisição.

| Grupo | Status |
| --- | --- |
| A caminho | `accepted`, `scheduled`, `attempted` |
| Chegou | `delivered`, `loaded`, `clicked`, `received` (recebimento) |
| Parou | `bounced`, `failed`, `rejected`, `suppressed`, `complained`, `canceled`, `held` |

Você pode cancelar um e-mail enquanto ele estiver `scheduled`, `accepted` ou `attempted`. Você pode tentar de novo um e-mail `held`, `bounced`, `failed` ou `suppressed` depois de corrigir a causa. Consulte [Status de e-mail](/pt/docs/logs/email-statuses/) para saber o que cada status significa.

## Créditos

O Emailit cobra em créditos. Cada workspace tem um saldo formado pelos créditos incluídos no plano todo mês mais os créditos que você comprar. Os créditos incluídos são usados primeiro. Os créditos comprados nunca expiram.

| Ação | Créditos |
| --- | --- |
| E-mail enviado pela API ou por SMTP (por destinatário) | 1 |
| E-mail recebido | 1 |
| E-mail de campanha (por destinatário) | 2 |
| Execução de automação | 3 |
| Verificação de e-mail (por endereço) | 5 |

Se o saldo não cobrir um envio, a API retorna `402` e nada é enviado. Os e-mails que chegam à fila de entrega sem créditos suficientes ficam `held`, e você pode tentar de novo depois de adicionar créditos. Ative a [recarga automática](/pt/docs/billing/auto-refill/) para que os e-mails de produção nunca parem. Para planos e preços, consulte [Créditos](/pt/docs/billing/credits/) e a [página de preços](/pricing/).

## Sandbox e acesso de produção

Todo workspace novo começa no **modo sandbox**. No modo sandbox, você só pode enviar para os endereços de e-mail das contas dos membros do workspace, e as campanhas ficam bloqueadas. Enviar para qualquer outra pessoa falha: a API retorna `403 unverified_workspace_recipient` e o SMTP relay responde `550`.

Para enviar a destinatários reais, verifique pelo menos um domínio de envio. Depois, um Admin solicita o acesso de produção pelo banner do sandbox ou em **Workspace → Settings → Requests**. A solicitação pergunta o que você envia, o volume esperado e como as pessoas dão opt-in. A equipe do Emailit a analisa e responde na mesma conversa da solicitação. Consulte [Acesso de produção](/pt/docs/workspaces/production-access/).

Todo workspace também tem [limites de envio](/pt/docs/limits/), compartilhados pela API e pelo SMTP. Os workspaces novos podem enviar 2 e-mails por segundo e 5.000 e-mails por dia. Os workspaces no Pro e no Business recebem aumentos automáticos com base na saúde de envio, e qualquer workspace pode pedir mais pelo card **Sending Limits** na página inicial do painel.

## O painel

O painel em [dash.emailit.com](https://dash.emailit.com) segue o mesmo modelo. A barra lateral tem estas seções, de cima para baixo:

| Seção | Página | Para que serve |
| --- | --- | --- |
| Dashboard | | Checklist de configuração, ações rápidas, créditos, volume diário, saúde de envio e limites de envio |
| Email Marketing | Overview | Crescimento de contatos e atividade de marketing recente |
| | Audiences | Listas nomeadas de inscritos para as quais as campanhas são enviadas |
| | Contacts | Todas as pessoas do workspace, com campos personalizados, importação e exportação |
| | Campaigns | Criar, testar, agendar e acompanhar os relatórios das campanhas |
| | Templates | Designs reutilizáveis para a API, as automações e as campanhas |
| | Forms | Formulários de inscrição (acesso antecipado) |
| | Automations | Fluxos disparados por contatos, datas e eventos de e-mail (beta) |
| Email API | Emails | Todos os e-mails enviados e recebidos, com status, conteúdo e tentativas de entrega |
| | Analytics | Envios, bounces, reclamações, aberturas e cliques ao longo do tempo |
| | Domains | Adicionar domínios, publicar registros DNS, acompanhar a verificação e o rastreamento |
| | DMARC reports | Quem envia e-mails em nome do seu domínio (a partir do Pro) |
| | Events | O fluxo de eventos do workspace que os webhooks recebem |
| | Logs | Todas as requisições à API e ao SMTP, com códigos de status e corpos |
| | API Keys | Criar, renomear, regenerar e excluir chaves, e ver as configurações SMTP |
| | Webhooks | Endpoints, seleção de eventos e todas as tentativas de entrega |
| | Suppressions | Endereços para os quais o Emailit não envia, com importação e exportação em CSV |
| Email Verification | Emails | Conferir um único endereço antes de enviar |
| | Lists | Conferir até 10.000 endereços de uma vez |
| Workspace | Billing | Plano, créditos, recarga automática, complementos e faturas |
| | Settings | Nome, membros, campos personalizados, retenção de dados, configurações de supressão e solicitações |

As configurações da sua conta (perfil, senha, autenticação de dois fatores e passkeys) e o seu link de indicação ficam no menu da conta, na parte inferior da barra lateral.

## Próximos passos

  - [Guia rápido da API](/pt/docs/quickstart/api/): Adicione um domínio, crie uma chave e envie o seu primeiro e-mail.
  - [Guia rápido de SMTP](/pt/docs/quickstart/smtp/): Conecte qualquer app ou framework por SMTP.
  - [API ou SMTP](/pt/docs/get-started/api-or-smtp/): Compare as duas formas de enviar e-mails transacionais.
  - [Checklist para entrar em produção](/pt/docs/get-started/go-live/): Tudo o que fazer antes de enviar a destinatários reais.

---
Fonte: https://emailit.com/pt/docs/get-started/how-emailit-works/