APIАдреса для агентов
Email API для AI-агентов,
с прицелом на мультиканал.
Ящики на входе, структурированные события на выходе.
Бесплатный план, около 50 запросов в день. Без карты. Входящий JSON на бесплатном плане доступен опросом.
Один вызов открывает адрес. Письмо возвращается как JSON.
Ящик не нужно разбирать вручную. Создайте адрес, затем опрашивайте его или направьте на него вебхук.
- Создайте случайный адрес, выбранную локальную часть или пачку адресов.
- Входящее письмо приходит как JSON: отправитель, тема, тело, вложения.
- Опрашивайте список входящих на любом плане. Подписанный вебхук — с плана Pro.
- Исходящие с этого адреса — с плана Business. Свой домен — на старших планах.
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."}'
Три станции на одной линии.
Откройте адрес
Один вызов API даёт агенту собственный адрес на домене tail.me или на вашем.
POST /email_addresses
Письмо становится JSON
Входящие разбираются на отправителя, тему, тело и вложения.
inbound_email
К вашему агенту
Опрашивайте список входящих или примите подписанный вебхук. Ответьте исходящим, если план это включает.
webhook · poll
Почта внутрь. JSON наружу. Ответ обратно.
Адреса для агентов, входящие как JSON, исходящие с того же адреса и домены, которые у вас уже есть.
Входящая почта
Адрес на агента. Отправитель, тема, тело и вложения, уже разобранные.
Вебхуки
Подписанный JSON в момент письма, с плана Pro. Опрос доступен на любом плане.
Исходящие
Отправка с адреса агента через API, с плана Business.
Свои домены
Адрес tail.me на любом плане. Свой домен — на старших планах.
Подписанные доставки. Ключ на каждый вызов.
HMAC на каждом вебхуке
SHA-256 по сырому телу, в заголовке X-Webhook-Signature. Пересчитайте подпись и отклоните несовпадение.
OpenSSL::HMAC.hexdigest("SHA256", secret, raw_body) # header: X-Webhook-Signature
Только по вашему ключу API
Каждый вызов передаёт X-Agent-ID и X-API-Key. Адрес не является публичным ящиком.
-H "X-API-Key: …"
Где команды ставят линию.
ИИ-агенты
Дайте каждому агенту адрес, который принимает почту и может ответить.
Проверка регистрации
Прочитайте код или ссылку из входящего JSON. Никто не смотрит в ящик.
QA и сквозные тесты
Новый адрес на прогон, проверка через API.
Клиентские операции
Направьте входящее письмо в тот процесс, который должен его обработать.
Проверка адреса
Проверьте адрес до того, как агент на него положится.
Справочник API
Адреса, входящие, исходящие и домены.
Поставьте первого агента
на линию.
Бесплатный план, около 50 запросов в день. Создайте адрес одним вызовом API.
curl -X POST $API/email_addresses/random \ -H "X-Agent-ID: $AGENT_ID" \ -H "X-API-Key: $API_KEY" \ -d '{"domain_id":"dom_…"}'