> Усі статті WIKI Helomi: /wiki/llms.txt

# Переписки

Переписки — один список усіх чатів з клієнтами з різних каналів: OLX, Telegram, Prom, Rozetka, Viber і чатів на сайтах. Менеджер бачить, де клієнт чекає відповіді, відповідає звідси ж у той самий канал, розкладає чати по папках і користується збереженими шаблонами відповідей.

## Можливості
- Канали: OLX, Telegram, Prom, Rozetka, Viber, сайти; лічильники по кожному джерелу.
- Два режими: по джерелах або всі підряд — за часом останнього повідомлення.
- Будь-який чат відкривається в новій вкладці (Ctrl-клік, середня кнопка, правий клік) — у кожного своя адреса.
- «Непрочитано» — остання репліка від клієнта без відповіді і без позначки «Оброблено».
- Відповідь клієнту в той самий канал.
- Особисті папки з можливістю поділитися.
- Збережені шаблони відповідей.
- Доступ людей до окремих каналів.
- Стан підключення кожного каналу (живий чи з помилкою).

## 1. Налаштування
- **Канали** підключаються в «Інтеграціях» (Telegram, Viber, OLX, Prom, Rozetka, сайти) — див. статті цих інтеграцій. Для Rozetka чати «запитання до продавця» вмикаються в «Налаштування продажів» картки Rozetka.
- **Доступ до розділу** — галочка «Переписки» у «Налаштування → Розділи меню».
- **Доступ до каналів по людях** — там само, у «Розділах меню» (канали «Переписок»). Поки адміністратор не обмежив людину, вона бачить усі канали; адміністратор бачить усі завжди.
- Розділ працює на ключах сервера й даних першої організації: в інших організаціях платформи він поки закритий навіть адміністратору.

## 2. Знайти чат, що чекає відповіді
1. Відкрийте «Переписки».
2. Виберіть джерело або всі підряд. Чати, що чекають відповіді, позначено як непрочитані.
3. Пошук — за іменем, телефоном або текстом.
4. Щоб відкрити чат у новій вкладці, натисніть рядок із затиснутим Ctrl (на Mac — ⌘), середньою кнопкою миші або правою
   кнопкою → «Відкрити посилання в новій вкладці». Кожен чат має свою адресу (`/inbox/<номер чату>`), тож вкладку можна
   оновити чи надіслати колезі. Звичайний клік відкриває чат праворуч, як і раніше. Кнопка «✓» у рядку лише знімає позначку
   «без відповіді» і чат не відкриває.

## 3. Відповісти клієнту
1. Відкрийте чат.
2. Напишіть текст у полі внизу і натисніть «Надіслати». Повідомлення піде в той самий канал (Telegram, Viber, Prom, Rozetka, OLX чи сайт).
3. Для OLX і Viber відповідь іде через чергу зовнішнього сервісу каналу — вона з'явиться в клієнта після наступного прогону сервісу.

На телефоні поле відповіді — скляна смуга внизу з чорною «Надіслати»; при відкритій клавіатурі нижнє меню й кнопка ШІ ховаються.

## 4. Оброблено, заглушити
- «Оброблено» — чат більше не рахується непрочитаним, хоча відповіді в канал не було.
- «Заглушити» — чат не турбує сповіщеннями; повторна дія розглушує.

## 5. Папки
Створіть особисту папку, додавайте в неї чати, перейменовуйте, видаляйте. Папкою можна поділитися з колегами.

## 6. Шаблони відповідей
Збережіть типову відповідь шаблоном і вставляйте її в поле відповіді. Шаблони можна змінювати й видаляти.

## 7. Переписки з картки угоди
У картці угоди вкладка «Чати» відкриває «Переписки» з пошуком за телефоном клієнта угоди.

## 8. Номер замовлення відкриває угоду
У чатах Prom і Rozetka номер замовлення — посилання. Він є в трьох місцях: у панелі «Про клієнта» (рядок «Номер»), у шапці чату і в рядку списку чатів. Натисніть номер — у новій вкладці відкриється угода цього замовлення в розділі «Угоди». Клік по номеру в списку не відкриває сам чат.

Угода шукається так само, як приймання замовлень уникає дублів: спершу за полем «№ замовлення» угоди, потім за назвою угоди серед угод джерела Prom чи Rozetka. У мобільному застосунку угода відкривається в тому самому вікні — кнопка «Назад» повертає до чату. Для чатів інших каналів номер лишається текстом.

Доручити чат ШІ-співробітнику прямо зі сторінки «Переписок» поки не можна.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| Каналу нема в списку | Канал не підключено або вам закрито доступ до нього | Підключіть канал в «Інтеграціях» або попросіть доступ |
| Канал позначено помилкою | Сервіс каналу давно не надсилав пульс | Перевірте підключення в «Інтеграціях» |
| Відповідь не дійшла в OLX чи Viber | Черга зовнішнього сервісу ще не оброблена або повернула помилку | Зачекайте прогону сервісу; перевірте його стан |
| Номер замовлення відкрив «Угоди із замовленням … не знайдено» | Замовлення ще не прийшло з майданчика, або угоду створено вручну з іншою назвою без поля «№ замовлення» | Зачекайте кілька хвилин; знайдіть угоду пошуком в «Угодах» і впишіть номер у її назву або поле «№ замовлення» |
| Номер відкрив «Немає доступу до воронки» | Угода в воронці, яку вам не відкрито | Попросіть адміністратора відкрити воронку в «Налаштуваннях → Воронки» |
| Розділу нема в меню | Розділ закритий у вашій організації або не відкрито доступ | Зверніться до адміністратора |

## Для ШІ-співробітників
5`. Надсилання клієнтам належить до дій, що **спочатку запитують** людину (вид `outbound`), коли такі інструменти з'являться.

Зовнішні сервіси каналів передають чати через `POST /api/inbox/ingest` з ключем `X-Inbox-Key` — це шлях для програм-полерів, а не для ШІ-співробітників.

## Додаткова інформація
- Пов'язані статті: [Угоди](deals.md), [Клієнти](clients.md); інтеграції Telegram, Viber, OLX, сайти — статті `int-*`.