Pular para o conteúdo
Docs

Referência

Chaves de API: changelog

Mudanças em Chaves de API: novos recursos, melhorias e correções.

outubro de 2026

  1. 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âmetro scope.
    • 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. identify vincula 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:* e c:*.
    • API e MCP. As APIs de eventos do workspace e de chaves de rastreamento, além da ferramenta send-event e das ferramentas de eventos do workspace no toolset events do 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.

setembro de 2026

  1. 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, from e to.
    • As respostas de domínios retornam track_loads e track_clicks como 0 ou 1, como documentado.
  2. Alterado

    Chaves de API só de envio limitadas aos endpoints de envio

    Chaves de APIAPI de e-mail

    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

  1. 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 full ou sending, 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.

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.