> ## 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.

# Запуск дзвінків через API

> Запустіть дзвінок одразу, щойно лід зʼявився у вашій CRM чи таблиці — без ручного набору.

Якщо ваша команда вручну обдзвонює ліди один за одним, або CRM має запускати дзвінок одразу, щойно зʼявився лід, — ось як це автоматизувати.

Припустимо, у вас є ліди чи рахунки в CRM або Google Таблиці. У кожному рядку — імʼя клієнта, назва компанії, сума заборгованості тощо. Вузол **API Trigger** дозволяє перетворити такий рядок даних на персоналізований дзвінок автоматично.

## Крок 1: Додайте вузол

Натисніть **Додати вузол** і додайте **API Trigger** — верхній варіант у списку. Цей вузол запускає дзвінок і передає ваші дані в агента як `initial_context`.

Це і є суть: замість того, щоб агент ставив базові уточнюючі запитання під час дзвінка на кшталт "як вас звати" чи "скільки ви винні", він вже це знає. У сценарії заборгованості початковий вузол вітає абонента через `{{name}}`, а наступні вузли посилаються на `{{debt_words}}` і `{{min_sum}}`. Нічого з цього не зашито жорстко в агента — усе приходить з виклику API.

<Tip>
  У кожного вузла в правому верхньому куті є посилання на документацію. Якщо застрягли або хочете розібратися глибше в якомусь типі вузла — відкривайте документацію звідти.
</Tip>

## Крок 2: Перевірте передумови

Перш ніж щось запускати:

1. [Підключіть телефонію](/getting-started/connect-telephony) для вихідних дзвінків.
2. Перейдіть у розділ розробника й згенеруйте API-ключ. Він знадобиться в заголовку запиту.

## Крок 3: Знайдіть URL запуску

Відкрийте вузол API Trigger. Побачите два URL:

* **Тестовий URL** запускає останню чернетку.
* **Продакшн URL** запускає опубліковану версію агента.

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

## Крок 4: Надішліть запит

Запустіть дзвінок з Postman чи звідки живе ваш бекенд. У тілі запиту надішліть `phone_number` і `initial_context`:

```bash theme={null}
curl -X POST https://va.ukrgsm.com/api/v1/public/agent/test/{uuid} \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dg_your_api_key" \
  -d '{
    "phone_number": "380501234567",
    "initial_context": {
      "name": "Іван Петренко",
      "debt_words": "6539",
      "min_sum": "1300"
    }
  }'
```

Тіло запиту може приходити з вашої CRM, Google Таблиці чи власного бекенду — звідки завгодно, де живе цей рядок даних.

## Що ви отримаєте

Надішліть запит — і дзвінок піде негайно. Оскільки агент уже мав контекст до початку дзвінка, розмова коротка й конкретна з першої репліки. Жодних уточнюючих запитань, одразу по суті.

## Далі

* **Отримайте ці дані назад автоматично**: наступний крок — [Синхронізація даних через вебхук](/getting-started/send-call-data-with-webhooks) — надсилає все, що агент дізнався за дзвінок, назад у вашу систему, щойно дзвінок завершується.
* **Ще не підключили номер?** Спочатку [Підключення телефонії](/getting-started/connect-telephony) — вихідні дзвінки потребують підключеного провайдера телефонії.
* **Повний довідник ендпоінту**: коди помилок, формат відповіді й вибір конкретної конфігурації телефонії — в [API Trigger](/voice-agent/api-trigger).