Перейти к контенту
Tallker
Tallker
Панель оператора · чат · омниканал
rocket_launch Попробовать бесплатно
menu_book Документация Tallker: установка, настройки, API, интеграции, безопасность.
play_circleДемо paymentsТарифы
verified Официальные гайды · примеры · best practices

Документация Tallker — внедрение без хаоса

Здесь собраны практические инструкции: установка виджета, настройка очереди, статусов и SLA, интеграции (вебхуки), API и рекомендации по безопасности.

rocket_launchПерейти к Quick Start searchНайти раздел support_agentПоддержка
Содержание
Быстрая навигация по ключевым разделам.
menu_book Docs Hub
rocket_launch
Быстрый старт
Подключение виджета за 10 минут + базовая проверка корректности.
code
Установка виджета
Скрипт на сайт, CSP, проверка отображения, исключения по страницам.
rule
Очередь, статусы, SLA
Как выстроить управляемый процесс: правила, теги, роли, контроль.
integration_instructions
Интеграции и вебхуки
События, доставка в CRM/Helpdesk, базовая схема обмена.
api
API
Примеры запросов, аутентификация, типовые операции.
shield
Безопасность
Роли, аудит, сегментация аккаунтов, рекомендации по доступу.
build_circle
Troubleshooting
Если виджет не отображается, конфликтует или “прыгает” вёрстка.
help
FAQ
Ответы на вопросы внедрения, оплаты и эксплуатации.
boltНачать бесплатно calendar_monthЗапросить демо

Если вы внедряете Tallker в прод-контур: начните с Quick Start, затем включайте SLA/роли и подключайте интеграции.

Популярные материалы

Быстрые ссылки на то, что чаще всего нужно при внедрении.

Quick Start

Цель — быстро получить рабочий виджет на сайте и проверить поток обращения. Дальше подключаются правила, статусы, SLA и интеграции.

schedule Время
10–15 минут на установку и базовую проверку.
check_circle Минимальный результат
Виджет отображается, сообщение отправляется, диалог виден оператору.
shield Рекомендация
Для прод-контуров заведите отдельные ключи под окружения (dev/stage/prod).
1) Вставьте скрипт виджета
Разместите перед </body> на сайте.
HTML (пример) terminal embed 
<!-- Tallker widget -->
<script defer src="https://tallker.com/widget/ВАШ_WIDGET_KEY"></script>
2) Проверьте в инкогнито
  • check_circleВиджет отображается на странице.
  • check_circleСообщение отправляется и видно в панели оператора.
  • check_circleНет ошибок в консоли браузера.
info
Если на сайте строгий CSP, добавьте домены Tallker в script-src. При проблемах — перейдите в Troubleshooting ниже.
arrow_downwardУстановка: детали calendar_monthЗапросить демо

Установка виджета

На практике ошибки установки — это 80% проблем. Ниже — “железобетонный” чек-лист.

checklist

Чек-лист

  • check_circleСкрипт перед </body>.
  • check_circleКлюч виджета валидный.
  • check_circleНет CSP-блокировок.
  • check_circleНет JS-ошибок на странице.
policy

CSP (если строго)

Добавьте домен Tallker в script-src. Точная конфигурация зависит от вашего CSP. При необходимости — согласуем безопасную политику.

visibility_off

Скрыть на URL

Если на странице /chat чат не должен отображаться — инициализируйте скрипт условно.

Пример: не показывать виджет на /chat
Вставьте этот блок вместо прямого подключения.
HTML + JS code conditional load 
<script>
(function(){
  var p = location.pathname || "/";
  if (p === "/chat" || p.indexOf("/chat/") === 0) return; // исключаем /chat
  var s = document.createElement("script");
  s.src = "https://tallker.com/widget/ВАШ_WIDGET_KEY";
  s.defer = true;
  document.body.appendChild(s);
})();
</script>
Если у вас SPA/Router — исключение делайте на уровне роутинга и “mount/unmount” скрипта.

Очередь, статусы, SLA

Когда обращений становится больше “нескольких в день”, без дисциплины процесс начинает течь. Tallker закрывает это правилами и метриками.

1
Статусы
Минимум: “Новое” → “В работе” → “Закрыто”. Добавляйте “Ожидание” при необходимости.
2
Правила
Назначение по сайту/тегам/приоритету. Важно: один ответственный на диалог.
3
SLA
Фиксируйте целевое время реакции. Контроль SLA — основа управляемости поддержки.
4
Аналитика
Скорость реакции, нагрузка по операторам, доля просрочки, причины ожидания.

insightsРекомендуемый “минимум процесса”

Если вы хотите быстрый эффект без бюрократии — зафиксируйте 5 правил.

person Ответственный
Один оператор = один диалог.
timer SLA реакции
Цель и контроль просрочки.
sell Теги
Причины и типовые сценарии.
history История
Контекст = скорость решения.
calendar_monthПоказать на демо
Для прод-команд: рекомендуем включить роли и аудит действий (см. раздел Security).

Интеграции и вебхуки

Правильная интеграция — это не “свалить всё в CRM”, а настроить события и ответственность: что создаём автоматически, что — руками, какие статусы синхронизируем.

webhook

Вебхуки событий

Отправляйте события (новое обращение, ответ оператора, закрытие) в ваш backend.

handshake

CRM/Helpdesk

Создание лида/тикета, прикрепление истории, связь с клиентом по id.

automation

Автоматизация

Роутинг, авто-теги, авто-ответы, синхронизация статусов и приоритетов.

Рекомендуемая схема “минимальной интеграции”
Стартуйте с малого — потом расширяйте.
  1. Событие “новое обращение” → создаём тикет/лид в вашей системе.
  2. В тикет пишем: источник, url страницы, id диалога, контактные поля.
  3. Статус “закрыто” → синхронизируем в вашу систему (опционально).
  4. Ошибки доставки → логируем и повторяем с backoff.
apiСмотреть API примеры support_agentУточнить интеграцию

API

Ниже — демонстрационные примеры формата запросов. Конкретные эндпойнты и права зависят от вашей конфигурации и тарифа.

Пример: запрос списка диалогов
curl + Bearer token.
bash terminal curl 
curl -sS "https://tallker.com/api/v1/conversations?limit=20" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
Рекомендация: ограничивайте токены по ролям и окружениям, храните в секрет-хранилище.
Пример: отправить заметку/событие
POST JSON.
bash data_object json 
curl -sS -X POST "https://tallker.com/api/v1/conversations/CONV_ID/notes" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"Заметка: клиент просит перезвонить после 18:00","tag":"callback"}'
Для идемпотентности используйте client_request_id (если доступно в вашем режиме API).
info
Нужен API под ваш кейс?
Напишите в поддержку и опишите: какие события/данные нужны, где храните клиентов, какие статусы синхронизировать.
support_agentОбсудить API shieldБезопасность

Безопасность

Для корпоративного контура важны: роли, аудит, изоляция аккаунтов и контроль ключей. Ниже — базовые практики, которые дают быстрый эффект.

admin_panel_settings
Роли и права
Разделяйте роли: владелец/админ/оператор. Минимизируйте доступы по принципу least privilege.
key
Ключи виджета
Не публикуйте ключи в репозиториях. Для окружений используйте разные ключи.
history
Аудит действий
Фиксируйте: кто поменял правила, кто закрыл диалог, кто изменил статус.
dns
Ограничение доменов
Привязывайте виджет к доменам, чтобы исключить “встраивание” на чужих сайтах.

shieldКонтроль доступа: минимум

Если хотите “быстро и правильно” — примените этот чек-лист при запуске.

  • check_circleСильные пароли + (при наличии) 2FA.
  • check_circleРазные роли: операторы не меняют правила/ключи.
  • check_circleОтдельные ключи на dev/stage/prod.
  • check_circleРегламент: кто и когда меняет правила/SLA.
verified_userСтраница Security
Для Business-режимов возможны дополнительные контуры: отдельные регламенты, ограничения и сопровождение внедрения.

Troubleshooting

Если “ничего не видно” или “вдруг пропало” — пройдите по пунктам ниже. Это закрывает большинство кейсов.

code_off

Скрипт не подключился

Проверьте, что скрипт реально присутствует в HTML и загружается (Network).

policy

CSP блокирует

Проверьте консоль на ошибки CSP. Добавьте домены Tallker в script-src.

bug_report

JS конфликт

Если на странице есть ошибки JS — исправьте их, иначе виджет может не инициализироваться.

lock

Блокировщики

AdBlock может скрывать элементы. Проверьте в инкогнито без расширений.

dns

Неверный домен/ключ

Убедитесь, что ключ относится к нужному сайту и окружению.

support_agent

Нужна помощь

Отправьте домен, URL страницы и скрин консоли на support@tallker.com.

info
Шаблон обращения в поддержку
Домен, точный URL страницы, время проблемы, скриншот консоли, скрин Network (загрузка скрипта), и что ожидали получить.
mailСвязаться

FAQ

Ответы на вопросы, которые чаще всего возникают при внедрении и эксплуатации.

С чего начинать внедрение Tallker? expand_more

С установки виджета и короткого пилота: один сайт, базовая очередь, 2–3 статуса. Далее подключайте правила, роли и SLA по мере роста нагрузки.

Где брать ключ виджета? expand_more

Ключ виджета создаётся в панели Tallker для конкретного сайта. Используйте только ключи вашего аккаунта и храните их как секрет.

Можно ли скрывать виджет на отдельных страницах? expand_more

Да. Используйте исключения по URL (например, не показывать чат на /chat) или условную инициализацию на стороне сайта.

Поддерживаются интеграции? expand_more

Да. Можно подключать вебхуки/события и API-обмен. Рекомендуем начать с минимального набора: создание лида/тикета и синхронизация статусов.

Как обеспечивается безопасность? expand_more

Роли и права, сегментация аккаунтов и сайтов, аудит действий. Для корпоративных сценариев — регламент доступа и отдельные ключи на окружения.

Что делать, если виджет не отображается? expand_more

Проверьте, что скрипт вставлен перед </body>, нет CSP-блокировок, нет JS-ошибок на странице и ключ виджета корректен. См. Troubleshooting ниже.

Нужен быстрый план внедрения под ваш процесс?

Запросите демо — покажем сценарии, предложим конфигурацию и next steps (без лишних функций).

calendar_monthЗапросить демо paymentsТарифы

© 2026 Tallker. Документация может обновляться; актуальные условия фиксируются в личном кабинете и документах.