Conceito
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 workspaceWorkspaceUm contêiner para tudo o que você envia: domínios, chaves de API, e-mails, contatos, templates, membros e cobrança. Uma conta pode pertencer a vários workspaces.. 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 envioDomínio de envioUm domínio seu, verificado com registros DNS, para que o Emailit possa enviar e-mails a partir dele com SPF, DKIM e um return path personalizado. 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éditosCréditoA unidade de cobrança do Emailit. Cada ação custa um número fixo de créditos, por exemplo 1 por e-mail via API ou SMTP e 2 por e-mail de campanha., 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 |
| 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.
A vida de um e-mail
Todo e-mail segue o mesmo caminho, seja qual for a forma de envio:
- 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 statusaccepted, ouscheduledse você definir um horário de envio. A API emiteemail.acceptedouemail.scheduled. - 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 torna o e-mail
suppressed. Um domínio pausado, um workspace suspenso ou um saldo de créditos zerado o tornaheld. - 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 ficaheld, e as regras acionadas aparecem em Spam Checks na página do e-mail. - 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 tornaattempted, e o Emailit tenta de novo até 7 vezes ao longo de cerca de 21 horas antes de desistir e marcá-lo comobounced. - 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 embounced, e uma reclamação de spam do provedor de e-mail o tornacomplained. Os endereços com bounce e com reclamação podem ser adicionados à sua lista de supressão automaticamente. - Aberto e clicado. Se o domínio tiver um subdomínio de rastreamento verificado, as aberturas tornam o e-mail
loadede os cliques o tornamclicked.
Cada mudança de status é registrada como um evento. Os eventos aparecem na página do e-mail e em Email APIEvents. Eles também são enviados aos seus 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 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 para que os e-mails de produção nunca parem. Para planos e preços, consulte Créditos e a página de preços.
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 WorkspaceSettingsRequests. 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.
Todo workspace também tem limites de envio, 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 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.