# Ringostat

Підключіть Ringostat, щоб дзвінки потрапляли в Happ з транскрипцією, AI-оцінкою та аналітикою

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Ringostat генерує Auth-key на вимогу прямо з кабінету — одна кнопка, і ключ готовий до вставки в Happ.

## Перед стартом [#перед-стартом]

* **Активний проєкт Ringostat** з налаштованим колтрекінгом і правами адміністратора на проєкт.
* **Auth-key** з кабінету Ringostat (як дістати — нижче).
* **Акаунт Happ на тарифі з голосовою аналітикою.**

## Як отримати Auth-key [#як-отримати-auth-key]

1. У кабінеті Ringostat відкрийте **Налаштування** > **Інтеграція**.
2. Виберіть пункт **Ringostat API**.
3. Натисніть **Генерувати** — ключ з'явиться в полі **Auth-key** миттєво. Скопіюйте його.

<img alt="Сторінка Ringostat API — кнопка «Генерувати», яка створює Auth-key" src="__img0" />

## Підключення [#підключення]

1. У Happ відкрийте **Інтеграції** > **Додати інтеграцію** > **Ringostat**.
2. Вставте ключ і підключіть.

| Поле     | Значення                                         |
| -------- | ------------------------------------------------ |
| Auth Key | Auth-key, згенерований на сторінці Ringostat API |

Номер телефону клієнта додається окремо в розділі **Телефони** — див. [Налаштування телефону і SIP](/docs/agents/phones).

## Як зрозуміти, що підключилось [#як-зрозуміти-що-підключилось]

На картці інтеграції з'явиться зелений бейдж **Підключено**, і дзвінки почнуть надходити в Happ одразу — з транскрипцією, AI-оцінкою і доступним Voice AI.

## Відключення і перепідключення [#відключення-і-перепідключення]

**Щоб відключити:** відкрийте **Інтеграції** > **Ringostat*&#x2A;, натисніть &#x2A;*…** поряд із карткою інтеграції і виберіть **Видалити**.

Після відключення:

* Нові дзвінки з Ringostat перестають надходити в Happ.
* Усі попередні дзвінки, транскрипції й AI-оцінки залишаються в Happ.
* Auth-key лишається дійсним у Ringostat. Якщо згенерувати новий на сторінці Ringostat API, старий перестане працювати — а разом з ним і будь-який інший сервіс, що ним користувався.

**Щоб перепідключити:** відкрийте **Інтеграції** > **Ringostat** > **Підключити**, вставте Auth-key знову і привʼяжіть інтеграцію до асистента.

Після перепідключення зберігаються: налаштування інтеграції (тип дзвінків, хто приймає, сценарій оцінки), привʼязка до асистента і його промпт, усі попередні транскрипції, скоринги і дашборди.

## Далі [#далі]

* [Провайдери телефонії](/docs/integrations/telephony) — усі підтримувані провайдери
* [Налаштування телефону і SIP](/docs/agents/phones) — підключення номера
* [Голосовий асистент](/docs/agents/voice) — огляд і налаштування