API, MCP y webhooks
Conecta agentes de IA por MCP, llama a la API REST con claves limitadas y recibe webhooks firmados.
En Configuración > Desarrollador conectas agentes de IA como Claude o ChatGPT a tu bandeja de entrada, creas claves de API para tus propias integraciones y configuras webhooks. Lo que incluye tu plan se muestra en la página.
Conectar un agente de IA (MCP)
AI Emaily tiene un servidor Model Context Protocol en https://mcp.aiemaily.com. Añádelo como conector en tu cliente de IA: abre el inicio de sesión de AI Emaily, donde apruebas los permisos que quieras conceder. Configuración > Desarrollador tiene instrucciones paso a paso para Claude, ChatGPT, Claude Code y Cursor.
Agentes conectados muestra cada app conectada y cuándo la conectaste. Revocar acceso tiene efecto al instante.
Enviar por MCP siempre pasa primero por un borrador y después por un envío explícito. La lista completa de herramientas y las guías de configuración están en la página de MCP.
Claves de API
- 1
Crea una clave
En Configuración > Desarrollador, selecciona Crear clave, ponle un nombre y marca solo los permisos que necesita. Los permisos no se pueden ampliar después.
- 2
Cópiala una vez
La clave completa solo se muestra una vez. Guárdala en un gestor de secretos; si la pierdes, crea una nueva.
- 3
Llama a la API
Envía la clave como token bearer a https://api.aiemaily.com/v1. La referencia de la API documenta todos los endpoints.
- 4
Revócala al terminar
Selecciona Revocar clave. Las claves revocadas dejan de funcionar al instante.
| Grupo de permisos | Permisos |
|---|---|
| Correo | mail:read, mail:write, mail:send, drafts:read, drafts:write |
| Búsqueda y contactos | search:read, contacts:read, contacts:write |
| IA y agentes | ai:invoke, agent:read, brief:read |
| Datos y contexto | context:read, context:write, calendar:read, calendar:write |
| Plataforma | webhooks:manage, usage:read |
Límites de uso
Las solicitudes se limitan a 120 por minuto por clave de API y 300 por minuto por cuenta. Tu plan también fija un número diario de solicitudes y de envíos por la API, que se muestra en Límites de uso en Configuración > Desarrollador. Superar un límite devuelve HTTP 429 con un encabezado Retry-After.
Las lecturas y las escrituras sin IA no usan créditos. Las acciones de IA por la API usan créditos igual que las mismas acciones en la app.
Webhooks
Los webhooks envían un POST HTTPS a tu endpoint cuando ocurre algo. Selecciona Añadir endpoint, escribe la URL HTTPS y elige los eventos: message.received, thread.updated, send.completed, send.failed, draft.created, agent.action y brief.ready.
Cada entrega va firmada con HMAC-SHA256 en el encabezado X-Aiemaily-Signature. El secreto de firma se muestra una vez al añadir el endpoint. Rotar secreto te da uno nuevo, y el antiguo sigue firmando durante 24 horas para que puedas cambiar sin perder entregas.
Cada endpoint tiene Probar, Editar, Desactivar y Eliminar, y muestra las entregas recientes con sus intentos. Un endpoint que falla tres días seguidos se desactiva automáticamente; arréglalo y vuelve a activarlo. Tu plan fija cuántos endpoints puedes añadir.
Frequently asked
Ready to try it?
Start Free Trial