Skip to main content

Documentation Index

Fetch the complete documentation index at: https://brama.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Status: scaffold complete, MCP tools у роботі. Перші tools заплановані у v0.1 release. Реальний MCP tool surface — TBD, додасться у документацію коли інтеграція стане live.

Чому Ringostat першим

  • Найвищий demand signal серед Bystrov Agency clients (operational директори, e-commerce власники)
  • Public API з OAuth2, documented, stable
  • Use case clear: “AI-агент щовечора репортить пропущені дзвінки + рекомендує follow-ups”

Planned tool surface (subject to change)

Очікувані MCP tools

  • brama_ringostat_get_missed_calls — список пропущених дзвінків за period
  • brama_ringostat_get_call_recording — отримати recording URL для конкретного call_id
  • brama_ringostat_create_callback_task — schedule follow-up call
  • brama_ringostat_get_agent_stats — per-agent metrics за period
Конкретні schemas → опубліковано у API Reference коли integration ship’неться.

Пререкізити для tenant’а

  • Active Ringostat subscription з API access (Pro tier+)
  • OAuth credentials provisioned через Bystrov Agency onboarding
  • Tenant активований у app.brama.work → Integrations → Ringostat → Connect

SDK

Реалізований у окремому Go module: bystrovagency/ringostat-sdk. Mirror pattern наших існуючих SDK (monobank-sdk, novapost-sdk):
  • Thin wrapper над Ringostat REST API
  • OAuth2 з refresh
  • Typed errors (ErrRateLimited, ErrUnauthorized, ErrInvalidToken)
  • Context-aware: кожна методa приймає context.Context
SDK reusable поза Brama — agency clients можуть use directly якщо хочуть.