> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brama.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Ringostat

> Call tracking integration – найперша інтеграція Brama (live).

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

## Чому 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)

<Card title="brama_ringostat_get_online_sips" icon="signal-bars">
  Список SIP-акаунтів які зараз онлайн у Ringostat.

  **Параметри:** немає.

  **Повертає:** масив SIP-ідентифікаторів + count + timestamp.

  Use: перевірити хто доступний для прийому дзвінків перед outbound flow.
</Card>

<Card title="brama_ringostat_list_calls" icon="phone">
  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-атрибуція.

  <Warning>
    Фільтри `direction` / `status` застосовуються **client-side** після fetch – vendor REST не підтримує server-side фільтрацію через окремі params. Для великого періоду тягнеться весь діапазон (vendor cap 6500 calls/request). Віддавай перевагу вузькому `from`/`to`.
  </Warning>

  Use: "missed calls за вчора", "inbound від конкретного номера", "дзвінки конкретного менеджера".
</Card>

<Card title="brama_ringostat_get_call_ai" icon="microphone-lines">
  Транскрипт сказаного у минулих дзвінках активного проєкту – для запитань рівня **змісту**: що було сказано, 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`.
</Card>

<Card title="brama_ringostat_list_projects" icon="folder-tree">
  Список усіх Ringostat-проєктів, підключених для цього tenant'а: `id`, `label` і чи проєкт зараз активний.

  **Параметри:** немає.

  Use: перед `brama_ringostat_switch_project`, коли користувач не назвав цільовий проєкт, або коли питає про підключені проєкти.
</Card>

<Card title="brama_ringostat_switch_project" icon="arrow-right-arrow-left">
  Перемикає активний Ringostat-проєкт поточної сесії. Після перемикання всі подальші виклики Ringostat-tool'ів працюють з новим проєктом.

  **Параметри:** `connection_id` *(required – id проєкта з `brama_ringostat_list_projects`)*.

  Use: "перемкнись на проєкт X". Потрібно лише коли у tenant'а підключено кілька Ringostat-проєктів.
</Card>