APIAdresses email pour agents
API email pour les agents IA,
conçue pour le multicanal.
Des boîtes en entrée, des événements structurés en sortie.
Offre gratuite, environ 50 requêtes par jour. Sans carte. Le JSON entrant se consulte en polling sur l'offre gratuite.
Un appel ouvre une adresse. Le mail revient en JSON.
Pas de boîte à scraper. Créez l'adresse, puis interrogez-la ou pointez un webhook dessus.
- Créez une adresse aléatoire, une partie locale choisie, ou un lot.
- Le mail entrant arrive en JSON : expéditeur, objet, corps, pièces jointes.
- Interrogez la liste entrante sur tous les plans. Ajoutez un webhook signé dès Pro.
- Envoyez en sortie depuis cette adresse dès Business. Apportez votre domaine sur les plans supérieurs.
curl -X POST https://app.mailhook.co/api/v1/email_addresses/random \ -H "X-Agent-ID: $AGENT_ID" \ -H "X-API-Key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain_id":"dom_…"}'
# X-Webhook-Signature: HMAC-SHA256 of the raw body { "event": "inbound_email", "data": { "email_address": "[email protected]", "from": "[email protected]", "subject": "Your verification code", "text_body": "Your code is 482913." } }
curl -X POST https://app.mailhook.co/api/v1/outbound_emails \ -H "X-Agent-ID: $AGENT_ID" \ -H "X-API-Key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{"email_address_id":"ea_…","to":"[email protected]","subject":"Received","text_body":"Got it."}'
Trois stations sur une ligne.
Ouvrir une adresse
Un appel API donne à un agent sa propre adresse, sur un domaine tail.me ou le vôtre.
POST /email_addresses
Transformer le mail en JSON
Les messages entrants sont parsés : expéditeur, objet, corps et pièces jointes.
inbound_email
Vers votre agent
Interrogez la liste entrante, ou recevez un webhook signé. Répondez en sortie si votre plan le permet.
webhook · poll
Mail entrant. JSON sortant. Réponse.
Des adresses pour les agents, l'entrant en JSON, la sortie depuis la même adresse, et les domaines que vous possédez déjà.
Email entrant
Une adresse par agent. Expéditeur, objet, corps et pièces jointes, parsés.
Webhooks
Du JSON signé à l'arrivée d'un message, dès Pro. Tous les plans peuvent interroger l'API.
Sortie
Envoyez depuis l'adresse de l'agent via l'API, dès Business.
Domaines personnalisés
Une adresse tail.me sur tous les plans. Votre domaine sur les plans supérieurs.
Livraisons signées. Une clé à chaque appel.
HMAC sur chaque webhook
SHA-256 sur le corps brut, dans l'en-tête X-Webhook-Signature. Recalculez-le et rejetez ce qui ne correspond pas.
OpenSSL::HMAC.hexdigest("SHA256", secret, raw_body) # header: X-Webhook-Signature
Privé, lié à votre clé API
Chaque appel envoie X-Agent-ID et X-API-Key. Une adresse n'est pas une boîte publique.
-H "X-API-Key: …"
Où les équipes posent une ligne.
Agents IA
Donnez à chaque agent une adresse qui reçoit le mail et peut répondre.
Vérification d'inscription
Lisez un code ou un lien dans le JSON entrant. Personne ne surveille une boîte.
QA et tests de bout en bout
Une adresse neuve par exécution, vérifiée depuis l'API.
Opérations client
Acheminez le mail entrant vers le flux qui doit le traiter.
Vérification d'adresse
Vérifiez une adresse avant que votre agent en dépende.
Référence API
Adresses email, messages entrants, sortie et domaines.
Mettez votre premier agent
sur la ligne.
Offre gratuite, environ 50 requêtes par jour. Créez une adresse en un appel API.
curl -X POST $API/email_addresses/random \ -H "X-Agent-ID: $AGENT_ID" \ -H "X-API-Key: $API_KEY" \ -d '{"domain_id":"dom_…"}'