Skip to content
Hissline

APIАдреса для агентов

Email API для AI-агентов,
с прицелом на мультиканал.

Ящики на входе, структурированные события на выходе.

Бесплатный план, около 50 запросов в день. Без карты. Входящий JSON на бесплатном плане доступен опросом.

Бесплатный план~50 запросов/день, без карты
Подпись HMACВебхуки, которые можно проверить
Спецификация OpenAPIТипизирована. Соберите любой клиент.
Доменыtail.me сейчас, свой домен позже
POST /email_addresses

Один вызов открывает адрес. Письмо возвращается как 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."}'
Как это работает

Три станции на одной линии.

01 · Адрес

Откройте адрес

Один вызов API даёт агенту собственный адрес на домене tail.me или на вашем.

POST /email_addresses
02 · Разбор

Письмо становится JSON

Входящие разбираются на отправителя, тему, тело и вложения.

inbound_email
03 · Доставка

К вашему агенту

Опрашивайте список входящих или примите подписанный вебхук. Ответьте исходящим, если план это включает.

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: …"

Поставьте первого агента
на линию.

Бесплатный план, около 50 запросов в день. Создайте адрес одним вызовом API.

curl
curl -X POST $API/email_addresses/random \
  -H "X-Agent-ID: $AGENT_ID" \
  -H "X-API-Key: $API_KEY" \
  -d '{"domain_id":"dom_…"}'