# Номера телефонов

Привяжите SIP-номер клиента к агенту для входящих голосовых звонков

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

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

<VoiceSetupDemo />

## Подключение телефона [#connect-a-phone]

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

## Поля телефона [#phone-fields]

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

## Голосовые настройки (в агенте) [#voice-settings-on-assistant]

| Настройка          | Значение                                                    |
| ------------------ | ----------------------------------------------------------- |
| Голос              | 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)

## Решение проблем [#troubleshooting]

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

## Дальше [#next]

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