# Chat2Desk

Находите диалоги без ответа во всех каналах Chat2Desk

Омниканальная платформа — сообщения, диалоги, каналы (WhatsApp, Telegram и др.)

## Как агент работает с Chat2Desk

Агент работает с API Chat2Desk по адресу api.chat2desk.com/v1: читает карточки клиентов, открытые диалоги и историю переписки, список подключённых каналов, операторов и теги. На этих данных он считает, сколько обращений пришло за сутки и по каким каналам — WhatsApp, Telegram и остальным, — сколько диалогов осталось открытыми и какие из них ждут ответа дольше всех.

Платформа омниканальная, и это меняет разбор: клиент здесь один, а переписка с ним может тянуться сразу в нескольких каналах. Агент находит клиента по номеру телефона и собирает историю целиком, а не по одному чату. «Без ответа» он определяет не по пометке, а по последнему сообщению в диалоге и времени его отправки: диалог остаётся открытым, пока его не закрыли, поэтому одного статуса для отчёта недостаточно.

На запись агент отправляет клиенту сообщение, заводит карточку нового клиента, переводит диалог на другого оператора и закрывает его, когда вопрос решён. Канал он не выбирает произвольно — ответ уходит туда, откуда клиент написал. По умолчанию агент работает на чтение и разбор, а перед отправкой показывает получателя и текст, чтобы сообщение клиенту не ушло без вашего согласия.

Токен аккаунта открывает агенту все подключённые каналы сразу, а не один мессенджер, поэтому границу выборки задаёт не ключ, а фильтр по каналу и периоду. Клиентов и сообщения API отдаёт страницами, и разбор недели на большой базе — это десятки запросов, а лимит здесь один на весь аккаунт: 100 000 вызовов в месяц на всех тарифах. Поэтому агент выдерживает частоту и читает выборкой под задачу, а если данных за период нет, говорит об этом прямо, а не показывает пустую таблицу.

## Сценарии интеграции

### Диалоги без ответа
Агент пройдёт по открытым диалогам всех подключённых каналов и покажет, какие обращения висят без ответа дольше остальных.

### История переписки с клиентом
Агент найдёт клиента по номеру телефона, поднимет историю диалога и перескажет, о чём договорились, не открывая чат вручную.

### Ответ и маршрутизация диалога
Агент отправит клиенту сообщение в его канал, переведёт диалог на нужного оператора или закроет его, когда вопрос решён.

### Сводка обращений за сутки
Агент посчитает, сколько обращений пришло за сутки и по каким каналам — WhatsApp, Telegram и остальным — и сколько диалогов осталось открытыми.

### Кто из операторов перегружен
Агент разложит открытые и закрытые диалоги по операторам и покажет, у кого очередь длиннее и чьих ответов клиенты ждут дольше всего.

### О чём пишут чаще всего
Агент соберёт теги диалогов за период и покажет, какие темы обращений выросли, а какие сошли на нет — отдельно по каждому подключённому каналу.

## Как подключить

**Перед подключением**

- Права администратора аккаунта Chat2Desk
- Общий API-токен аккаунта, а не токен отдельного канала
- Запас в лимите 100 000 запросов к API в месяц

### Войдите в Chat2Desk под администратором
Токен доступен только администратору аккаунта: у оператора и супервайзера нужного раздела в меню нет. Вход — на chat2desk.com логином и паролем аккаунта.

### Откройте «API и скрипты» → «API»
В меню «Настройки» → «API и скрипты» → «API» живёт единственный токен для внешних систем. Токен Telegram или другого канала из настроек канала не подойдёт.

### Нажмите «Показать» и скопируйте токен
Значение скрыто по умолчанию; кнопка «Показать» раскрывает его целиком. Копируйте строку без пробелов по краям — она передаётся как есть, без префикса Bearer.

### Проверьте остаток API-запросов
Рядом с токеном видно, сколько вызовов доступно и потрачено в этом месяце: во все тарифы входит 100 000 запросов. Новый токен мгновенно гасит прежний.

## Частые вопросы

### Как подключить Chat2Desk?
API-токеном аккаунта: войдите администратором, откройте «Настройки» → «API и скрипты» → «API», нажмите «Показать» и скопируйте строку. Токен отдельного канала не подойдёт — нужен общий токен аккаунта.

### Что агент видит в Chat2Desk?
Подключённые каналы, карточки клиентов, открытые диалоги и историю переписки, операторов и теги — в объёме, который открывает API-токен аккаунта.

### Пишет ли агент в Chat2Desk?
Может: отправить сообщение клиенту, завести карточку клиента, перевести диалог на другого оператора и закрыть диалог. По умолчанию работает на чтение и разбор.

### Есть ли лимит на запросы к API?
Во все тарифы входит 100 000 вызовов в месяц, остаток показан на той же странице, где лежит токен. Генерация нового токена мгновенно гасит прежний.

[Открыть Chat2Desk](https://chat2desk.com)
