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
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
Copie uma vez
A chave completa aparece uma única vez. Guarde-a em um gerenciador de segredos; se perdê-la, crie uma nova.
- 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
Revogue quando terminar
Selecione Revogar chave. As chaves revogadas param de funcionar na hora.
| Grupo de escopos | Escopos |
|---|---|
| mail:read, mail:write, mail:send, drafts:read, drafts:write | |
| Busca e contatos | search:read, contacts:read, contacts:write |
| IA e agentes | ai:invoke, agent:read, brief:read |
| Dados e contexto | context:read, context:write, calendar:read, calendar:write |
| Plataforma | webhooks: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