Все гайды
Голос Средний уровень 10 мин чтения

Постройте Voice-агента за 10 минут

От нуля до рабочего voice AI-агента, который отвечает на входящие звонки.

Что вы настроите

Вы настроите AI voice-агента, который отвечает на входящие звонки на ваш номер, задаёт звонящему несколько квалифицирующих вопросов, а затем бронирует встречу в Google Calendar или переводит звонок на сотрудника. После завершения звонка расшифровка и запись, которую можно прослушать, появляются в чате клиента на экране Chats, так что команда продолжает работу с клиентом в одном месте.

Если данные телефонной линии и инструкции агента уже готовы, настройка занимает около 10 минут.

Что нужно заранее

  • Агент с инструкциями. Voice-агент создаётся из инструкций и базы знаний вашего агента в момент подключения канала.
  • Ваша телефонная линия. Это SIP Trunk от вашего оператора телефонии или номер, который уже есть в вашем Twilio Account.
  • Google Calendar, если агент должен бронировать встречи. Доступ к календарю выдаётся отдельно для каждого агента.
  • Баланс сообщений. Звонки тарифицируются по длительности с точностью до секунды: 3 AI-сообщения в минуту для стандартных голосов, 5 для голосов повышенного качества. Подробнее на странице тарифов.

Настройка по шагам

  1. Опишите сценарий звонка. В инструкциях агента укажите цель: поздороваться, задать квалифицирующие вопросы, затем предложить встречу или перевод на человека. Для телефона короткие и конкретные инструкции работают лучше длинных и расплывчатых.
  2. Подключите Google Calendar. Откройте Integrations, выберите агента, найдите Google Calendar в категории Productivity & Scheduling и нажмите Connect. Выберите аккаунт Google, отметьте календари и нажмите Save calendar selection. Сделайте это до создания канала Calls.
  3. Перейдите в Channels, выберите агента и откройте Calls.
  4. В поле Provider выберите SIP Trunk или Twilio Account.
  5. В блоке Voice (Optional) прослушайте варианты через Play preview и выберите голос. Он также задаёт основной язык агента.
  6. Заполните поля провайдера. Для SIP Trunk: Phone Number в международном формате, Address, Transport (по умолчанию TCP, или TLS), а для digest-аутентификации ещё SIP Trunk Username и SIP Trunk Password. Для Twilio: Phone Number, Twilio Account SID и Twilio Auth Token. Нажмите Connect phone number.
  7. Включите Transfer to human operator. Укажите Operator number, при необходимости внутренний номер в Phone line и Transfer Condition, например: звонящий прямо просит соединить с менеджером.
  8. Нажмите Make a test call, чтобы поговорить с агентом в браузере и проверить голос, первое сообщение и поведение.
  9. Включите Connect agent to this channel. Новые каналы Calls создаются выключенными.

Важные параметры

  • First Message: первая фраза агента. По умолчанию это приветственное сообщение вашего агента.
  • Speech Speed: 0.7 медленнее, 1.2 быстрее; по умолчанию 1.2.
  • Max Call Duration (minutes): жёсткое ограничение длительности звонка, по умолчанию 10 минут.
  • LLM и TTS Model: модель, которая формирует ответы, и модель синтеза речи, которая подбирается автоматически под язык.
  • Additional languages: языки, на которые агент может переключиться во время разговора, а также Automatic language switching, чтобы определять язык звонящего. Добавление языков переводит агента на голос v3 Conversational, который тарифицируется по ставке 5 AI-сообщений в минуту.
  • End conversation: как и когда агент завершает звонок.

Частые проблемы и решения

  • Агент не отвечает на звонки. Проверьте, включён ли Connect agent to this channel. Одно лишь подключение провайдера не активирует звонки.
  • Ошибка «A channel with this phone number is already connected». Номер можно подключить только один раз, и этот уже используется в другом канале Calls.
  • Не удаётся подключить SIP. В поле Address укажите только хост или IP, без префикса sip:. Если ваш SIP Trunk использует аутентификацию по списку разрешённых IP, оставьте логин и пароль пустыми.
  • Агент не учитывает изменённые инструкции. Когда появится подсказка Sync, нажмите Sync Agent, чтобы передать их voice-агенту.
  • Агент не может забронировать встречу. Чтобы изменить набор интеграций агента, канал Calls нужно создать заново. Если вы подключили Google Calendar после создания канала, создайте его снова.

Что почитать дальше

Полная документацияПодробнее в документации на docs.mychatbot.app (на английском).