> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/types-of-agents/golosovoi-agent/iskhodyashie-zvonki.md).

# Исходящие звонки

Настройка исходящих звонков: обзвон по базе, звонок после переписки и звонок по событию в CRM.

Голосовой агент умеет не только принимать входящие вызовы, но и **звонить клиентам сам**. Управление исходящими звонками собрано на вкладке **Исходящие звонки** (рядом со вкладками «Входящие звонки» и «Админ»).

Есть три сценария исходящих звонков — они отличаются тем, что запускает вызов:

| Сценарий                        | Что запускает звонок                                            | Где настраивается                                                |
| ------------------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------- |
| **Обзвон по базе**              | Список номеров из загруженной таблицы в назначенное время       | Меню **«Обзвон»**                                                |
| **Звонок после общения в чате** | Действие агента в ходе диалога                                  | Действие **«Запланировать исходящий звонок»** в текстовом агенте |
| **Звонок по событию в CRM**     | Событие в подключённой CRM (новая заявка, смена статуса сделки) | Раздел **«Каналы»**                                              |

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FeMsfDtDYWGHesHKUFnE1%2Fimage.png?alt=media&amp;token=c1e2a4e2-e5b5-4c02-9384-2faca02155aa" alt=""><figcaption></figcaption></figure>

### Тестовый звонок

Перед запуском любого сценария удобно проверить, как агент говорит, когда звонит сам. На вкладке **Исходящие звонки** есть блок **«Тестовый звонок от лица ИИ-Агента»**:

* **Номер для звонка** — номер, на который агент позвонит для теста;
* **Номер агента** — линия телефонии, с которой пойдёт вызов;
* **Звонящий агент** — какой голосовой агент будет говорить.

Нажмите **Позвонить** — агент наберёт указанный номер, и вы услышите, как он ведёт разговор.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FRRr4iJ678F3svQ7YjrRS%2Fimage.png?alt=media&amp;token=345e7d2a-057f-42ac-95db-11eb1eae7181" alt=""><figcaption></figcaption></figure>

***

### Сценарий 1. Обзвон по базе

В массовом обзвоне агент сам звонит по списку номеров из загруженной таблицы в назначенное время. Подходит для прозвона холодной базы, напоминаний, реактивации клиентов.

**Где настроить:** меню **«Обзвон»** в левой панели.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FrpfeKYwuOhAKA2tOekWE%2Fimage.png?alt=media&amp;token=5162ed20-3c1b-4de0-bd17-74e9ef76b463" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Выберите голосового агента

В верхней части раздела **«Обзвон»** выберите **Голосового агента**, который будет вести разговоры.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FMU2287yh8FlbS2k2utKd%2Fimage.png?alt=media&amp;token=0faa1030-c76d-4471-86a8-0117313492dd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Создайте задачу обзвона

В блоке **«Создать задачу обзвона»** укажите:

* **Номера для обзвона** — линия телефонии, с которой пойдут вызовы;
* **Дата и время запуска** — когда обзвон должен начаться.

Нажмите **«Создать задачу»**.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FvSt8B6f7uHV3WHb4t1s3%2Fimage.png?alt=media&amp;token=e4d9e8ba-1693-436e-8a6c-ece2e1985187" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Загрузите таблицу с номерами

После создания задача переходит в статус **«Создана»**. Загрузите таблицу для обзвона — файл **.xlsx с двумя столбцами: `телефон` и `контекст`** (до 5 МБ).

* **телефон** — номер клиента;
* **контекст** — индивидуальная вводная для этого номера, которую агент учтёт в разговоре (имя, суть обращения, детали заявки и т.п.).

Чтобы не ошибиться со структурой файла, нажмите **«Скачать шаблон»**, заполните его и загрузите кнопкой **«Загрузить таблицу»**.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FRf2NLD2Jhh2LcymoKvQt%2Fimage.png?alt=media&amp;token=d075d271-ede7-475b-b185-38f96e3ea556" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fdv7HjiQUyfYtfVVy403t%2Fimage.png?alt=media&amp;token=d70dfa07-e992-4a3e-b386-8296ce5cf73b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Следите за статусом

Запущенные и прошлые задачи отображаются в блоке **«История задач»** с их статусами. Отменённую или завершённую задачу можно запустить заново кнопкой **«Перезапустить»**.&#x20;

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FKnXv2KclVw9r0vW33f4B%2Fimage.png?alt=media&amp;token=cf8240b9-2eab-41d0-9c2f-950ce9afccbb" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### Сценарий 2. Исходящий звонок после общения в чате

Клиент пообщался с агентом в чате и оставил номер — агент перезванивает и продолжает тот же разговор, а не начинает с нуля. Звонок планирует сам текстовый агент в ходе диалога, через действие.

**Где настроить:** в текстовом агенте — **Действия → Добавить → Звонки → «Запланировать исходящий звонок»**.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FPM72IIeGKVxG05hFbb4g%2Fimage.png?alt=media&amp;token=d9eec26b-2209-414c-a55c-a18191d4bdb1" alt=""><figcaption></figcaption></figure>

#### **Параметры шага**

**Когда и кому звонить:**

* **Дата-Время звонка** — конкретные дата и время вызова;
* **Смещение запуска (минуты)** — на сколько минут отложить звонок от момента срабатывания действия (альтернатива точной дате);
* **Номер для звонка** — номер клиента; обычно подставляется переменной или аргументом действия, который агент заполняет из переписки;
* **Номер телефона** — линия телефонии, с которой пойдёт вызов;
* **Звонящий агент** — голосовой агент, который будет говорить;
* **Отменить все запланированные звонки** — сбрасывает ранее запланированные для этого клиента вызовы;
* **Уведомлять при неудачном звонке** — оповещение, если дозвониться не удалось.

#### **Контекст, который получит агент при звонке:**

* **Инструкции** — текст, который голосовой агент получит перед разговором: о чём и зачем звонить. Поддерживает переменные и аргументы действия;
* **Добавить саммари диалога** — передать в звонок краткое содержание переписки (разбор ниже).

#### **Действия после завершения звонка:**

* **Добавить саммари звонка** — сохранить краткий итог разговора в диалог;
* **Уведомлять при завершении звонка**;
* **Вызвать текстового бота** — после звонка продолжить общение с клиентом в чате.

{% hint style="info" %}
Настроив параметры, нажмите **«Сохранить»**.
{% endhint %}

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FznveNfFi5OYPOV1jlVwc%2Fimage.png?alt=media&amp;token=180b48d3-2268-4d97-a8ee-d98673248444" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FdMemLCmFEIYm6YSzbwTO%2Fimage.png?alt=media&amp;token=0597e4cc-8130-48ca-9c12-9edd635d59a7" alt=""><figcaption></figcaption></figure>

#### **Как передать в звонок контекст переписки**

Чтобы агент позвонил и заговорил с учётом чата, нужны два тумблера: один в действии, второй в голосовом агенте. Собирать контекст вручную в переменную не нужно.

{% stepper %}
{% step %}

#### Включите саммари диалога в действии

В шаге **«Запланировать исходящий звонок»**, в блоке **«Контекст, который получит агент при звонке»**, включите **«Добавить саммари диалога»**. Раскроются две настройки:

* **Инструкция для саммари диалога** — по какому правилу составлять пересказ. По умолчанию `Make a summary of the dialogue in the language of conversation.` — то есть саммари на языке переписки. Здесь же можно потребовать конкретику: что клиент выбрал, какие были возражения, до чего договорились. Кнопка **«Вернуть значение по умолчанию»** возвращает исходную формулировку;
* **Ограничить количество сообщений для саммари** — по скольким последним сообщениям собирать пересказ (по умолчанию 10, максимум 50). Нужно, когда переписка длинная, а для звонка важен только её финал.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FTRgJoI7ED9h17x65yty5%2Fimage.png?alt=media&amp;token=7b9b3017-5adc-4451-8323-948497ebcef0" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Инструкции** и **саммари диалога** — разные поля, и они друг друга дополняют. В **Инструкциях** вы задаёте цель звонка («уточнить детали заявки и назначить встречу»), саммари подкладывает факты из чата.
{% endhint %}
{% endstep %}

{% step %}

#### Включите генерацию приветствия у голосового агента

Саммари уже уйдёт в звонок, но агент всё равно произнесёт заготовленную фразу приветствия — контекст останется неиспользованным. Поэтому у **голосового агента**, выбранного в поле «Звонящий агент», откройте **Доп. настройки → Голосовой агент** и в блоке **«Приветственное сообщение»** переключитесь с **«Фиксированный текст»** на **«Генерация по инструкции»**.

В поле инструкции опишите, из чего собирать приветствие:

{% code overflow="wrap" %}

```
Приветственное сообщение сгенерируй на основе саммари прошлого диалога и сути запроса клиента.
```

{% endcode %}

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FeXT9p5dG29qMpPx69qog%2Fimage.png?alt=media&amp;token=fbe3c8ea-43dd-4a76-9d03-aebfbed8826f" alt=""><figcaption></figcaption></figure>

Там же проверьте тумблер **«Начинать разговор первым при исходящем звонке»** — если он выключен, агент будет молча ждать реплику клиента и приветствие не прозвучит.

{% hint style="info" %}
В обоих режимах доступны переменные диалога в фигурных скобках, например `{customer_name}`. В режиме генерации фиксированный текст игнорируется, но из поля не пропадает — его можно вернуть, переключив вкладку обратно.
{% endhint %}
{% endstep %}
{% endstepper %}

#### **Что получит голосовой агент**

В начале звонка в диалог добавляются системные сообщения: **Summary of the previous dialogue** с пересказом переписки и текст из поля **Инструкции**. Приветствие агент генерирует уже по ним, поэтому первая же фраза звучит как продолжение чата, а не как холодный звонок.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FKlrJcCDc31nyIXkR2ORa%2Fimage.png?alt=media&amp;token=7a8acfcc-9308-49f4-90bc-a42632d65dad" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Инструкция приветствия — настройка голосового агента, а не конкретного звонка: она сработает на всех его вызовах, включая входящие, где саммари нет. Либо допишите в инструкцию, как здороваться без контекста, либо выделите под перезвоны отдельного голосового агента и укажите его в поле **«Звонящий агент»**.
{% endhint %}

#### **Как использовать переменные действия**

Саммари закрывает вопрос «о чём мы уже говорили». Переменные нужны для другого — когда в звонок надо передать конкретное значение отдельным полем: номер заявки, выбранный тариф, адрес. Такие переменные сначала создаются на вкладке **«Переменные действия»**, в описании нужно объяснить ЛЛМ, что в них записывать, а затем они подставляются в **Инструкции** или в **настройки шага**.

Также через переменные мы указываем, когда и кому именно будет сделан исходящий звонок:

{% stepper %}
{% step %}

#### Создайте переменные для даты/времени звонка и для номера клиента

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F0qSy7a0IbB4kc3gdNSUB%2Fimage.png?alt=media&amp;token=fab84bd9-a953-41d6-9296-e24b279f0ead" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Установите значения в нужные поля

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FUVotfmrVcMiCeWzivTar%2Fimage.png?alt=media&amp;token=57bbc761-8848-4ef6-b32c-dffb8ffda49c" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

Чтобы агент вызывал действие сам, опишите это в его инструкции. Название функции у вас будет своё:

{% code overflow="wrap" %}

```
Если клиент просит звонок от менеджера, получи его номер телефона и вызови функцию schedule_outgoing_call().
```

{% endcode %}

***

### Сценарий 3. Звонок по событию в CRM (на примере Битрикс24)

Звонок запускается автоматически по событию в подключённой CRM — например, при создании новой заявки или переходе сделки на нужный статус. Агент дозванивается до контакта, привязанного к лиду/сделке.

**Где настроить:** раздел **«Каналы»** в Савви + робот с вебхуком на стороне CRM.

{% stepper %}
{% step %}

### Добавьте телефонный номер

Подключите линию телефонии, с которой агент будет звонить (см. шаг «Подключение телефонии» в статье [Голосовой агент](/ru/types-of-agents/golosovoi-agent.md)).&#x20;
{% endstep %}

{% step %}

### Создайте голосового агента

Создайте агента и включите у него голосовые настройки — именно он будет вести разговор при звонке.
{% endstep %}

{% step %}

### Включите звонок в настройках канала

В разделе **«Каналы» подключите вашу СРМ,** откройте настройки и включите исходящий звонок:

* включите тумблер **«Исходящий при создании/изменении статуса лида»**;
* выберите **Номер телефона для звонков** (линию телефонии);
* укажите **Воронку** и **статус**, при переходе на который должен запускаться звонок;
* задайте **Поле телефона у контакта** — откуда брать номер клиента.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F4kzofRpbIZI0t8CW9bKW%2Fimage.png?alt=media&amp;token=f84a22fd-65d6-4684-b34e-1fbde4fdca9c" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Если у вас не Bitrix24, то настройки завершены!

Если у вас Bitrix24, то переходите к настройкам ниже:
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Только для CRM Bitrix24
{% endhint %}

На этой же странице есть кнопка **«Скопировать webhook»** — она понадобится, если вы подключаете Битрикс24.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FTpdmBiJR1L6zyAZKVhYA%2Fimage.png?alt=media&amp;token=e7133b7b-1338-4620-99eb-8d0aa7068e70" alt=""><figcaption></figcaption></figure>

#### Добавьте робота с вебхуком в Битрикс24

На стороне Битрикс24 в нужной воронке откройте **Роботы** → **«+ Создать»** → **«Исходящий Вебхук»**.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FODDGqnQduFFrOLiJi6qh%2Fimage.png?alt=media&amp;token=35a0d6af-b030-40d3-9166-ffa8a2916b66" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fq99KwHZkPDbkgPME4iry%2Fimage.png?alt=media&amp;token=717002e4-eeda-49b5-bf88-4258203183a8" alt=""><figcaption></figcaption></figure>

В настройках робота укажите, **когда** он срабатывает (например, «Сразу» при переходе на статус, при необходимости — с условиями), и вставьте в поле адреса **URL вебхука**, скопированный на предыдущем шаге кнопкой «Скопировать webhook». Он имеет вид:

```
https://<домен>.api.suvvy.ai/api/webhook/bitrix/outbound_call?app_token=…
```

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FFPx2IRJLNcdXG5y3JYJc%2Fimage.png?alt=media&amp;token=ece89bf5-6372-4dce-9db8-7a2dd035fcb4" alt=""><figcaption></figcaption></figure>

Нажмите **«Сохранить»**.

#### Как это работает

Когда лид или сделка создаётся либо переходит на выбранный статус, Битрикс24 вызывает вебхук. После этого агент **пробует позвонить контакту, привязанному к лиду/сделке** — берёт номер из указанного поля контакта.

{% hint style="danger" %}
Если у контакта нет номера телефона или номер некорректный, звонок не состоится.&#x20;
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.suvvy.ai/ru/types-of-agents/golosovoi-agent/iskhodyashie-zvonki.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.