RUEN
Начать
Разработчикам

Событие на каждое изменение. API в каждом тарифе.

Всё, что происходит в TalkyHub, можно получить подписанным вебхуком: новые сообщения, назначения, статусы, метки. Без доплаты и без пакетов запросов.

Документация APIВебхуки
  • message.created
  • message.updated
  • message.deleted
  • conversation.created
  • conversation.status_changed
  • conversation.assigned
  • conversation.team_changed
  • conversation.priority_changed
  • conversation.labels_changed
  • HMAC-SHA256 с меткой времени против повторов
  • Повторы через 5 и 30 секунд, журнал ошибок
  • REST /api/v1, ошибки по RFC 9457
в эфире
  • 00:16:49message.updatedapi.company.ru/hooks200
  • 00:16:46conversation.labels_changedapi.company.ru/hooks200
  • 00:16:43message.createdapi.company.ru/hooks200 · попытка 2
  • 00:16:40message.createdapi.company.ru/hooks503 · повтор через 5 с
  • 00:16:37conversation.createdapi.company.ru/hooks200
  • 00:16:34conversation.assignedapi.company.ru/hooks200
  • 00:16:31message.createdapi.company.ru/hooks200
Каталог событий

Подписывайтесь только на нужное

Названия событий проверяются при подписке: опечатка вернёт ошибку, а не тишину.

message.createdНовое сообщение клиента или ответ оператораработает
message.updatedСообщение отредактированоработает
message.deletedСообщение удаленоработает
conversation.createdНачался новый диалогработает
conversation.status_changedОткрыт, ожидает, отложен, решёнработает
conversation.assignedДиалог назначен операторуработает
conversation.team_changedДиалог передан другой командеработает
conversation.priority_changedИзменён приоритетработает
conversation.labels_changedИзменены меткиработает
contact.mergedДва контакта объединеныскоро
sla.breachedНарушен срок ответаскоро

Управление вебхуками

Адреса и подписки настраиваются через API или в настройках рабочего пространства.

  • GET
    /api/v1/webhook-endpoints/catalogСписок событий, на которые можно подписаться
  • POST
    /api/v1/webhook-endpointsДобавить адрес и события. Секрет показывается один раз
  • GET
    /api/v1/webhook-endpointsВаши адреса (без секретов)
  • GET
    /api/v1/webhook-endpoints/{id}/deliveriesЖурнал доставки, в том числе ошибки
  • DELETE
    /api/v1/webhook-endpoints/{id}Удалить адрес
Виджет

Чат на сайте узнаёт ваших пользователей

Передайте ID пользователя с подписью вашего сервера, и он увидит свою переписку на любом устройстве без анкеты. Без подписи данные считаются подсказкой и не открывают чужую историю.

  • 24 КБ в gzip, Shadow DOM: стили сайта не ломаются
  • Ответы в реальном времени
  • TalkyHub.setUser() и reset() для входа и выхода
<script>
  window.talkyhubSettings = {
    token: 'wgt_…',
    apiBase: 'https://api.talkyhub.ru',
    user: {
      identifier: 'user-42',
      identifier_hash: '9f86d081…', // HMAC на вашем сервере
      name: 'Анна Морозова',
      email: 'anna.m@yandex.ru',
    },
  }
</script>
<script async src="https://cdn.talkyhub.ru/widget/v1/loader.js"></script>
Принципы

Как устроен API

Один формат для всех каналов

Сообщение из VK, MAX или почты приходит к вам в одинаковом виде. Особенности каждого мессенджера остаются внутри TalkyHub.

Доставка хотя бы один раз

Если ваш сервер не ответил, событие придёт повторно через 5 и 30 секунд. Убирайте дубли по X-TalkyHub-Delivery.

Подпись и защита от повторов

HMAC-SHA256 считается от метки времени и тела запроса. Отклоняйте запросы со старой меткой.

Понятные ошибки

REST API под /api/v1, ошибки в формате RFC 9457 с кодом и описанием.

Попробуйте TalkyHub бесплатно

Подключите первый канал и ответьте клиенту уже сегодня.

Начать бесплатно

Бесплатно навсегда · Без карты · Первый канал за 5 минут