Документация#

Globask — чат для сайта, в котором нет отдельного рабочего места для менеджеров. Посетитель пишет в виджет, сообщение приходит в вашу группу в Telegram отдельной темой, ответ возвращается в виджет за секунды. Отвечать можно и из кабинета — это выбор проекта, а не наше условие.

Как это устроено#

Три части, и знать про них полезно до того, как что-то настраивать.

Виджет стоит на вашем сайте — одна строка перед </body>. Он рисует кнопку, открывает панель чата и больше ничего от вас не требует: ни разработчика дольше, чем на вставку сниппета, ни отдельной вёрстки.

Проект — это один сайт в вашем аккаунте: ключ виджета, список доменов, внешний вид, автоответ, типовые ответы. Все настройки живут в кабинете и применяются без правки кода на сайте.

Доставка — то, как обращение попадает к людям. По умолчанию это супергруппа в Telegram, где каждому посетителю отводится своя тема; в теме менеджеры и отвечают. Второй путь — кабинет, и он полноценный: там есть и ответ, и закрытие диалога, и заметки, и карточка посетителя.

С чего начать#

Если хочется просто увидеть, что всё работает, — быстрый старт: пять шагов, ничего лишнего.

Дальше по надобности:

• Виджет на сайте — сниппет, домены, внешний вид, открытие чата своей кнопкой, управление панелью из скриптов.
• Где отвечают менеджеры — два режима работы, что умеет кабинет и чего в Telegram не может быть в принципе.
• Обращения в Telegram — подключение группы, команды в теме, разбор частых отказов.
• Серверное API — читать переписку и отвечать из своей системы: выгрузка в CRM, уведомления «заказ собран», диалог под управлением бота.
• Вебхуки — те же события, но без опроса: мы зовём ваш адрес в момент, когда что-то произошло.

Чего пока нет#

• Создание диалога снаружи. Разговор начинает посетитель; ваша система продолжает существующий.
• Произвольные файлы. Картинку ваш сервер отправить может (как), а документы — pdf, счета, накладные — мы пока не принимаем ни от кого.
• Вложения в вебхуках. Событие о сообщении с картинкой придёт, но ни файла, ни признака «здесь картинка» в теле нет — у картинки без подписи окажется пустой body. Чтобы увидеть вложение, запросите сообщение через API.
• Второй канал обращений. Источник по-прежнему один — виджет на сайте.

Если чего-то не хватает или в тексте нашлась неточность — напишите нам: чат есть в кабинете, в разделе «Помощь», и на главной странице. Он ведёт к тем же людям, которые это писали.