Referência
Chaves de API: changelog
Mudanças em Chaves de API: novos recursos, melhorias e correções.
outubro de 2026
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 (
setembro de 2026
Corrigido
Correções de compatibilidade da API v2
API RESTChaves de APIAPI de e-mailDomínios de envio
- As chaves de API criadas antes de as chaves terem o prefixo
secret_voltam a ser aceitas na/v2. - Obter um e-mail retorna o objeto de e-mail completo, incluindo
object,frometo. - As respostas de domínios retornam
track_loadsetrack_clickscomo0ou1, como documentado.
- As chaves de API criadas antes de as chaves terem o prefixo
Alterado
Chaves de API só de envio limitadas aos endpoints de envio
Antes, as chaves só de envio podiam listar e consultar e-mails e chamar alguns outros endpoints de leitura. Agora elas estão limitadas a Enviar um e-mail e às ações sobre um e-mail existente: reagendar, cancelar, tentar enviar de novo e encaminhar. Os outros endpoints rejeitam as chaves de envio.
Se a sua integração também lê e-mails, domínios ou outros recursos, use uma chave de acesso total nessas chamadas. Consulte Chaves de API.
outubro de 2025
Novo
API v2
API RESTChaves de APIDomínios de envioListas de contatosSupressões
As chaves de API substituem as credenciais. Uma chave tem o escopo
fullousending, uma chave de envio pode ser restrita a um único domínio de envio, e você pode gerenciar as chaves pela API. A API v1 continuou disponível durante a sua migração.Consulte a referência da API.