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

# Підключення телефонії

> Підключіть Twilio, щоб платформа могла здійснювати й приймати реальні дзвінки, а не лише тестові через браузер.

Ви вже розібралися з API Trigger і вебхуками. Обидва працюють на реальних дзвінках, а це означає, що спочатку потрібен підключений реальний номер телефону. Ця сторінка описує саме Twilio — найшвидший спосіб отримати номер і протестувати на безкоштовних тестових коштах.

## Крок 1: Створіть акаунт Twilio і купіть номер

Зареєструйтесь у Twilio. Ви потрапите на їхній дашборд із тестовими коштами для перевірки. Перейдіть у **Phone Numbers** і натисніть **Buy a number**, оберіть будь-який номер.

## Крок 2: Скопіюйте Account SID

На дашборді Twilio скопіюйте свій **Account SID**.

## Крок 3: Додайте конфігурацію в кабінеті

Відкрийте розділ **Телефонія** в кабінеті, натисніть **Додати конфігурацію** й оберіть **Twilio** як провайдера. Назвіть так, щоб потім впізнати — назва сценарію зазвичай підходить. Вставте Account SID.

Поверніться в Twilio, скопіюйте **Auth Token** і вставте його теж. Тримайте цей токен приватним.

Якщо хочете, щоб ця конфігурація стала конфігурацією за замовчуванням для тестових дзвінків і кампаній, увімкніть це тут. Для базового налаштування залиште визначення автовідповідача вимкненим і натисніть **Створити**.

<Warning>
  Увімкніть **«За замовчуванням для вихідних дзвінків»** на конфігурації телефонії. Якщо жодна конфігурація не задана за замовчуванням, API Trigger поверне помилку `400: Telephony provider not configured for this organization`, навіть якщо налаштування пройшло успішно.
</Warning>

## Крок 4: Додайте номер телефону

Коли конфігурація створена, перейдіть до керування номерами й додайте куплений номер. Скопіюйте його з Twilio і вставте як є, країна — залежно від того, де куплено номер. Мітка необовʼязкова, можна залишити порожньою. Оберіть вхідний сценарій — наприклад, агента стягнення заборгованості. Залиште номер активним і увімкніть caller ID за замовчуванням, якщо хочете, щоб тестові дзвінки завжди показували цей номер.

## Крок 5: Підтвердіть номер призначення

Перед тестуванням із тестового акаунта Twilio підтвердіть номер, на який плануєте дзвонити, наприклад, свій особистий. Це окремо від номера Twilio, куплений для показу як номер дзвінка. У Twilio перейдіть на сторінку [Verified Caller IDs](https://www.twilio.com/console/phone-numbers/verified) і додайте номер призначення.

## Крок 6: Перевірте

Після підтвердження запустіть дзвінок так само, як у [Запуск дзвінків через API](/getting-started/trigger-calls-from-your-backend), із Postman чи вашого бекенду. Платформа здійснює вихідний дзвінок через Twilio. Телефон дзвонить, агент відповідає, звʼязок активний.

<Note>
  На тестовому акаунті Twilio програє стандартне повідомлення перед зʼєднанням з агентом. Натисніть будь-яку клавішу, щоб пропустити його й одразу перейти до агента.
</Note>

Вхідні дзвінки працюють так само, тільки навпаки — маршрутизуються через вебхук Twilio у ваш сценарій.

## Далі

* **Дайте агенту робити більше під час дзвінка**: [Зовнішні інструменти й база знань](/getting-started/add-tools-and-knowledge-base) — про інструменти й базу знань.
* **Інші провайдери**: Vonage, Plivo, Cloudonix та SIP-налаштування описані в [Інтеграції телефонії](/integrations/telephony/overview).