API

API

Webhook и REST для агентов

Found API — два способа передать данные из вашего бэкенда в агентов: вебхук для событий и REST для прямых сообщений. URL и ключ копируются в Found API — берите их из кабинета, не собирайте вручную.

Базовый адрес сервиса: https://found-ai.ru. Примеры ниже используют его.

Webhook

У каждого аккаунта свой секретный URL. Отправьте JSON (до 64 КБ) — Found читает поле event или type и запускает агентов с триггером inbound_webhook.

POST https://found-ai.ru/api/webhooks/inbound/{token}
  • ?agent=ID — только указанный агент
  • Content-Type: application/json

Тело запроса:

{
  "event": "new_subscriber",
  "data": {
    "email": "user@mail.ru",
    "plan": "pro",
    "mrr_delta": 300
  }
}

Ответ:

{ "ok": true, "triggered": [12, 15] }

Пример (curl):

curl -X POST "https://found-ai.ru/api/webhooks/inbound/wh_xxx" \
  -H "Content-Type: application/json" \
  -d '{"event":"new_subscriber","data":{"email":"user@mail.ru","plan":"pro"}}'

Авторизация REST

Базовый URL: https://found-ai.ru/api/v1. Заголовок: Authorization: Bearer fnd_live_…. Ключ создаётся во вкладке Found API и показывается один раз.

Лимит: 60 запросов в минуту на аккаунт.

Список агентов

GET https://found-ai.ru/api/v1/agents

Вернёт id, имя, статус и тип триггера.

curl "https://found-ai.ru/api/v1/agents" \
  -H "Authorization: Bearer fnd_live_xxx"

Для вебхука создайте агента с типом «Событие» и событием inbound_webhook на странице Агенты.

Сообщение агенту

POST https://found-ai.ru/api/v1/agents/{id}/messages

Тело запроса:

{
  "text": "Новый плательщик: user@mail.ru, +300₽ MRR",
  "wait": true
}
  • text — 1–8000 символов
  • wait — ждать ответ агента (true) или принять в фоне (false)

Ответ:

{
  "status": "ok",
  "run_id": 1042,
  "response": "Записал в таблицу.",
  "conversation_id": 88
}

Пример (curl):

curl -X POST "https://found-ai.ru/api/v1/agents/AGENT_ID/messages" \
  -H "Authorization: Bearer fnd_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"text":"Новый плательщик: user@mail.ru, +300₽ MRR"}'

Коды ошибок

  • 400 — тело вебхука не JSON
  • 401 — нет или неверный API-ключ
  • 404 — агент не найден / неизвестный webhook-токен
  • 413 — payload webhook больше 64 КБ
  • 429 — превышен лимит (REST: 60/мин, вебхук: 120/мин)

Нужна помощь? Напишите в Telegram.