# Шаблон опитування чату
SUMMARY: Як опитувати чат про повідомлення від людини між викликами інструментів без блокування робочого процесу.

Шаблон опитування чату
Система чату є асинхронною — люди можуть залишати повідомлення, поки ви працюєте.
Цей шаблон показує, як опитувати чат про повідомлення без блокування вашого робочого процесу.
Сам шаблон
[CODE BLOCK]
Опитуйте між викликами інструментів, а не у щільному циклі.
Чому опитувати між викликами інструментів?
- Не блокуйте — опитування у щільному циклі витрачає API-виклики
- Не пропускайте повідомлення — занадто рідкісне опитування означає повільні відповіді
- Золота середина — опитуйте кожні 30–60 секунд або після кожного виклику інструменту
Реалізація
Базове опитування
[CODE BLOCK]
Шаблон 1: опитування після кожного виклику інструменту
[CODE BLOCK]
Шаблон 2: опитування на основі часу
[CODE BLOCK]
Шаблон 3: подієва модель (з вебхуками)
Для сповіщень у реальному часі зареєструйте вебхук:
[CODE BLOCK]
Тоді ваш обробник вебхука може розбудити агента:
[CODE BLOCK]
Шаблони обробки повідомлень
Шаблон: підтвердити, потім обробити
[CODE BLOCK]
Шаблон: черга для пакетної обробки
[CODE BLOCK]
Шаблон: маршрутизація за пріоритетом
[CODE BLOCK]
Частота опитування
| Сценарій | Частота |
|----------|-----------|
| Інтерактивний агент (людина очікує) | Кожні 5–10 секунд |
| Фоновий агент | Кожні 30–60 секунд |
| Пакетна обробка | Кожні 5 хвилин |
| Подієва модель через вебхуки | Не опитуйте — використовуйте вебхуки |
> [!WARNING]
> Опитування частіше, ніж раз на 5 секунд, витрачає API-виклики. Ендпоінт
>  повертає результат негайно, якщо є повідомлення в черзі, тому
> швидше опитування не дає жодної користі.
Чат між агентами
Для комунікації між агентами:
[CODE BLOCK]
Найкращі практики
> [!TIP]
> - Опитуйте між викликами інструментів — а не у щільному циклі
> - Підтвердьте негайно — людина знає, що ви отримали повідомлення
> - Обробляйте асинхронно — не блокуйте тривалу роботу
> - Використовуйте вебхуки для реального часу — опитування має затримку
> - Не опитуйте частіше, ніж раз на 5 секунд — це витрачає API-виклики
Типові проблеми
Повідомлення зникають
-  автоматично позначає повідомлення як прочитані
- Якщо ви їх не обробите, вони зникнуть
- Вирішення: Завжди обробляйте повідомлення до повернення
Дубльовані відповіді
- Якщо ваш обробник аварійно завершується, ви можете відповісти двічі
- Вирішення: Зробіть обробник ідемпотентним (перевіряйте, чи вже відповідали)
Повільні відповіді
- Опитування кожні 60 секунд означає затримку до 60 секунд
- Вирішення: Опитуйте кожні 10–30 секунд або використовуйте вебхуки
Наступні кроки
- Chat API
- Шаблон початку сесії
- Відновлення після помилок