> For the complete documentation index, see [llms.txt](https://docs.intellectdialog.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intellectdialog.com/instrumenty/golosovye-roboty/primer-sborki-golosovogo-robota.md).

# Пример сборки голосового робота

Перед началом должен быть настроен SIP-транк и создан провайдер — см. [Подключение SIP-транка](broken://pages/95fd6b6b887aad2e0a2f40ff0684e8186c57b91d).

## Два типа роботов

Раздел управления голосовыми роботами доступен по ссылке [connect.intellectdialog.com/sip\_trunks](https://connect.intellectdialog.com/sip_trunks).

{% hint style="warning" %}
**Раздел доступен только по прямой ссылке — в меню личного кабинета его нет.** Сохраните ссылку в закладки.
{% endhint %}

Нужно создать **минимум двух роботов**, потому что они выполняют разные задачи:

|                             | Робот «по умолчанию»                | Диалоговые роботы        |
| --------------------------- | ----------------------------------- | ------------------------ |
| Какой по счёту              | первый созданный                    | второй и все последующие |
| Привязка бота (автоворонки) | **нельзя**                          | одна или несколько       |
| Что обрабатывает            | все текстовые рассылки **без тега** | рассылки с тегом запуска |
| Ветвление по ответам        | нет                                 | да                       |

Логика простая: если в рассылке не указан тег — звонок уходит роботу «по умолчанию» и тот просто зачитывает текст. Если тег указан — запускается привязанная к нему автоворонка с полноценным диалогом.

**Робот по умолчанию:**

<figure><img src="https://content.gitbook.com/content/vdtSkqUDuO5XM96AcLMV/blobs/INmZQpbYhYlnPtkd01aN/.gitbook/assets/sborka-01-robot-po-umolchaniyu.png" alt=""><figcaption></figcaption></figure>

**Диалоговый робот с привязкой автоворонки:**

<figure><img src="https://content.gitbook.com/content/vdtSkqUDuO5XM96AcLMV/blobs/ABsWJSiEBiLLz0gSRitA/.gitbook/assets/sborka-02-robot-s-avtovoronkoy.png" alt=""><figcaption></figcaption></figure>

***

## Шаг 1. Настроить бота (автоворонку)

Диалог через голосового робота строится на структуре обычного бота, отдельного «голосового конструктора» нет. Создайте обычную автоворонку и укажите в её настройках:

* **тег запуска** — по нему будет стартовать бот
* **тег для снятия** — если нужно
* **провайдер** — созданный при подключении SIP-транка

Сохраните настройки.

<figure><img src="https://content.gitbook.com/content/vdtSkqUDuO5XM96AcLMV/blobs/6KA0jafAkRWUo6HVsLZF/.gitbook/assets/sborka-03-nastroyki-bota.png" alt=""><figcaption></figcaption></figure>

***

## Шаг 2. Собрать диалог в конструкторе

Перейдите в Конструктор и постройте диалог под задачу клиента.

В примере ниже робот зачитывает приветствие с вопросом, ждёт ответа абонента, и в зависимости от ответа зачитывает один из вариантов текста и завершает разговор.

<figure><img src="https://content.gitbook.com/content/vdtSkqUDuO5XM96AcLMV/blobs/qrNERqfbkahHby8zZM3K/.gitbook/assets/sborka-04-konstruktor-dialoga.png" alt=""><figcaption></figcaption></figure>

***

## Шаг 3. Запустить звонок

Звонок инициируется запуском автоворонки — например, через рассылку командой:

```
/set_tag:тег_указанный_в_боте
```

***

## Определение намерений

Настраивается прямо в боте. Везде, где есть кнопки, включите в них распознавание намерения — тогда робот поймёт ответ абонента, произнесённый свободной формой, а не только дословное совпадение.

<figure><img src="https://content.gitbook.com/content/vdtSkqUDuO5XM96AcLMV/blobs/EoSjoHc2gwkF4TkQK4H2/.gitbook/assets/sborka-05-raspoznavanie-namereniy.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Абонент почти никогда не отвечает так, как написано на кнопке. На «Подтверждаете запись?» приходит «ну да», «ага, буду», «да-да, конечно». Без распознавания намерений все эти ответы улетят в ветку «не распознано».
{% endhint %}

***

## Сохранение ответов в переменные

Если от абонента ожидается произвольный ответ, который нужно сохранить:

1. В нужном месте добавьте кнопку **«Другой вариант ответа»**
2. После кнопки вставьте сообщение
3. В сообщении добавьте действие **«Установить переменную»**

<figure><img src="https://content.gitbook.com/content/vdtSkqUDuO5XM96AcLMV/blobs/RDQhTQ0PVUCV7CdpGFXY/.gitbook/assets/sborka-06-drugoy-variant-otveta.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/vdtSkqUDuO5XM96AcLMV/blobs/v4zLUBlqKFkCvhYyNEPm/.gitbook/assets/sborka-07-ustanovit-peremennuyu.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/vdtSkqUDuO5XM96AcLMV/blobs/Ybw0okbQLiQdbSiIOyYJ/.gitbook/assets/sborka-08-peremennaya-nastroyka.png" alt=""><figcaption></figcaption></figure>

***

## История звонков

Доступна по кнопке **«Выгрузить историю»** в боте.

***

## Рекомендации по составлению текстов

{% hint style="info" %}
Соблюдать не обязательно — робот заработает и без этого. Но правильно составленные фразы заметно сокращают паузы перед репликами робота, и разговор перестаёт звучать рвано.
{% endhint %}

Робот синтезирует речь по предложениям. Чем длиннее и сложнее фраза, тем дольше пауза перед тем, как робот начнёт говорить.

**Два правила:**

1. Длинные сложные фразы разбивайте на несколько коротких. Части, общие для разных клиентов, выносите в отдельные предложения — они кэшируются и произносятся мгновенно.
2. Каждое предложение отделяйте знаком конца предложения: точкой, восклицательным знаком, вопросительным знаком или многоточием.

**Плохо:**

> «Здравствуйте, Иван Иванович, вы записаны на приём к врачу Смирновой Лидии Александровне завтра в 14 часов 00 минут.»

**Хорошо:**

> «Здравствуйте. Иван Иванович. Вы записаны на приём к врачу. Врач Смирнова Лидия Александровна. Время приёма. Завтра в 14 часов 00 минут.»

Дополнительно:

* Числа, даты и время пишите словами или в простом формате — «14 часов 00 минут», а не «14:00»
* Избегайте сокращений и аббревиатур: «улица», а не «ул.»; робот прочитает сокращение буквально
* Не используйте символы, которые нечего произносить: `«»`, `*`, `—`, эмодзи

***

## Чек-лист перед запуском

* [ ] SIP-транк в статусе «Зарегистрирован»
* [ ] Провайдер создан, поля domain / username / password заполнены
* [ ] Создан робот «по умолчанию»
* [ ] Создан диалоговый робот с привязанной автоворонкой
* [ ] В боте указан тег запуска и выбран провайдер
* [ ] В кнопках включено распознавание намерений
* [ ] Тексты разбиты на короткие предложения
* [ ] Сделан тестовый звонок на свой номер, диалог прошёл по всем веткам