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


Подробнее о работе с документацией и интеграциях в статье: Подписки на события.

При выполнении выбранного условия на заданный url (адрес) придет запрос, закодированный в JSON формате.


Любое сообщение (any_message):


  • "date" — Дата в timestamp,
  • "bot"
    • "id" — ID Бота,
    • “username” — Username Бота,
    • "first_name" — Название Бота.
  • "chat"
    • "id" — ID чата,
    • "type" — Тип чата ("private" или "channel" или "group" или "supergroup"),
    • "first_name" — Название бота (может не быть, если это не бот),
    • "title" — Название ресурса (может не быть, если это бот),
    • "username" — Username ресурса (бота или канала или супергруппы),
    • "members_count" — Количество участников в чате.
  • "user"
    • "id" — ID пользователя,
    • "first_name" — Имя пользователя,
    • "last_name" — Фамилия пользователя,
    • "username" — Username пользователя,
    • "is_bot" — Является ботом или нет (true или false),
    • "category_name" — Название категории пользователя.
  • "message" — Текст сообщения,
  • "type_subscribe_event":"any_message",
  • "name" — Название подписки на событие.



Вызов команды (call_command):


  • "date" — Дата в timestamp,
  • "bot"
    • "id" — ID Бота,
    • “username” — Username Бота,
    • "first_name" — Название Бота.
  • "chat"
    • "id" — ID чата,
    • "type" — Тип чата ("private" или "channel" или "group" или "supergroup"),
    • "first_name" — Название бота (может не быть, если это не бот),
    • "title" — Название ресурса (может не быть, если это бот),
    • "username" — Username ресурса (бота или канала или супергруппы),
    • "members_count" — Количество участников в чате.
  • "user"
    • "id" — ID пользователя,
    • "first_name" — Имя пользователя,
    • "last_name" — Фамилия пользователя,
    • "username" — Username пользователя,
    • "is_bot" — Является ботом или нет (true или false),
    • "category_name" — Название категории пользователя.
  • "command"
    • "name" — Название команды,
    • "group_name" — Название группы команды,
    • "call_type" — Тип вызова команды ("reply" или "inline").
  • "type_subscribe_event":"call_command",
  • "name" — Название подписки на событие.



Вызов команды из группы (call_command_from_group):


  • "date" — Дата в timestamp,
  • "bot"
    • "id" — ID Бота,
    • “username” — Username Бота,
    • "first_name" — Название Бота.
  • "chat"
    • "id" — ID чата,
    • "type" — Тип чата ("private" или "channel" или "group" или "supergroup"),
    • "first_name" — Название бота (может не быть, если это не бот),
    • "title" — Название ресурса (может не быть, если это бот),
    • "username" — Username ресурса (бота или канала или супергруппы),
    • "members_count" — Количество участников в чате.
  • "user"
    • "id" — ID пользователя,
    • "first_name" — Имя пользователя,
    • "last_name" — Фамилия пользователя,
    • "username" — Username пользователя,
    • "is_bot" — Является ботом или нет (true или false),
    • "category_name" — Название категории пользователя.
  • "command"
    • "name" — Название команды,
    • "group_name" — Название группы команды,
    • "call_type" — Тип вызова команды ("reply" или "inline").
  • "type_subscribe_event":"call_command_from_group",
  • "name" — Название подписки на событие.



Ответ на форму ввода (form_answers):


  • "date" — Дата в timestamp,
  • "bot"
    • "id" — ID Бота,
    • “username” — Username Бота,
    • "first_name" — Название Бота.
  • "chat"
    • "id" — ID чата,
    • "type" — Тип чата ("private" или "channel" или "group" или "supergroup"),
    • "first_name" — Название бота (может не быть, если это не бот),
    • "title" — Название ресурса (может не быть, если это бот),
    • "username" — Username ресурса (бота или канала или супергруппы),
    • "members_count" — Количество участников в чате.
  • "user"
    • "id" — ID пользователя,
    • "first_name" — Имя пользователя,
    • "last_name" — Фамилия пользователя,
    • "username" — Username пользователя,
    • "is_bot" — Является ботом или нет (true или false),
    • "category_name" — Название категории пользователя.
  • "type_subscribe_event":"form_answers",
  • "name"— Название подписки на событие,
  • "forms" — Массив ответов на формы,

    • "name" — Имя формы 1,
    • "type" — Тип формы 1,
    • "variable" — Переменная формы 1,
    • "answer" — Ответ формы 1,
    • "caption" — Описание к файлу 1 (если отправлен файл).


    • "name" — Имя формы N,
    • "type" — Тип формы N,
    • "variable" — Переменная формы N,
    • "answer" — Ответ формы N,
    • "caption" — Описание к файлу N (если отправлен файл).



Ответ на форму ввода заданных команд (custom_form_answers):


  • "date" — Дата в timestamp,
  • "bot"
    • "id" — ID Бота,
    • “username” — Username Бота,
    • "first_name" — Название Бота.
  • "chat"
    • "id" — ID чата,
    • "type" — Тип чата ("private" или "channel" или "group" или "supergroup"),
    • "first_name" — Название бота (может не быть, если это не бот),
    • "title" — Название ресурса (может не быть, если это бот),
    • "username" — Username ресурса (бота или канала или супергруппы),
    • "members_count" — Количество участников в чате.
  • "user"
    • "id" — ID пользователя,
    • "first_name" — Имя пользователя,
    • "last_name" — Фамилия пользователя,
    • "username" — Username пользователя,
    • "is_bot" — Является ботом или нет (true или false),
    • "category_name" — Название категории пользователя.
  • "type_subscribe_event":"custom_form_answers",
  • "name"— Название подписки на событие,
  • "forms" — Массив ответов на формы,

    • "name" — Имя формы 1,
    • "type" — Тип формы 1,
    • "variable" — Переменная формы 1,
    • "answer" — Ответ формы 1,
    • "caption" — Описание к файлу 1 (если отправлен файл).

    • "name" — Имя формы N,
    • "type" — Тип формы N,
    • "variable" — Переменная формы N,
    • "answer" — Ответ формы N,
    • "caption" — Описание к файлу N (если отправлен файл).



Пользователь вошел в чат (new_member):


  • "date" — Дата в timestamp,
  • "bot"
    • "id" — ID Бота,
    • “username” — Username Бота,
    • "first_name" — Название Бота.
  • "chat"
    • "id" — ID чата,
    • "type" — Тип чата ("private" или "channel" или "group" или "supergroup"),
    • "first_name" — Название бота (может не быть, если это не бот),
    • "title" — Название ресурса (может не быть, если это бот),
    • "username" — Username ресурса (бота или канала или супергруппы),
    • "members_count" — Количество участников в чате.
  • "user"
    • "id" — ID пользователя,
    • "first_name" — Имя пользователя,
    • "last_name" — Фамилия пользователя,
    • "username" — Username пользователя,
    • "is_bot" — Является ботом или нет (true или false),
    • "category_name" — Название категории пользователя.
  • "type_subscribe_event":"new_member",
  • "name"— Название подписки на событие.



Пользователь покинул чат (left_member):


  • "date" — Дата в timestamp,
  • "bot"
    • "id" — ID Бота,
    • “username” — Username Бота,
    • "first_name" — Название Бота.
  • "chat"
    • "id" — ID чата,
    • "type" — Тип чата ("private" или "channel" или "group" или "supergroup"),
    • "first_name" — Название бота (может не быть, если это не бот),
    • "title" — Название ресурса (может не быть, если это бот),
    • "username" — Username ресурса (бота или канала или супергруппы),
    • "members_count" — Количество участников в чате.
  • "user"
    • "id" — ID пользователя,
    • "first_name" — Имя пользователя,
    • "last_name" — Фамилия пользователя,
    • "username" — Username пользователя,
    • "is_bot" — Является ботом или нет (true или false),
    • "category_name" — Название категории пользователя.
  • "type_subscribe_event":"left_member",
  • "name" — Название подписки на событие.



Активация ссылки (activate_link):


  • "date" — Дата в timestamp,
  • "bot"
    • "id" — ID Бота,
    • “username” — Username Бота,
    • "first_name" — Название Бота.
  • "chat"
    • "id" — ID чата,
    • "type" — Тип чата ("private" или "channel" или "group" или "supergroup"),
    • "first_name" — Название бота (может не быть, если это не бот),
    • "title" — Название ресурса (может не быть, если это бот),
    • "username" — Username ресурса (бота или канала или супергруппы),
    • "members_count" — Количество участников в чате.
  • "user"
    • "id" — ID пользователя,
    • "first_name" — Имя пользователя,
    • "last_name" — Фамилия пользователя,
    • "username" — Username пользователя,
    • "is_bot" — Является ботом или нет (true или false),
    • "category_name" — Название категории пользователя.
  • "link"
    • "key" — Ключ ссылки,
    • "type" — Тип ссылки ("multiple" или "promo" или "referal").
  • "type_subscribe_event":"activate_link",
  • "name" — Название подписки на событие.



Уведомления (notifications):


start_dialog, end_dialog, any_message_in_dialog, unconfirmed_leave, new_request_resource, post_in_queue, post_sent, new_payment, failed_payment


  • "date" — Дата в timestamp,
  • "bot"
    • "id" — ID Бота,
    • “username” — Username Бота,
    • "first_name" — Название Бота.

   

Только для unconfirmed_leave и new_request_resource


  • "chat"
    • "id" — ID чата,
    • "type" — Тип чата ("private" или "channel" или "group" или "supergroup"),
    • "first_name" — Название бота (может не быть, если это не бот),
    • "title" — Название ресурса (может не быть, если это бот),
    • "username" — Username ресурса (бота или канала или супергруппы),
    • "members_count" — Количество участников в чате.

   

Только для start_dialog, end_dialog, any_message_in_dialog, new_payment и failed_payment


  • "user"
    • "id" — ID пользователя,
    • "first_name" — Имя пользователя,
    • "last_name" — Фамилия пользователя,
    • "username" — Username пользователя,
    • "is_bot" — Является ботом или нет (true или false),
    • "category_name" — Название категории пользователя.
  • "type_subscribe_event" — Тип подписки на событие,
  • "name" — Название подписки на событие,
  • "text" — Текст уведомления,
  • "type_notification" — Тип уведомления.

   

Только для new_payment и failed_payment


  • “payment”
    • "sum" — Сумма платежа,
    • "name" — Название платежа,
    • "status" — Статус* ("ok" или "failed").