> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ukrgsm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Початок дзвінка

> Вузол «Початок дзвінка» запускає дзвінок і налаштовує, як агент вітає абонента на початку розмови.

<Note>
  На один голосовий агент має бути лише один вузол «Початок дзвінка».
</Note>

«Початок дзвінка» — це точка входу для кожної розмови. Він спрацьовує в момент з'єднання дзвінка й визначає першу репліку агента. Кожен сценарій повинен мати рівно один такий вузол.

## Коли він виконується

«Початок дзвінка» виконується перед будь-яким вузлом агента. Жоден інший вузол не може передувати йому в потоці дзвінка.

Після завершення «Початку дзвінка» розмова переходить до наступного вузла — зазвичай першого вузла агента. Якщо абонент одразу кладе слухавку або виявляється, що номер набрано помилково, «Початок дзвінка» може одразу вести до вузла «Завершення дзвінка».

## Поля

**Назва**

Короткий ідентифікатор, що відображається на полотні та в журналах дзвінків. Не впливає на те, що каже агент.

**Тип привітання**

Чи озвучується необов'язкове привітання через TTS з тексту, чи відтворюється з попередньо записаного аудіофайлу. За замовчуванням — «Текст (TTS)».

**Текст привітання**

Необов'язкова фіксована репліка, що озвучується через TTS одразу після з'єднання дзвінка, ще до початку розмовного ходу ШІ. Підтримує `{{шаблонні_змінні}}`. Залиште порожнім, щоб пропустити привітання й дозволити промпту визначати відкриття розмови.

Наприклад:

```text theme={null}
Вітаю, {{initial_context.name}}, це Олена з відділу підтримки.
```

<Note>
  Щоб використати запис замість тексту TTS, дивіться [Попередньо записане аудіо](./pre-recorded-audio).
</Note>

**Промпт** (обов'язково)

Системні інструкції для першого розмовного ходу ШІ. Виконується після тексту привітання (якщо задано). Підтримує `{{initial_context.назва_поля}}` і змінні з отримання даних перед дзвінком.

Наприклад:

```text theme={null}
Після привітання підтверди, що розмовляєш саме з
{{initial_context.name}}. Якщо підтверджує — перейди до наступного кроку.
Якщо каже, що номер помилковий — перейди до Завершення дзвінка.
```

<Warning>
  Якщо змінна, вказана в тексті привітання чи промпті, відсутня в тілі запиту API, агент вимовляє сам плейсхолдер уголос — наприклад, «Вітаю, `{{initial_context.name}}`» — замість імені абонента. Перед публікацією протестуйте з повним тілом запиту.
</Warning>

**Дозволити переривання**

Якщо увімкнено, абонент може перервати агента посеред репліки. За замовчуванням вимкнено на вузлі «Початок дзвінка».

**Додати глобальний промпт**

Якщо увімкнено і в сценарії є [Глобальний вузол](./global), його промпт додається на початок промпту цього вузла під час виконання. За замовчуванням увімкнено.

**Лише вибір (без власного тексту)**

Якщо увімкнено, модель на цьому кроці не може згенерувати власну репліку — лише обрати один із доступних переходів. Не діє, якщо до вузла прикріплено документи бази знань або інструменти. Детальніше — у [Редагуванні сценарію](/voice-agent/editing-a-workflow#лише-вибір-без-власного-тексту).

**Затримка початку**

Якщо увімкнено, агент чекає перед тим, як заговорити після з'єднання дзвінка. Корисно для вихідних дзвінків, коли співрозмовнику потрібен момент, щоб зорієнтуватися. Тривалість можна задати від 0,1 до 10 секунд.

**Увімкнути видобування змінних**

Якщо увімкнено, після цього кроку запускається прохід LLM для видобування структурованих даних із розмови в `gathered_context`.

**Інструменти**

Функції, які агент може викликати під час вступної репліки. Додаються через вкладку «HTTP & Tools» (HTTP API та вбудовані інструменти) або «MCP» (інструменти MCP-сервера).

**Документи бази знань**

Документи, на які агент може посилатись на цьому кроці. Прикріплюються через «Manage Documents».

**Отримання даних перед дзвінком**

Якщо увімкнено, платформа надсилає POST-запит до зовнішнього API перед початком дзвінка і додає JSON-відповідь до контексту дзвінка як шаблонні змінні.

## Вихідні переходи

«Початок дзвінка» може мати кілька вихідних переходів, кожен зі своєю міткою та умовою простою мовою. LLM читає розмову й обирає перехід, чия умова найкраще відповідає ситуації.

Кожному переходу потрібні дві речі:

* **Мітка:** коротка назва на полотні (задаєте самі)
* **Умова:** інструкція, що каже LLM, коли обирати цей перехід

Типовий «Початок дзвінка» має два переходи:

```text theme={null}
Мітка: "абонент підтвердив"
Умова: "Абонент підтвердив, що це саме та людина, і готовий продовжувати."

Мітка: "помилковий номер"
Умова: "Абонент каже, що номер набрано помилково, просить не телефонувати або відмовляється підтвердити особу."
```

За потреби можна додати більше переходів, якщо вступний хід має розгалужуватись далі.

## Типові помилки

**Порожній текст привітання без промпту.** Якщо і текст привітання, і промпт порожні, агент нічого не каже на початку дзвінка. Абонент чує тишу.

**Плутанина між назвою вузла й іменем, яким представляється агент.** Назва вузла — це мітка на полотні лише для вашого зручності. Ім'я, яким представляється агент, визначається текстом привітання чи промпту, або персоною з [Глобального вузла](./global).

**Додавання другого вузла «Початок дзвінка».** У кожного сценарію одна точка входу. Другий такий вузол призведе до помилки.

## Далі

<CardGroup cols={2}>
  <Card title="Вузол агента" href="./agent">
    Побудуйте основну логіку розмови, що йде після привітання.
  </Card>

  <Card title="Глобальний вузол" href="./global">
    Задайте персону й тон, спільні для всіх вузлів.
  </Card>

  <Card title="Завершення дзвінка" href="./end-call">
    Налаштуйте фінальну репліку агента перед завершенням дзвінка.
  </Card>
</CardGroup>