Referência
Webhooks: changelog
Mudanças em Webhooks: novos recursos, melhorias e correções.
outubro de 2026
Novo
Segmentos em alfa
SegmentosCampanhasAutomaçõesWebhooks
Os segmentos agora estão em Email Marketing > Segments no painel. Eles estão em alfa: abertos apenas à equipe do Emailit enquanto os testamos, então os workspaces de clientes ainda não os veem. Um segmento parte de todos os contatos ou dos inscritos de listas de contatos escolhidas e os filtra com grupos de regras sobre os campos do contato, os campos personalizados e a participação em listas. O Emailit o avalia sempre que ele é contado, listado ou usado em um envio, então ele está sempre atualizado.
- Campanhas podem enviar para segmentos, sozinhos ou junto com listas de contatos, e excluir listas e segmentos. As exclusões agora são aplicadas quando a campanha é enviada. Se uma lista ou um segmento excluído tiver sido apagado, o Emailit não envia a campanha.
- Segmentos rastreados no Pro, no Business e no Custom também registram quem entra e quem sai. As entradas e saídas iniciam automações com os novos gatilhos Added to segment e Removed from segment, enviam os eventos de webhook
segment.contact_addedesegment.contact_removede alimentam o gráfico Growth do segmento. Você escolhe o rastreamento ao criar um segmento. - Limites: o Pay as you go inclui 3 segmentos, o Pro 10 e o Business 100, rastreados ou não. Nos planos Custom, o número é flexível.
- API e MCP: a API de segmentos e o toolset
segmentsdo MCP criam, pré-visualizam e listam segmentos, os contatos deles e o crescimento deles.
Consulte Segmentos e Segmentos rastreados.
Novo
Rastreamento de eventos: eventos do workspace e eventos personalizados
Rastreamento de eventosChaves de APIWebhooks
Agora você pode enviar os seus próprios eventos junto com os que o Emailit registra, como um pedido, uma mudança de plano ou a visualização de um produto. Eles estão nas novas abas Workspace events e Tracking de Email API > Events.
- Dois escopos. Os eventos do workspace (
w:<name>) são declarados antes, com propriedades tipadas, e o Emailit rejeita os eventos que não correspondem à declaração. Os eventos personalizados (c:<name>) aceitam qualquer objeto JSON. O log de eventos tem um filtro Scope, e a API Listar eventos, um parâmetroscope. - Dos seus servidores. Enviar um evento registra um evento, e Enviar eventos em lote, até 100. Eles funcionam com as novas chaves de API Events Only, que podem enviar eventos, mas não podem ler dados nem enviar e-mails.
- Do seu site. O script de rastreamento envia eventos com uma chave de rastreamento pública que você pode limitar aos seus próprios sites.
identifyvincula os eventos de um visitante a um contato. - Contatos e webhooks. Os eventos aparecem no Activity log do contato. Os webhooks recebem os tipos que você escolher, ou todos os eventos do workspace ou personalizados com
w:*ec:*. - API e MCP. As APIs de eventos do workspace e de chaves de rastreamento, além da ferramenta
send-evente das ferramentas de eventos do workspace no toolseteventsdo MCP. - Planos. O rastreamento de eventos e o script de rastreamento estão incluídos nos planos Pro, Business e Custom. O Pro pode usar 100 tipos de evento, o Business, 1.000, e o Custom não tem limite. Consulte Limites.
Consulte Rastreamento de eventos.
- Dois escopos. Os eventos do workspace (
Alterado
Domínios de envio ilimitados no Pro e no Business
Domínios de envioCobrança e créditosWebhooksSupressões
Os limites dos planos agora correspondem à página de preços:
- Domínios de envio. O Pro, o Business e o Custom não têm limite de domínios (antes: 100 no Pro, 1.000 no Business). O Pay as you go não mudou: sem limite depois da primeira compra de créditos, 3 domínios antes dela.
- Endpoints de webhook. Os planos Custom não têm limite fixo. O Pay as you go continua com 3, o Pro com 10 e o Business com 100.
- Supressão automática. Os planos Custom podem alterá-la em Workspace > Settings, como o Pro e o Business.
- Análise de domínios. Os domínios registrados há menos de 30 dias só passam por análise no Pay as you go.
Consulte Limites de domínios e Limites e cotas.
Corrigido
email.held no seletor de eventos de webhooks, nos eventos de teste e no MCP
email.heldjá chegava aos webhooks com All events ativado, mas faltava em outros lugares: o seletor Events, a caixa de diálogo Send test e o filtro de eventos da página Events não o listavam, Enviar um evento de teste retornava400“Unknown event type”, e as ferramentascreate-webhook,update-webhooketest-webhookdo MCP o rejeitavam. Agora todos eles o aceitam.Consulte email.held e Configurar um webhook.
setembro de 2026
Alterado
Limites de inscritos e de webhooks por plano
Listas de contatosWebhooksLimites e retenção
Limite Pay as you go Pro Business Inscritos por lista 10.000 50.000 250.000 Endpoints de webhook 3 10 100 Filtros de payload de webhook Indisponível Disponível Disponível Os planos Custom não têm limite de inscritos. O limite de inscritos vale quando você adiciona inscritos, importa contatos, usa a URL de inscrição de uma lista e executa automações. Criar um webhook acima do seu limite retorna
422, e as páginas Audiences e Webhooks mostram quanto de cada limite você está usando.No Pay as you go, definir um filtro de payload retorna
403complan_required, e os filtros existentes são ignorados. Consulte Limites.Novo
Filtros, eventos de teste e novas tentativas manuais de webhooks
- Send test entrega ao seu endpoint um payload de exemplo de qualquer tipo de evento.
- Os filtros de payload entregam apenas os eventos cujos dados correspondem a até 25 regras.
- Webhook secret redefine o segredo de assinatura.
- As requisições com falha são reenviadas após 5 minutos, 30 minutos, 2 horas e 5 horas e depois a cada 12 horas, até 11 tentativas. O Emailit envia um e-mail ao proprietário do workspace quando um endpoint continua falhando e o desativa depois de 3 dias seguidos de falhas.
- Retry failed coloca de novo na fila as requisições com falha dos últimos 7 dias e reativa o webhook. Você também pode tentar de novo uma única requisição.
Consulte Webhooks e Novas tentativas e falhas.
maio de 2026
Novo
Reclamações de spam por feedback loops
EntregabilidadeSupressõesWebhooks
Quando um destinatário marca o seu e-mail como spam e o provedor dele informa isso por um feedback loop, o Emailit associa o relatório ao e-mail original, define o status como
complainede envia um eventoemail.complained. O endereço é adicionado à sua lista de supressão como reclamação, para que você não envie mais e-mails para ele.Consulte Bounces e reclamações.
fevereiro de 2026
Novo
Webhooks v2
Toda requisição é assinada com o segredo do seu webhook. Para verificar uma, calcule um HMAC-SHA256 do valor de
X-Emailit-Timestamp, de um ponto e do corpo bruto e compare o resultado com o cabeçalhoX-Emailit-Signature. Inscreva-se em tipos de evento específicos ou em todos os eventos. As entregas com falha recebem novas tentativas automaticamente.Consulte Webhooks para o formato atual do payload e o cronograma de novas tentativas.
Alterado
Status de e-mail simplificados
Logs de e-mailAPI de e-mailWebhooks
Status antigo Status novo pendingacceptedouscheduledsentdeliveredsoftfailattemptedhardfailbouncedopenedloadederrorfailedOs e-mails e as entregas existentes foram migrados para os novos nomes. Os eventos e as requisições de webhook criados antes da mudança mantêm os valores com que foram enviados. Consulte Status de e-mail para a lista atual.
Novo
Recebimento de e-mails
Recebimento de e-mailsWebhooks
Adicione um registro MX para
inbound.yourdomain.comque aponte parainbound.emailitmail.comcom prioridade 10. O Emailit aceita e-mails para qualquer endereço desse subdomínio e envia um eventoemail.receivedcom o remetente, o destinatário, o assunto e o ID do e-mail. Busque a mensagem completa com Obter um e-mail.Cada e-mail recebido custa 1 crédito. Consulte Configurar o recebimento de e-mails.
Novo
APIs de contatos, eventos e webhooks
ContatosLogs de e-mailWebhooksAPI REST
- Contatos: crie, liste, consulte, atualize e exclua contatos. Encontre um contato pelo ID
con_ou pelo endereço de e-mail e adicione-o a listas de contatos na mesma chamada. - Eventos: liste eventos, filtrados por um ou mais tipos e, se quiser, com os dados deles, e consulte um único evento.
- Webhooks: crie, liste, consulte, atualize e exclua endpoints de webhook.
Esses endpoints exigem uma chave de acesso total. Consulte a referência da API.
- Contatos: crie, liste, consulte, atualize e exclua contatos. Encontre um contato pelo ID