Skip to main content
Status: live. 5 MCP tools у production: call log + online SIPs, AI-транскрипт розмов і перемикання між кількома Ringostat-проєктами.

​
Чому Ringostat першим

  • Public REST API, documented, stable
  • Use case clear: AI-агент аналізує call log, виявляє patterns (пропущені→callback rate, втрачена UTM-атрибуція, performance менеджерів)

​
Підключення

  1. Active Ringostat subscription з API access
  2. Отримай Ringostat Auth-key: Ringostat → Налаштування → Інтеграції → Ringostat API
  3. app.brama.work → Integrations → Ringostat → встав Auth-key
Auth-key зберігається зашифрованим, ізольовано per-tenant. Кожен tenant бачить лише свої дані.

​
MCP tools (live)

brama_ringostat_get_online_sips

Список SIP-акаунтів які зараз онлайн у Ringostat.Параметри: немає.Повертає: масив SIP-ідентифікаторів + count + timestamp.Use: перевірити хто доступний для прийому дзвінків перед outbound flow.

brama_ringostat_list_calls

Call log за datetime-діапазон з фільтрами.Параметри:
  • from (required) – YYYY-MM-DD HH:MM:SS (Kyiv time)
  • to (required) – YYYY-MM-DD HH:MM:SS
  • limit (optional) – default 50, max 200
  • direction (optional) – inbound / outbound
  • status (optional) – ANSWERED / NO ANSWER / BUSY / FAILED / …
Повертає: для кожного дзвінка – calldate, caller, dst, call_type (in/out/callback/transitin/transitout), disposition, billsec (talk seconds), employee_fio, recording (signed mp3 URL), UTM-атрибуція.
Фільтри direction / status застосовуються client-side після fetch – vendor REST не підтримує server-side фільтрацію через окремі params. Для великого періоду тягнеться весь діапазон (vendor cap 6500 calls/request). Віддавай перевагу вузькому from/to.
Use: “missed calls за вчора”, “inbound від конкретного номера”, “дзвінки конкретного менеджера”.

brama_ringostat_get_call_ai

Транскрипт сказаного у минулих дзвінках активного проєкту – для запитань рівня змісту: що було сказано, summary, sentiment, згадки в розмові.Параметри:
  • uniqueid (optional) – один дзвінок за id; перекриває діапазон
  • from / to (optional) – ISO datetime, дефолт – останні 24 год
  • limit (optional) – default 10, max 30
  • include_timestamps (optional) – true, коли відповідь має цитувати точні моменти
Use: “про що говорили в дзвінку X”, “коротко перекажи останні розмови”. Для метаданих (хто, коли, тривалість, disposition) бери brama_ringostat_list_calls.

brama_ringostat_list_projects

Список усіх Ringostat-проєктів, підключених для цього tenant’а: id, label і чи проєкт зараз активний.Параметри: немає.Use: перед brama_ringostat_switch_project, коли користувач не назвав цільовий проєкт, або коли питає про підключені проєкти.

brama_ringostat_switch_project

Перемикає активний Ringostat-проєкт поточної сесії. Після перемикання всі подальші виклики Ringostat-tool’ів працюють з новим проєктом.Параметри: connection_id (required – id проєкта з brama_ringostat_list_projects).Use: “перемкнись на проєкт X”. Потрібно лише коли у tenant’а підключено кілька Ringostat-проєктів.