Skip to main content

​
Рендеринг шаблонів

Шаблонні змінні позначаються синтаксисом {{подвійні_фігурні_дужки}}. Дані беруться з initial_context — заданого через API-тригер, лист кампанії або Отримання даних перед дзвінком, що збагачує контекст на старті дзвінка, — а також, лише в тілах запитів вузла «Вебхук», з gathered_context (змінних, видобутих під час дзвінка). Синтаксис залежить від того, де ви його використовуєте:

​
Промпти вузлів агента

У промпті вузла агента посилайтесь на кожне поле initial_context напряму за назвою. Вкладені значення підтримуються через крапкову нотацію. Приклад: якщо початковий контекст такий
пишіть промпт так, щоб звернутися до імені абонента: Промпт: Ти — Аліса, і зараз розмовляєш з {{user.name}}.
Змінні, видобуті під час дзвінка (gathered_context), недоступні в промптах вузлів агента — промпт може посилатись лише на поля initial_context. Щоб використати видобуті дані, надішліть їх через вузол «Вебхук».

​
Тіло запиту вузла «Вебхук»

При побудові тіла запиту вузла «Вебхук» об’єкти контексту вкладені під своїми назвами, тож звертайтесь до них із префіксами initial_context. та gathered_context.: Значення в тілі запиту: {{initial_context.user.name}} або {{gathered_context.call_disposition}}

​
Використання шаблонних змінних для тестування

Шаблонні змінні, задані в Налаштування сценарію → Контекстні змінні, включаються в тестові дзвінки (веб і телефонні) з редактора сценарію. Це зручно для симуляції даних, що зазвичай надходять через телефонію або API-тригер. Панель шаблонних змінних у налаштуваннях сценарію зі змінною customer_name і полями для додавання нових пар ключ/значення Наприклад, можна задати caller_number і called_number як контекстні змінні, щоб протестувати Отримання даних перед дзвінком без реального вхідного дзвінка.
Ці контекстні змінні використовуються лише під час тестових дзвінків з редактора сценарію. У продакшн-дзвінках (вхідних і вихідних кампаніях) використовуються реальні дані телефонії, а ці значення ігноруються.

​
Вузли

Голосові агенти складаються з різних вузлів. Вони можуть містити інструкції для агента, дозволяти налаштувати API-тригер, яким можна запускати дзвінок, або вебхук, що оновлює результати дзвінка у вашій CRM чи запускає подальший сценарій у n8n. Опис усіх вузлів, які можна використати при побудові голосового агента, — у відповідних сторінках розділу Вузли.