Разработчикам

<script src="https://widget.chait.ru/widget.js" data-site="ВАШ_SITE_ID" async></script>

Скрипт загружается асинхронно и не блокирует страницу. Когда виджет отметится, канал «Сайт (виджет)» в панели сменит статус на «подключён».

Шаг 1. Посчитайте подпись на бэкенде

import { createHmac } from "node:crypto";

const hmac = createHmac("sha256", process.env.CHAT_HMAC_SECRET)
  .update(String(user.id))
  .digest("hex");

// отдаём hmac на фронт вместе с остальным профилем пользователя

<?php
$hmac = hash_hmac('sha256', (string) $user_id, $hmac_secret);
// $hmac_secret — секретный ключ сайта из панели
?>

import hmac, hashlib

digest = hmac.new(
    hmac_secret.encode(),      # секретный ключ сайта из панели
    str(user_id).encode(),
    hashlib.sha256,
).hexdigest()

Шаг 2. Передайте профиль виджету

Задайте window.chatWidgetUser доподключения widget.js — подставьте посчитанный на сервере hmac:

<script>
  window.chatWidgetUser = {
    id: "42",                       // обязателен для идентификации
    hmac: "<hmac-из-вашего-бэкенда>", // HMAC-SHA256 от id ключом сайта
    name: "Иван Петров",
    email: "ivan@example.com",
    description: "Pro",
    company_name: "ООО «Ромашка»",
    custom_attributes: { plan: "pro", ltv: 12000 },
  };
</script>
<script src="https://widget.chait.ru/widget.js" data-site="ВАШ_SITE_ID" async></script>

Секрет каждого сайта можно перегенерировать в его настройках — после ротации обновите подпись у себя на бэкенде.

// Открыть / закрыть / переключить чат программно
window.ChatWidget.open();
window.ChatWidget.close();
window.ChatWidget.toggle();
window.ChatWidget.isOpen(); // true, если панель открыта

// Открыть с готовым вопросом от имени посетителя
window.ChatWidget.open({ message: "Хочу обсудить тариф Бизнес" });
// …или скрыто: вопрос уходит боту, в переписке посетитель видит только ответ
window.ChatWidget.open({ message: "Что входит в тариф?", hideMessage: true });
// …или просто подставить текст в поле ввода, без отправки
window.ChatWidget.open({ prefill: "Здравствуйте! " });

// Отправить сообщение, не раскрывая окно
window.ChatWidget.sendMessage("Здравствуйте!");

// Профиль пользователя (identify — синоним setUser)
window.ChatWidget.identify({ id: "42", hmac: "…", name: "Иван" });
// Произвольные атрибуты в карточку посетителя (нужен подписанный профиль с hmac)
window.ChatWidget.setContext({ plan: "pro", cart_total: 5400 });

// Подписка на события; on возвращает функцию отписки
const off = window.ChatWidget.on("handoff", (e) => console.log("позвали оператора", e));

// Убрать виджет со страницы (SPA-переходы)
window.ChatWidget.destroy();

// Короткий алиас для открытия (например, на кнопке «Написать нам»)
window.openChat();

// Подписка методом виджета (возвращает функцию отписки)
window.ChatWidget.on("message", (d) => console.log(d.direction, d.text));

// То же событие на window — слушателя можно повесить до загрузки виджета
window.addEventListener("chait:handoff", (e) => console.log(e.detail));

// В GTM события приходят сами, если dataLayer объявлен до виджета:
// { event: "chait_handoff", conversation_id: 123, reason: "button" }