Tallker API v1

위젯

위젯. 서버 시스템을 연결하고 연락처와 주문을 전송하며 위젯 사용자를 안전하게 식별합니다.

How it works

1Скопируйте Public Widget ID в Настройки → API.
2Добавьте загрузчик перед закрывающим тегом body.
3Для авторизованных пользователей получите identity token на своём сервере и передайте его виджету.

예제

// Метрика обычно определяется автоматически. Для явного выбора счётчика:
window.TallkerMetrikaIds = [12345678];

window.Tallker = window.Tallker || [];
window.Tallker.push(["identify", { name: currentUser.name }]);
// <script src="https://tallker.com/widget/v1/tallker.js"
//   data-id="YOUR_PUBLIC_WIDGET_ID" data-metrika-id="12345678" async></script>

window.addEventListener("tallker:analytics", (event) => {
  console.log(event.detail.goal, event.detail.params);
});

Parameters and requirements

data-idобязательноПубличный идентификатор виджета

data-metrika-idнеобязательноНомер одного или нескольких счётчиков Яндекс Метрики через запятую; обычно Tallker определяет их автоматически

identityTokenрекомендуетсяКороткоживущий токен безопасной идентификации

pageавтоматическиТекущий URL страницы посетителя

Result

После загрузки кнопка чата появится в выбранном углу сайта. Новые сообщения создают контакт и диалог во «Входящих».

요청 제한과 멱등성

120 requests / minute · HTTP 429 · Retry-After · Idempotency-Key 24h

보안

Не помещайте API-ключ tk_live_ в HTML или JavaScript браузера.

Загрузчик подключайте один раз на страницу с атрибутом async.

Яндекс Метрика: создайте цели типа «JavaScript-событие» с идентификаторами Tallker_Chat_requested, Tallker_Client_initiate_chat, Tallker_Chat_established, Tallker_Proactive_invitation_shown, Tallker_Proactive_invitation_opened, Tallker_Proactive_invitation_accepted, Tallker_Offline_form_shown, Tallker_Offline_message_sent, Tallker_User_gave_contacts_during_chat, Tallker_Prechat_phrase_clicked, Tallker_Widget_opened, Tallker_Widget_closed, Tallker_Automation_shown, Tallker_Automation_opened, Tallker_Rating_shown и Tallker_Rating_submitted.

Tallker автоматически вызывает ym(counterId, 'reachGoal', goal, params), отправляет событие tallker:analytics и добавляет совместимое событие Tallker в dataLayer. Текст сообщений, email и телефон в аналитику не передаются.

OpenAPI 3.1