Вебхуки

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

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

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

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

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

Типы событий

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

Уведомления отправляются в формате 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": "Чат-боты на максималках!"
    }
}

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

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

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

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

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

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

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

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

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