HappHapp Docs

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

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

MarkdownOpen in ClaudeOpen in ChatGPT

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

Подключение телефона

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

Поля телефона

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

Голосовые настройки (в агенте)

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

См. Агенты > Настройки голоса.

API

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

Решение проблем

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

Дальше

Help me solve it

Happ answers right away and hands over to a manager when needed.

На этой странице