Docs/ Platform & apps

API, MCP et webhooks

Connectez des agents IA via MCP, appelez l'API REST avec des clés à portée limitée et recevez des webhooks signés.

Réglages > Développeur vous permet de connecter des agents IA comme Claude ou ChatGPT à votre boîte de réception, de créer des clés d'API pour vos propres intégrations et de configurer des webhooks. Ce que comprend votre forfait est indiqué sur la page.

Connecter un agent IA (MCP)

AI Emaily exploite un serveur Model Context Protocol à l'adresse https://mcp.aiemaily.com. Ajoutez-le comme connecteur dans votre client IA : il ouvre la connexion AI Emaily, où vous approuvez les portées que vous souhaitez accorder. Réglages > Développeur propose des instructions pas à pas pour Claude, ChatGPT, Claude Code et Cursor.

Agents connectés liste chaque app connectée avec sa date de connexion. Révoquer l'accès prend effet immédiatement.

L'envoi via MCP passe toujours d'abord par un brouillon, puis par un envoi explicite. La liste complète des outils et les guides de configuration se trouvent sur la page MCP.

Clés d'API

  1. 1

    Créez une clé

    Dans Réglages > Développeur, sélectionnez Créer une clé, donnez-lui un nom et cochez uniquement les portées nécessaires. Les portées ne peuvent pas être étendues ensuite.

  2. 2

    Copiez-la une fois

    La clé complète n'est affichée qu'une fois. Conservez-la dans un gestionnaire de secrets ; si vous la perdez, créez-en une nouvelle.

  3. 3

    Appelez l'API

    Envoyez la clé comme jeton bearer à https://api.aiemaily.com/v1. La référence de l'API documente chaque endpoint.

  4. 4

    Révoquez-la une fois terminé

    Sélectionnez Révoquer la clé. Les clés révoquées cessent de fonctionner immédiatement.

Groupe de portéesPortées
Messageriemail:read, mail:write, mail:send, drafts:read, drafts:write
Recherche et contactssearch:read, contacts:read, contacts:write
IA et agentsai:invoke, agent:read, brief:read
Données et contextecontext:read, context:write, calendar:read, calendar:write
Plateformewebhooks:manage, usage:read

Limites de débit

Les requêtes sont limitées à 120 par minute par clé d'API et 300 par minute par compte. Votre forfait fixe aussi un nombre quotidien de requêtes et d'envois via l'API, affiché sous Limites de débit dans Réglages > Développeur. Dépasser une limite renvoie HTTP 429 avec un en-tête Retry-After.

Les lectures et les écritures sans IA n'utilisent pas de crédits. Les actions IA via l'API utilisent des crédits comme les mêmes actions dans l'app.

Webhooks

Les webhooks envoient un POST HTTPS à votre endpoint quand un événement se produit. Sélectionnez Ajouter un endpoint, saisissez l'URL HTTPS et choisissez les événements : message.received, thread.updated, send.completed, send.failed, draft.created, agent.action et brief.ready.

Chaque livraison est signée en HMAC-SHA256 dans l'en-tête X-Aiemaily-Signature. Le secret de signature est affiché une fois lors de l'ajout de l'endpoint. Renouveler le secret vous en donne un nouveau, et l'ancien continue de signer pendant 24 heures pour que vous puissiez basculer sans manquer de livraisons.

Chaque endpoint dispose de Tester, Modifier, Désactiver et Supprimer, et affiche les livraisons récentes avec leurs tentatives. Un endpoint en échec pendant trois jours d'affilée est désactivé automatiquement ; corrigez-le et réactivez-le. Votre forfait fixe le nombre d'endpoints que vous pouvez ajouter.

Frequently asked

Ready to try it?

Start Free Trial