Docs/ Platform & apps

API, MCP e webhooks

Conecte agentes de IA por MCP, chame a API REST com chaves de escopo limitado e receba webhooks assinados.

Em Configurações > Desenvolvedor você conecta agentes de IA como Claude ou ChatGPT à sua caixa de entrada, cria chaves de API para suas próprias integrações e configura webhooks. O que seu plano inclui aparece na página.

Conectar um agente de IA (MCP)

O AI Emaily roda um servidor Model Context Protocol em https://mcp.aiemaily.com. Adicione-o como conector no seu cliente de IA: ele abre a entrada do AI Emaily, onde você aprova os escopos que quer conceder. Configurações > Desenvolvedor tem instruções passo a passo para Claude, ChatGPT, Claude Code e Cursor.

Agentes conectados lista cada app conectado com a data da conexão. Revogar acesso vale na hora.

Enviar pelo MCP sempre passa primeiro por um rascunho e depois por um envio explícito. A lista completa de ferramentas e os guias de configuração estão na página do MCP.

Chaves de API

  1. 1

    Crie uma chave

    Em Configurações > Desenvolvedor, selecione Criar chave, dê um nome e marque só os escopos de que ela precisa. Os escopos não podem ser ampliados depois.

  2. 2

    Copie uma vez

    A chave completa aparece uma única vez. Guarde-a em um gerenciador de segredos; se perdê-la, crie uma nova.

  3. 3

    Chame a API

    Envie a chave como token bearer para https://api.aiemaily.com/v1. A referência da API documenta todos os endpoints.

  4. 4

    Revogue quando terminar

    Selecione Revogar chave. As chaves revogadas param de funcionar na hora.

Grupo de escoposEscopos
E-mailmail:read, mail:write, mail:send, drafts:read, drafts:write
Busca e contatossearch:read, contacts:read, contacts:write
IA e agentesai:invoke, agent:read, brief:read
Dados e contextocontext:read, context:write, calendar:read, calendar:write
Plataformawebhooks:manage, usage:read

Limites de taxa

As solicitações são limitadas a 120 por minuto por chave de API e 300 por minuto por conta. Seu plano também define um número diário de solicitações e envios pela API, mostrado em Limites de taxa em Configurações > Desenvolvedor. Passar de um limite devolve HTTP 429 com um cabeçalho Retry-After.

Leituras e gravações sem IA não usam créditos. As ações de IA pela API usam créditos como as mesmas ações no app.

Webhooks

Os webhooks enviam um POST HTTPS para o seu endpoint quando algo acontece. Selecione Adicionar endpoint, digite a URL HTTPS e escolha os eventos: message.received, thread.updated, send.completed, send.failed, draft.created, agent.action e brief.ready.

Cada entrega é assinada com HMAC-SHA256 no cabeçalho X-Aiemaily-Signature. O segredo de assinatura aparece uma vez quando você adiciona o endpoint. Rotacionar segredo dá a você um novo, e o antigo continua assinando por 24 horas para você trocar sem perder entregas.

Cada endpoint tem Testar, Editar, Desativar e Excluir, e mostra as entregas recentes com as tentativas. Um endpoint que falha por três dias seguidos é desativado automaticamente; corrija e ative de novo. Seu plano define quantos endpoints você pode adicionar.

Frequently asked

Ready to try it?

Start Free Trial