---
title: "Реліз 5.16.0"
description: "Context API віддає стислий контекст клієнта, тематики, оператора чи скіл-групи без зміни картки CRM; у сценарії — дві нові дії запису й підтягування контексту; Telegram коректно обробляє конвертацію групи в супергрупу; пошук у сайдбарі тестового прогону Редактора сценаріїв."
---

# Реліз 5.16.0

Головне в цьому релізі — **Context API другого покоління**: інтеграція більше не збирає сама розкидані дані про клієнта, а запитує стислий пакет — що відбувається зараз, які події вже зареєстровані, що відомо про людину чи тематику, на які уривки звернень можна послатися. У сценарії з'явилися дві вбудовані дії, які працюють із цим контекстом, не чіпаючи картку CRM. Окремо реліз закриває давню проблему каналу Telegram: коли групу конвертують у супергрупу, повідомлення тепер ідуть на правильний ідентифікатор чату, а не губляться. Додатково в Редакторі сценаріїв зручніше шукати потрібний крок у деталях тестового прогону.

## Інтеграції

**Додано**

- **Стислий контекст однієї сутності.** Context API можна запитати для клієнта, тематики, оператора або скіл-групи. У відповіді — стан «зараз», журнал уже зареєстрованих подій, дозволені поля й короткі уривки звернень, на які можна послатися. Повної історії чатів у цьому пакеті немає.
- **Запис події й стану окремо від CRM.** Інтеграція реєструє, наприклад, «оформив замовлення» і етап покупки у своїй групі даних. Картка клієнта, статус звернення й черга від цього не змінюються.
- **Повтор команди не множить подію.** Ту саму команду запису можна безпечно надіслати ще раз — лишається один запис. Інше тіло під тим самим ключем система відхиляє.
- **MCP-інструменти для читання контексту.** Читають той самий пакет для клієнта, тематики, оператора й скіл-групи. Запису через MCP немає.

## Редактор сценаріїв

**Додано**

- **Дія «Зафіксувати подію клієнта».** З кроку сценарію записує подію клієнта в Context API і за потреби оновлює стан. У наявні боти сама не додається — її додає розробник сценарію там, де це потрібно.
- **Дія «Підтягнути зовнішній контекст».** Звертається до дозволеної зовнішньої системи і зберігає відповідь у контексті клієнта — на відміну від звичайного запиту до зовнішнього сервісу, ця дія одразу кладе результат у контекст, готовий для подальшого читання.
- **Внутрішня подія «Оцінку AI QA завершено» у стартовій ноді.** Раніше, щоб зреагувати на результат AI-оцінки якості діалогу, інтеграції доводилось опитувати оцінки окремо або чекати на закриття чату. Тепер стартова нода може підписатись на подію, яка запускається одразу після успішного завершення AI-оцінки, з балом і коротким змістом. Подія не спрацьовує, якщо оцінка завершилась невдало; повторна успішна оцінка того самого діалогу запускає сценарій знову.
- **Пошук у сайдбарі «Деталі виконання» тестового прогону.** Щоб знайти потрібний крок у довгому тестовому прогоні, раніше доводилось гортати список вручну. Тепер над послідовністю виконання є поле пошуку за назвою кроку чи ID (запит `#12` шукає точно за ID), фільтр за типом блоку, перехід по збігах стрілками або Enter/Shift+Enter із урахуванням повторів ноди, а кроки блоків, яких уже немає в сценарії, позначені окремо.

## Канали

**Виправлено**

- **Telegram: коректна обробка конвертації групи в супергрупу.** Коли адміністратор конвертує групу Telegram у супергрупу, месенджер змінює ідентифікатор чату. Раніше система продовжувала слати повідомлення на старий ідентифікатор (у чаті з'являлись службові помилки Telegram), а вхідні повідомлення з нового ідентифікатора створювали в операторській панелі дублікат клієнта й діалогу. Тепер система розпізнає таку конвертацію і переносить діалог на новий ідентифікатор без втрати історії, а в діалозі з'являється системне повідомлення про причину зміни.

  Якщо дублікат діалогу вже виник до цього виправлення (група була сконвертована раніше), стара картка діалогу акуратно закривається із системним повідомленням-посиланням на діалог-наступник — без розсилки клієнту про закриття і без впливу на оцінку якості цього діалогу.

## Налаштування

**Покращено**

- **Сторінка готовності нового пошуку та Context API** тепер показує фактичний стан підключення, а не лише те, що налаштування ввімкнено: видно, чи готові контекст клієнта, тематики, оператора й скіл-групи, і чи підключені до них AI-функції (типово ще ні).

## Стабільність і внутрішні покращення

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

## Зверніть увагу

- **Context API** і новий пошук вмикаються налаштуваннями інстансу. Доки сховище контексту не готове, запити не проходять — тихого відкату на старий формат немає.
- **Copilot і Fast Line Pro** самі в Context API не звертаються. Підключення AI-функцій до контексту — окреме рішення, цей реліз його не вмикає.
- Репліка клієнта на кшталт «я оплатив» лишається звичайним уривком чату. Підтвердженою подією оплати вона стає лише тоді, коли інтеграція чи сценарій реєструє цю подію окремо через нову дію.
- Дублікати клієнтських карток, що виникли через конвертацію Telegram-групи ще до цього релізу, автоматично не зливаються — за потреби скористайтесь воркбенчем «Дедуплікація клієнтів».
- Пошук у деталях тестового прогону Редактора сценаріїв доступний одразу, без окремого налаштування.

## Пов'язана документація

- [Що таке Context API](/uk/integrations/explanation/what-is-context-api.md)
- [Довідник Context API](/uk/integrations/reference/context-api.md)
- [Дія «Зафіксувати подію клієнта»](/uk/actionjail/reference/actions/register_client_context.md)
- [Дія «Підтягнути зовнішній контекст»](/uk/actionjail/reference/actions/load_external_context.md)
- [Як відреагувати на готову AI-оцінку якості](/uk/scenariobuilder/how-to/react-to-ai-qa-assessment.md)
- [Довідник внутрішніх подій](/uk/scenariobuilder/reference/internal-events-trigger-reference.md)
- [Перевірити сценарій тестовим прогоном](/uk/scenariobuilder/how-to/test-scenario.md)
- [Підключити Telegram](/uk/channels/how-to/connect-telegram.md)