# Номери телефонів

Прив'яжіть SIP-номер клієнта до асистента для вхідних голосових дзвінків

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

Додайте SIP-номер телефону, прив'яжіть його до асистента, і AI-голосовий агент відповідатиме на вхідні дзвінки.

<VoiceSetupDemo />

## Підключення телефону [#підключення-телефону]

1. Отримайте SIP-облікові дані від [підтримуваного провайдера](/docs/integrations/telephony): номер телефону, SIP-логін, SIP-пароль, URL телефонії.
2. **Телефони** > **Додати телефон**, заповніть поля нижче, **Зберегти**.
3. Прив'яжіть: оберіть **Асистента** в налаштуваннях телефону (один телефон → один асистент), **Зберегти**.
4. Додайте інтеграцію провайдера телефонії: **Інтеграції** > **Додати інтеграцію** > оберіть провайдера, введіть облікові дані, активуйте.
5. Налаштуйте голосові параметри асистента, потім зателефонуйте на номер, щоб протестувати привітання та інструмент.

## Поля телефону [#поля-телефону]

| Поле           | Значення                                      |
| -------------- | --------------------------------------------- |
| Номер телефону | SIP-номер телефону (наприклад, +380501234567) |
| SIP-логін      | Ім'я користувача для автентифікації           |
| SIP-пароль     | Пароль для автентифікації                     |
| URL провайдера | Адреса SIP-сервера                            |
| Кодек          | A-law (за замовчуванням) або μ-law            |
| Коментар       | Необов'язковий підпис                         |

## Голосові налаштування (на асистенті) [#голосові-налаштування-на-асистенті]

| Параметр           | Значення                                                            |
| ------------------ | ------------------------------------------------------------------- |
| Голос              | 30 вбудованих голосів або ElevenLabs                                |
| Аудіоформат        | Формат входу/виходу (за замовчуванням PCM 8000)                     |
| Eagerness          | Eager, Normal або Patient                                           |
| Turn after silence | Секунди тиші перед тим, як асистент заговорить (за замовчуванням 7) |
| Soft timeout       | Макс. очікування відповіді користувача; -1 = необмежено             |

Див. [Асистенти > Налаштування голосу](/docs/agents).

## API [#api]

```bash
POST /api/phones
X-Access-Token: happ_your_token_here
Content-Type: application/json

{
  "phoneNumber": "+380501234567",
  "sipLogin": "your-sip-login",
  "password": "your-sip-password",
  "telephonyUrl": "sip.provider.com",
  "codec": "alaw",
  "comment": "Main office line"
}
```

Прив'яжіть до асистента через `PATCH /api/phones/{phoneId}` (`{ "assistantId": "..." }`). Список `GET /api/phones`, оновлення `PATCH`, видалення `DELETE /api/phones/{phoneId}`.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Усунення неполадок [#усунення-неполадок]

| Проблема           | Рішення                                                |
| ------------------ | ------------------------------------------------------ |
| Немає звуку        | Перевірте SIP-облікові дані та URL провайдера          |
| Переривчасте аудіо | Перевірте мережу; спробуйте інший кодек (alaw vs ulaw) |
| Повільні відповіді | Встановіть eagerness на Eager                          |
| Немає підключення  | Перевірте, що інтеграція провайдера телефонії активна  |
| Невірний голос     | Перевірте налаштування голосу в конфігурації асистента |

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

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