Вебхуки

Вебхуки позволяют настраивать гибкие интеграции с другими сервисами для автоматического отслеживания ключевых событий.

Добавление получателей

Добавление получателей вебхуков доступно на странице https://smm.targethunter.ru/webhooks. Вы можете добавить до 10 получателей единовременно.

При подключении нового получателя вебхука, на указанный URL будет отправлено приветственное уведомление вида:

{
  "type": "hello",
  "group_id": 1,
  "channel": "VK",
  "time": 1660049561
}

На это уведомление сервер получателя должен ответить статусом 200, чтобы подключение прошло успешно.

Типы событий

Тип	Описание
subscribe	Пользователь подписался на мини-лендинге
unsubscribe	Пользователь отписался от мини-лендинга
hello	Приветственное событие

Структуры событий

Уведомления отправляются в формате JSON. Пример структуры:

{
    "id": "62f2546598c06d359f5ce69a",
    "type": "subscribe",
    "time": 1660048485,
    "group_id": 1,
    "channel": "VK",
    "user": {
        "id": 102036383,
        "first_name": "Илья",
        "last_name": "Соколов"
    },
    "utm": {
        "utm_source": "source",
        "utm_campaign": "something",
        "utm_medium": "medium",
        "utm_content": "content",
        "utm_term": "term",
        "th_ad_id": ""
    },
    "subscription": {
        "id": "6273ff326bd2a5442f08dd55",
        "name": "Чат-боты на максималках!"
    }
}

Поле	Значение
id	Уникальный идентификатор события
type	Тип события (указаны в пункте выше)
time	unixtime создания события
group_id	ID сообщества в канале
channel	Канал сообщества
user	Структура, содержащая информацию о пользователе
utm	optional. Структура, содержащая рекламные метки, с которыми произошло событие
subscription	optional. Структра, содержащая информацию о мини-лендинге, в котором произошло событие

В заголовках запроса присутствуют следующие данные:

• Referer: https://smm.targethunter.ru

• User-Agent: Mozilla/5.0 (THWebhook/v1)

Обработка ошибок

Если сервер получателя вернул некорректный ответ (не удалось отправить или сервер ответил не кодом 200), получатель будет помечен статусом "содержит ошибки". Само событие перейдет на следующую попытку отправки

Повторные отправки настроены следующим образом:

Номер попытки	Время ожидания, относительно первой отправки
1	Сразу
2	Через 1 минуту
3	Через 2 минуты
4	Через 5 минут
5	Через 10 минут
6	Через 30 минут
7	Через 1 час
8	Через 2 часа
9	Через 6 часов
10	Через 12 часов
11	Через 24 часа

Если после последней попытки не был получен корректный ответ, то уведомление считается недоставленным.

Отслеживание истории отправки

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