ИЗИ чат-бокс

ЧАТ-БОКС

платформа для всех мессенджеров в одном месте

Вход в панель

Войдите по корпоративной почте и паролю

Электронная почта

Пароль

Электронная почта

Имя в системе

Пароль

Повтор пароля

Только для первого запуска: создаётся администратор. Сотрудников потом добавляет админ в «Команда».

Диалоги

0 выбрано

Теги задач

Теги и папки по тегам можно привязать к группе сотрудников — тогда их видит только эта группа (+ общие теги без группы). Повесить тег на чат: «Чаты» → диалог → ⋮ → «Теги чата».

Папки по тегам

Мини-папка в списке «Чаты»: показывает все диалоги с выбранным тегом. Создать: у тега выше — «Сделать папкой» или форма ниже. Удалить: кнопка Удалить в списке ниже, либо в чатах ⋮ → Настроить папки — ✕ на мини-папке. Чаты в папку не перетаскиваются: откройте чат → ⋮ → отметьте тег.

Шаблоны ответов

В чате введите - и начало команды или текста — появится список. Личные — только у вас. Для группы — видят сотрудники вашей группы.

Личный Для группы

Команда Название шаблона Текст сообщения

Папки в «Чатах»

Отметьте каналы, которые нужны вам в списке диалогов (Avito, HH, amoCRM и т.д.). Скрытые папки не удаляют данные — только убирают вкладки сверху. Настройки интеграций для админа остаются в разделе «Настройки → Интеграции».

Сотрудники

Права на разделы и каналы, группы отделов, общие линии Mango и Telegram. Обновление статусов — каждые 20 с.

Линии и общие ресурсы

Один номер или Telegram на нескольких сотрудников

Telegram-боты

Несколько ботов на одном домене: у каждого свой вебхук и привязка к группе сотрудников. Без группы — видят все операторы с каналом «Telegram (бот)».

Диагностика и деплой

Проверка, что на сервере актуальная сборка, и сбор статистики медленных запросов (после перезапуска omnichat счётчики с нуля).

Версия на сервере

—

Открыть Ops-дашборд

Live-мониторинг: алерты, нагрузка API, интеграции, улучшения — https://easychatbox.ru/ops (только админ).

Нагрузка и «зависания»

Медленные API (≥2 с) и фоновые опросы Avito/amo. Рост slow_count у GET /api/conversations или …/messages — узкое место в базе или на сервере.

Нажмите «Обновить статистику»

Мессенджеры и линии

Общие линии операторов, Telegram-боты групп, статус личного TG/MAX у сотрудников.

Нажмите «Обновить мессенджеры»

amoCRM

Двусторонняя синхронизация: входящие из Telegram/VK/MAX → сделка и примечание в amoCRM; сделки в выбранной воронке/статусе → чаты в «Чат-боксе» (канал amoCRM); ваши ответы в чате → примечание в amoCRM (и в мессенджер, если диалог не только из amo). Примечания, добавленные в amoCRM, подтягиваются в чат автоматически (опрос каждые 60 с).

Redirect URL в форме amoCRM: платформа проверяет адрес с интернета — 127.0.0.1 не подойдёт. Запустите ngrok http 8000, укажите публичную базу в «Мессенджеры → Telegram → Публичная база», затем вставьте в amoCRM:

Локальный URL (только справка):

Поддомен amoCRM

Client ID интеграции

Client secret

Access token (долгосрочный или OAuth)

Копируйте «Долгосрочный токен» (начинается с eyJ…), не «Код авторизации». Пустое поле при «Сохранить» — токен в БД не меняется.

Воронка amoCRM (откуда подтягивать сделки в чат)

Статус в воронке

Поля карточки amoCRM в чате

Через запятую: какие поля показывать и в каком порядке (сверху вниз). Пример: Проект, Источник, Офис. Пусто — все поля. Личный порядок каждому менеджеру: стрелки ↑↓ в окне «Изменить amoCRM».

Скрытые поля (не показывать ни в форме «Изменить», ни в карточке)

Очистите поле или удалите нужные элементы списка, затем сохраните настройки — поле вернётся.

Создавать сделку в amoCRM при первом входящем сообщении Автоматически подтягивать новые сделки из amoCRM (каждые ~3 мин)

Лимит amo: 7 запросов/сек на интеграцию — не жмите «Синхр.» часто. Автоподтягивание безопасно.

Сделки в этом статусе появятся в «Чаты» с каналом amoCRM. Новые сделки из мессенджеров тоже создаются в этой воронке/статусе.

Потребность · Google-таблица

Отдельная интеграция: в карточке отклика Avito и HeadHunter показываем, есть ли потребность по адресу вакансии (строка из таблицы «Метро» / «Ресторан» / «Адрес»). На загрузку откликов не влияет.

Ссылки на таблицу (по одной в строке, с gid листа)

Таблица должна быть доступна по ссылке: Файл → Доступ → все с интернетом (читатель). Укажите ссылку на каждый лист с gid= — не только на всю книгу.

Avito · отклики на вакансии

Только отклики на вакансии → карточки в «Чаты» (канал Avito) с ФИО и телефоном. Авто-тег по ID вакансии, кнопка «Написать в Telegram» — после старта переписки карточка уходит в архив с тегом «В работе». Новые отклики подтягиваются вебхуком или автоматическим опросом API каждую минуту (IZ_AVITO_POLLING=1).

Важно: Client ID и secret должны быть от приложения в кабинете разработчика, привязанного к тому же бизнес-аккаунту Avito, где размещены вакансии. В приложении включите scope job:cv, job:negotiations, messenger:read и messenger:write (чат Avito — тариф «Максимальный» для «Работа»). Если в Avito отклики есть, а «Проверить подключение» пишет 0 — API их не видит (другой аккаунт или нет прав).

Публичный HTTPS-сервер — тот же, что для amoCRM и Telegram: укажите базу в «Мессенджеры → Telegram → Публичная база», затем «Зарегистрировать вебхук Avito». URL для справки:

Client ID (Собственная разработка)

Client secret

ID аккаунта Avito (user_id для Messenger)

Числовой ID кабинета, с которого размещены вакансии. Нужен для «Написать в Avito».

Секрет вебхука откликов (необязательно)

Тег по умолчанию (если вакансия не в списке ниже)

Тег «В работе» (после старта Telegram)

Теги по вакансиям (JSON: ID вакансии → название тега)

ID вакансии — в URL объявления на Avito. Тег создаётся автоматически, если ещё нет в списке тегов.

Сравнение адреса вакансии с таблицей потребности — в разделе .

«Синхр. отклики» — только API Avito и мессенджер (как в приложении Avito). Google-таблица для откликов не используется.

HeadHunter · отклики

Отклики с hh.ru → папка HeadHunter в «Чаты». Телефон подтягивается из резюме (отдельный запрос к API, может списывать контакт HH). Telegram — по номеру через личный TG оператора и @ из резюме, если указан. Опрос: IZ_HH_POLLING=1 (каждые ~2 мин). Документация API.

OAuth — Client ID и secret из кабинета разработчика.

Важно: в поле Redirect URI ниже должно быть то же, что в заявке HH (у вас обычно https://easychatbox.ru/ — со слэшем в конце, без /oauth/callback).
После «Проверить» нужны все три: ID, secret (нажмите «Сохранить») и access token (код → «Обменять код»).

Открыть авторизацию HH

Client ID

Client secret

Redirect URI — как в заявке HH (буква в букву)

Код авторизации (из URL после «Продолжить» в HH)

Access token (или получите через «Обменять код»)

Refresh token

ID работодателя (опционально)

Тег по умолчанию

Теги по вакансиям (JSON: ID → название тега)

Mango Office · телефония

Исходящий звонок из карточки Avito, amoCRM или связанного Telegram. В кабинете Mango: Интеграции → API коннектор — код АТС и ключ подписи. На вкладке «Операторы ВАТС» укажите внутренний номер для каждой линии. Mango сначала звонит сотруднику, затем соединяет с клиентом.

URL API (обычно не менять)

Код АТС (vpbx_api_key)

Ключ подписи (salt)

Webhook в Mango Office

Внешние системы и API коннектор — один и тот же базовый адрес:

Mango сам добавляет пути: /events/call, /events/summary, /result/callback. Не пишите /events в конце — иначе события уйдут на …/events/events/call и не дойдут.

Куда Mango реально шлёт (для справки):

В «Внешних системах» включите «Настроить отправку событий по звонкам», промежуточные статусы и итог (summary). Код АТС и ключ подписи = поля выше. Софтфон на внутреннем (999) должен быть включён.

Диагностика webhook

Если в карточке всегда «Нет ответа на внутр. …» — Mango не присылает события или сервер отклоняет их (403). Тест Mango «проверка связи» только проверяет HTTPS, не подпись.

Шаг 2 — номера сотрудников: нажмите «Список сотрудников ВАТС», скопируйте extension (внутренний номер) и вставьте на вкладке у нужной линии. Без этого кнопки «📞 Позвонить» в чатах не появятся.

Линии операторов для чатов и звонков Mango. У каждой линии укажите внутренний номер в ВАТС (extension).

Данные на вашем сервере: История, токены и вложения (до 20 МБ) — в папке data/ на сервере (БД + data/media/). Используйте HTTPS, ограничьте доступ и делайте бэкапы.

Статистика нагрузки и проверка деплоя — в .

Очистка вложений на диске

Удаляются только файлы в data/media/ (фото, документы). Текст переписки в базе сохраняется. Личные чаты, группы Telegram и Avito — одинаково. В amoCRM уже ушедшие примечания не затрагиваются.

Удалять файлы старше дней (0 = не удалять автоматически)

Telegram

Каналы: Telegram / ВК / MAX. Яндекс — Телемост (встречи) и бот Мессенджера (внутренний, для сотрудников).

Telegram-бот (Bot API + вебхук)

Клиент пишет боту в приложении или веб-клиенте. Сервер принимает обновления по HTTPS-вебхуку (тексты и нажатия inline-кнопок). Ответ из панели уходит в тот же диалог от имени бота — оператор подключается к переписке «бот ↔ клиент».

В @BotFather создайте бота и скопируйте ключ API (токен вида 123456789:AA…) — это не IP сервера, а секретный ключ бота.
Вставьте ключ ниже и нажмите «Сохранить ключ» — сервер сразу спросит Telegram, подлинный ли ключ, и покажет статус здесь и в зелёном блоке выше.
Для входящих от клиентов: либо публичный HTTPS (VPS, ngrok) — база URL и «Повесить вебхук Telegram», либо на сервере long polling (IZ_TELEGRAM_POLLING=1) — тогда вебхук не нужен.
Клиент открывает чат с ботом (приложение или Telegram Web) — его сообщения приходят сюда; ваш ответ уходит от имени бота, не с «личного номера компании».

Почему бот «молчит» в списке чатов: Telegram шлёт входящие только на ваш вебхук по HTTPS. Если панель открыта с http://127.0.0.1:8000, сервер из интернета недоступен — сначала поднимите туннель (ngrok, cloudflared) или VPS с доменом, в поле базы укажите тот же https://…, затем «Сохранить базу» и «Повесить вебхук». Ниже кнопка «Статус вебхука» покажет, что видит Telegram.

Как проверить канал в списке чатов
· После QR: «Чат-бокс» → «Синхр. личные чаты» — подтянутся диалоги и фото контактов из Telegram.
· Свой бот: сохраните ключ API, базу HTTPS и «Повесить вебхук» (или polling на сервере), затем напишите боту из Telegram — новый диалог будет с каналом telegram и бейджем «Telegram (бот)».
· Свой личный аккаунт: блок ниже (api_id / api_hash + QR) — входящие пойдут как telegram_user («Telegram (ваш номер)»).

Ключ API бота (токен от @BotFather)

Публичный адрес сервера (HTTPS)

Нужен для входа сотрудников, вебхуков Telegram/VK/MAX и amoCRM. Пример: https://chat.easyrecruit.ru или ngrok.

Локальные URL (для справки):

Публичный вебхук Telegram:

QR — открыть чат с ботом (для клиента / кандидата):

Личный Telegram (QR, не бот)

На телефоне: Настройки → Устройства → Подключить устройство — отсканируйте QR ниже. После входа нажмите «Синхронизировать диалоги», чтобы чаты появились в «Чат-боксе».

Отдельный канал в списке чатов: переписка с клиентом идёт с вашего личного аккаунта (MTProto / Telethon). Подключение — сканирование QR-кода в разделе ниже (как «Подключить устройство» в Telegram). У каждого сотрудника свой QR: api_id и api_hash задаёт администратор один раз; после регистрации по почте каждый оператор открывает «Мессенджеры» и сканирует QR со своего телефона — в чатах видны только его личные диалоги.

Чтобы писать с вашего номера / аккаунта, используется протокол как у Telegram Desktop (Telethon). Отсканируйте QR в приложении Telegram на телефоне: «Настройки → Устройства → Подключить устройство». Файл сессии на сервере = полный доступ к аккаунту. Только свой сервер / VPN. См. my.telegram.org/apps (api_id, api_hash).

api_id

api_hash

Чат с чужим ботом (@BotFather и др.) с вашего личного номера: писать и нажимать кнопки в «Чат-боксе».

QR для входа (tg://login…):

Сообщения сообщества ВКонтакте: Callback API → URL вебхука ниже. Код подтверждения и секретный ключ из настроек VK.

Строка подтверждения

Секретный ключ

Личный MAX (QR, не бот)

В приложении MAX на телефоне откройте вход по QR (как web.max.ru) и отсканируйте код ниже. После входа нажмите «Синхронизировать диалоги» — личные чаты и группы появятся в папке MAX.

Личные переписки менеджера из MAX (как Telegram usergram). На сервере IZ_MAX_USER_ENABLED=1. Доступ сотруднику — галочка MAX · личный в «Команда» при создании/правке (опционально старый allowlist IZ_MAX_USER_OPERATORS). У каждого сотрудника свой QR — видны только его диалоги.

Неофициальный API (PyMax). Сессия на сервере = полный доступ к аккаунту MAX. Рекомендуется тестовый аккаунт.

QR для входа:

MAX-бот (Bot API + вебхук)

Как это устроено: официальный чат-бот MAX — клиент пишет боту, оператор отвечает здесь. Для личных чатов без бота — блок «Личный MAX» выше.

Настройка: токен на business.max.ru → Чат-боты → Интеграция; на сервере — HTTPS-вебхук или для локальной разработки переменная IZ_MAX_POLLING=1 (long polling, вебхук при этом снимается).

Локальный URL вебхука

Публичный URL вебхука (после сохранения базы HTTPS)

Токен бота MAX

Секрет вебхука (рекомендуется)

Тот же секрет уйдёт в MAX при подписке на вебхук; платформа пришлёт его в заголовке X-Max-Bot-Api-Secret. Оставьте поле пустым при сохранении, если секрет менять не нужно.

Сбросить сохранённый секрет вебхука

Личный WhatsApp (QR, как web.whatsapp.com)

Отсканируйте QR телефоном (WhatsApp → Связанные устройства) — как веб-версия. На общей линии сессия общая для сотрудников линии.

Без платных ключей: на сервере крутится локальный сервис services/whatsapp-web (Baileys). В «Команда» — галочка WhatsApp · личный. Опционально Green-API: IZ_WHATSAPP_BACKEND=green + ID/TOKEN.

В телефоне: WhatsApp → Связанные устройства → сканируйте QR ниже.

На сервере: Node 20+, cd services/whatsapp-web && npm i && node server.mjs (или systemd deploy/whatsapp-web.service), IZ_WHATSAPP_USER_ENABLED=1, IZ_WHATSAPP_BACKEND=web, IZ_WHATSAPP_WEB_URL=http://127.0.0.1:8791.

QR для входа:

Яндекс 360 для бизнеса. Нужна организация с подключённым доменом (рабочая почта @ваша-компания.ru), не личный @yandex.ru.
Платный «бизнес» или «360» на @yandex.ru — это не то же самое: API Телемост Яндекс открывает только для почты на домене организации.

Телемост — видеовстречи

Встречи создаются в разделе Календарь → «Встреча сейчас» / «Запланировать» / вкладка «Видео». OAuth-приложение: oauth.yandex.ru, право telemost-api:conferences.create. Документация.

Client ID (OAuth-приложение)

На странице oauth.yandex.ru токена нет — там только Client ID и Client Secret.
Токен появляется отдельно, после шага 2:

Сохраните Client ID кнопкой ниже (или он уже в базе).
Нажмите «Получить OAuth-токен» → войдите под рабочей почтой @ваш-домен.ru → «Разрешить».
Откроется страница oauth.yandex.ru/verification_code#access_token=… — скопируйте значение access_token из адресной строки (длинная строка, часто y0_…).
Вставьте в поле «OAuth-токен» → Сохранить Телемост → Проверить API.

Не путайте: Client Secret из карточки приложения в API не подставляют. Нужен OAuth-токен пользователя после входа по ссылке ниже (длинная строка, часто с y0_). Если видите «не авторизован» — почти всегда сохранён Secret вместо токена: нажмите «Сбросить токен» и вставьте правильный.

OAuth-токен Телемост

Яндекс Мессенджер — почему не как Telegram

Почему нельзя «как TG» в общий чат-бокс:

Telegram — клиент пишет боту или личный аккаунт (MTProto), API это разрешает.
Яндекс Мессенджер — у Яндекса только бот для сотрудников внутри организации 360. Внешние клиенты боту написать не могут — так устроен продукт, не наша панель.
Нет API «подключить личный мессенджер и тянуть все переписки», как Telethon для Telegram.

Сейчас: сообщения сотрудников боту появляются в чат-боксе (папка «VK · MAX · Яндекс»), ответ из панели уходит в Мессенджер. Нельзя: клиентский канал как Avito/Telegram.

Бот: admin.yandex.ru → Бот-платформа (тариф Extended/Optimal). Bot API.

OAuth-токен бота

Вебхук (после сохранения публичной базы HTTPS):

Выбрано: 0

ИЗИ чат
Выберите диалог в списке слева. Теги и оператора — в меню ⋮ в открытом чате. Личные чаты Telegram подтягиваются кнопкой «Синхр. личные чаты».

Доска команды: календарь, задачи, заметки. Ссылку на созвон можно вставить вручную или через .

Пишу от имени

Своя видеокомната

До 8 человек. Гости — по ссылке без регистрации. Коллег приглашайте из панели во время встречи.

Ссылка сохранена в карточке. Для Телемоста/Zoom нажмите «Открыть видеовстречу» или «↗ Новая вкладка».

📝 Протокол встречи

Заметки видны всем участникам; у каждой — автор

Команда ИЗИ
Доска и календарь открыты — выберите комнату слева для чата или фильтра событий.