Событие о решении администратора по запросу метода с подтверждением onAppMethodConfirm

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: базовый

Кто может подписаться: любой пользователь

Событие ONAPPMETHODCONFIRM вызывается, когда администратор Битрикс24 разрешает или запрещает приложению вызов метода с подтверждением. Событие приходит только в то приложение, которое запросило разрешение.

События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения.

Что получает обработчик

Данные передаются в виде POST-запроса

{
    "event": "ONAPPMETHODCONFIRM",
    "event_handler_id": "15",
    "data": {
        "TOKEN": "fkp963yuv1ggkfbs5z3f5hy8lilm0iw6",
        "METHOD": "voximplant.user.get",
        "CONFIRMED": "1",
        "LANGUAGE_ID": "ru"
    },
    "ts": "1478790852",
    "auth": {
        "domain": "portal.bitrix24.ru",
        "client_endpoint": "https://portal.bitrix24.ru/rest/",
        "server_endpoint": "https://oauth.bitrix24.tech/rest/",
        "member_id": "74ef8a46a75104de55d5d4a61b98ab6d",
        "application_token": "c289487163b58658eae5e8b42eaf11b8"
    }
}

Параметры запроса

Обязательные параметры отмечены *

Название
тип

Описание

event*
string

Символьный код события — ONAPPMETHODCONFIRM

event_handler_id
integer

Идентификатор обработчика события

data*
object

Данные о решении администратора по методу.

Структура описана ниже

ts*
timestamp

Дата и время отправки события из очереди

auth*
object

Объект с параметрами авторизации и данными о Битрикс24, на котором произошло событие.

Структура описана ниже

Параметр data

Название
тип

Описание

TOKEN*
string

Значение access_token, с которым приложение вызвало метод и запросило разрешение. Решение администратора сохраняется для этого токена

METHOD*
string

Метод API, разрешение на использование которого было запрошено

CONFIRMED*
string

Результат разрешения: 0 — запрещено, 1 — разрешено

LANGUAGE_ID*
string

Язык Битрикс24 по умолчанию: ru, en и другие

Параметр auth

Название
тип

Описание

domain*
string

Адрес Битрикс24, на котором произошло событие

server_endpoint*
string

Адрес сервера авторизации для обновления токена

client_endpoint*
string

Общий путь для вызовов методов API Битрикс24

member_id*
string

Уникальный идентификатор Битрикс24

application_token*
string

Токен приложения. Сравните его с токеном, сохраненным при установке, чтобы убедиться, что запрос пришел из Битрикс24. Подробнее — в статье Безопасность в обработчиках

В отличие от onAppInstall, это событие отправляется без авторизации пользователя: ключей access_token, refresh_token, expires_in, scope и status в auth нет.

Если CONFIRMED равен 1, повторите вызов метода с токеном из data.TOKEN, пока срок его действия не истек.

Продолжите изучение

Предыдущая
При оплате приложения
Следующая
При добавлении пользователя