Error install app pls install local application bitrix24

Error install app pls install local application bitrix24

Trying to download a file using crm.documentgenerator.document.download does not work as this is not a JSON.
Kindly add support for that

Created at 4 weeks ago

I have a custom field with multiple selection.

doesn’t work. How can I add contact via API to a field with multiple selection?

Created at 4 months ago

Т.к. используется http_build_query
Нельзя в фильтре например передать параметр false он будет преобразован в 0

Created at 4 months ago

параметр event не всегда передаётся битриксом. из за этого выскакивают лишние notice, которые на пример в AJAX ответе могут всё испортить.

было
if ($_REQUEST[ ‘event’ ] == ‘ONAPPINSTALL’ && !empty($_REQUEST[ ‘auth’ ])) <
стало
if (isset($_REQUEST[ ‘event’ ]) && $_REQUEST[ ‘event’ ] == ‘ONAPPINSTALL’ && !empty($_REQUEST[ ‘auth’ ])) <

Created at 9 months ago

Почему бы не добавить garbage collector, который будет удалять лишние лог файлы. Видел клиентов, у которых логи за год накопились на 300 МБ и по 100000 с лишним файлов.

Created at 10 months ago

Составил запрос, при помощи вашей библиотеки, при каждой отправке запроса, приходят разные данные, что я делаю не так?
мой запрос:

`function getCalls() <
$startDate = $_POST[‘startDate’];
$endDate = $_POST[‘endDate’];
$select = json_decode($_POST[‘select’]);
$departmentId = json_decode($_POST[‘users’]);
$leadID = 0;
$finish = false;
$finalResult = [];

Created at 1 year ago

If there is a mysql error message in the curl output, the $result is empty after the json_decode, because such error message is not a valid json. There is no useful information in the response — no error, no error_information, just a pointless empty $result. That’s not acceptable.

Created at 2 years ago

Hi, I’m using CRest. I have created my application in Bitrix but I’m getting the message:

Array ( [error] => no_install_app [error_information] => error install app, pls install local application )

Источник

Разработка приложения для Битрикс24 от А до Я. Часть 2 — реализуем установку приложения

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

Ну а сегодня мы продолжим познавать мастерство разработки. Начнем с логического старта — с установки приложения, а точнее с реализации функции. Далее повествование идет от лица Вадима — нашего руководителя отдела web-разработки.

Начинаем разработку

Схема 1. Установка приложения

Сохраняем в лог запрос с портала

Пробуем получить ранее сохраненные о портале данные

Есть ли запись о портале?

фиксируем факт установки в логах

формируем поля для новой записи

фиксируем в логах значения полей

добавляем новую запись

фиксируем в логах результат добавления

формируем запрос для подписки на событие OnAppUninstall

отсылаем запрос на портал

фиксируем в логах запрос и результат выполнения

фиксируем факт обновления в логах

формируем поля для обновления записи

фиксируем в логах значения полей

обновляем старую запись

фиксируем в логах результат обновления

формируем запрос на текущий список наших подписок на события

отсылаем запрос на портал

фиксируем в логах запрос и результат выполнения

инициализируем массив под батч-запрос

собираем в массив запросы на удаление старой подписки

если массив не пустой, отправляем запрос на портал

фиксируем в логах запрос и результат выполнения

формируем запрос для новой подписки на событие OnAppUninstall

отсылаем запрос на портал

фиксируем в логах запрос и результат выполнения

Выводим страницу пользователю

подключаем js-библиотеку портала

Я расписал всю логику без какой-либо оптимизации. Некоторые авторы так и рекомендуют делать: вначале писать все подряд, добиваться рабочего кода, а уж только затем приступать к оптимизации. Кажется, Фаулер говорил, что нельзя одновременно писать код и по ходу дела оптимизировать, нужно разделять на два этапа. Теперь же, глядя на то, что у нас получилось, можно заметить, что у нас один, по крайней мере, код выполняется в обеих ветках условия, а именно подписка на событие. Что ж, можно его вынести за рамки условия и удалить из обеих веток. Однако, в действительности алгоритм будет куда сложнее, поскольку в этом автор проживает в сказочном мире, где все всегда заканчивается хорошо. К сожалению, он в этом не одинок. Для начала создадим переменную errors и проинициализируем массивом.

Вопрос об обработке ошибок настолько важен, насколько часто упускается из вида. Можем ли мы сказать порталу, что установка завершена, если нам не удастся подписаться на события или сохранить запись о портале? Вероятно, ничего уж такого критичного в плане основной задачи приложения не произойдет, мы лишь не сможем потом определить факт обновления и не сможем почистить таблицы от данных портала, на котором приложение было удалено. И все-таки факт того, что написано кривовато, привяжется навсегда к приложению в наших головах, повысит уровень адреналина, снизит стрессоустойчивость. Короче, самим же хуже будет. А потому давайте решать, что завершать установку при наличии подобных ошибок нельзя ни в коем случае.

Схема 2. Вторая версия кода (конкретные действия спрятаны в вызовы функций):

Сохраняем в лог запрос с портала

Пробуем получить ранее сохраненные о портале данные

Есть ли запись о портале?

фиксируем факт установки приложения в логах

фиксируем факт обновления в логах

Выводим страницу пользователю

есть ли сообщение об ошибке?

подключаем js-библиотеку портала

Думаю, что все понятно, кроме вызовов createUserMessage() и rollBackIntstall().

По первому. Дело в том, что ошибки могут быть как разного уровня критичности, так и требовать разных действий от пользователя. В данном случае фатальные ошибки — это неудача сохранения данных о портале, отписки от событий, подписки на события; некритичные — ошибка записи в логи. При фатальной ошибке мы должны сформировать пользователю сообщение, из которого он сумел бы понять свою ситуацию и предпринять правильные действия. Если нам не удалось записать что-то в базу, то проблема на нашей стороне, скорее временная и исчезнет, например, как только станет доступным сервер базы данных, в этом случае нужно посоветовать подождать и повторить установку. Если не удается отписаться/подписаться, то, возможно, у пользователя, устанавливающего приложение, недостаточно прав, и тогда ему нужно сообщить, чтобы установку выполнил администратор портала.

Теперь по второму методу. С ним попроще: если мы зафиксировали у себя данные о портале (добавили или обновили), а ошибка произошла на этапе событий, то очевидно нам следует вернуть назад все, как было. Отсюда возникает задача запоминать выполненные действия и исходные данные. Либо, если все действия были связаны с базой данных, использовать транзакции.

Если теперь посмотреть на код приложения, то понятно становится высказывание, что программирование — это работа с ошибками. И посмотрев на код еще раз, вижу, что в двух местах вызывается запись в лог факта установки/обновления и совсем не там, где надо бы. Эти два действия фактически различаются лишь значением одного поля EVENT_TYPE, и вызываются из мест, в которых факт установки/обновления еще не факт. Так что исправим эту ошибку. Там, где было логирование, будем лишь запоминать тип события, а само логирование перенесем в конец установки, когда точно известно, все ли прошло гладко.

Схема 3. Третья версия:

Сохраняем в лог запрос с портала

Пробуем получить ранее сохраненные о портале данные

Есть ли запись о портале?

фиксируем факт установки/обновления в логах

Выводим страницу пользователю

есть ли сообщение об ошибке?

подключаем js-библиотеку портала

Логика установки приложения теперь не вызывает вопросов. Но вызывает вопрос логирование. В коде указано, что мы логируем сам запрос с портала. Вот он:

здесь (не удивляйтесь только):

А я их, вроде как, рекомендовал шифровать при сохранении в базу. Если так рассудить, то нам и логировать-то его не нужно, поскольку все, что в нем содержится нам итак будет известно, разве что язык. В логи всегда попадет либо факт установки, либо ошибки при установке. Но в действительности запрос может приходить и не с портала вовсе, а из хакерского приложения. В таком случае зачем его вообще логировать? И по этом размышлении становится понятно, что непонятно, как приложение вообще защищено от левых запросов. В результате наш список действий дополняется еще одним пунктом:

17. Проверка валидности запроса извне.

В данном случае (при установке приложения) мы так и так делаем запрос на портал для получения дополнительной информации, вызывая app.info с переданным нам access_token (AUTH_ID). Какие возникают варианты ответа:

• пустой
• с ошибкой
• с данными о приложении (и портале)

Причиной первого может быть формирование неверного УРЛ к rest-у портала, например, когда кто-то стукнулся на страницу установки напрямую и никакого домена в запросе нет или он неверный. Второй вариант. Все запросы в портал приложение должно, по-хорошему, не только выполнять через защищенное соединение (по SSL), но и с проверкой сертификата сервера, не допуская самоподписанные. При пустом теле ответа можно проверить код ошибки (http status code ответа), и, если до сервера достучаться не удалось именно из-за неверного сертификата, то об этом необходимо сообщить пользователю. Битрикс24 существует как облачный, так и коробочный, и здесь мы имеем дело, стало быть, с коробкой, размещенной на собственном сервере владельца.

С ошибкой. Причиной этого варианта, скорее всего, будет также коробка. Например, она возвратит нам 404 Not Found страницу, т.е. целый лопух html, или скорее страницу с формой авторизации. Это будет означать, что в коробке не установлен модуль rest. Об этом также следует сообщить пользователю. Другая причина — ошибка в работе rest-а при неверно накатанном обновлении портала, ну. тут, вероятно, следует показать саму ошибку, поскольку вариации непредсказуемы.

Последний вариант — успешный, так что возвратимся к логированию. Запросы можно слать миллиардами и забить всю нашу таблицу логов, поэтому логировать стоит, по всей видимости, только валидные запросы, в которых rest все-таки вернул какой-то ответ или была ошибка ssl-сертификата. В логи необходимо из запроса, пожалуй, писать данные по тем ключам, которые не содержат конфиденциальной информации. Т.е. значения токенов писать точно не стоит.

Теперь перейдем к сохранению данных в базу. По идее, когда запрос определен как валидный, и app.info вернул информацию о портале, переданные LANG, member_id должны содержать корректную информацию. Однако, в этом вопросе лучше придерживаться параноидального метода, который гласит: не верь присланным данным. Поэтому все, что сохраняется в базу должно быть предварительно обезврежено. Так язык всегда состоит из двух букв и не содержит ничего кроме букв, member_id состоит лишь из букв и цифр и т.д. Перед сохранением нужно удалить все неподходящие символы регуляркой, обезопасив приложение от атак. Еще лучше, когда эту работу берет на себя фреймворк, который вы используете. Так, например, БУС (Битрикс Управление Сайтом) всегда проверяет получаемые из запроса данные. И, если ваше приложение строится на подобном фреймворке, получать данные следует не прямым способом, предусмотренным самим языком программирования, а через вызов соответствующего метода фреймворка (напр., в БУС объект request имеет методы get() — для получения данных, переданных как GET, так и POST методом, и getPost() — для получения исключительно «постовых» данных).

На этом с установкой, пожалуй, все. Но на примере подписки хотелось бы чуть коснуться rest-запросов портала. REST Битрикс24 довольно неплохой. Да, порою требуемые для передачи параметры удивляют. Например, где-то регистр ключей имеет значение, а где-то не имеет. А есть еще и запросы, в которых все данные имеют соответствующие ключи, но, тем не менее, переданы должны быть в нужной очередности. Однако, в батч-запросах можно, формируя последовательность команд, из одной обращаться к данным, полученным из предыдущей. Это круто. Рассмотрим удаление подписки на события, оставшейся от прежней версии приложения. Для этого нам нужно получить наши старые обработчики, делаем запрос (команда, параметры):

получаем в результате что-то вроде:

Портал возвращает все прежние подписки нашего приложения. При переходе с версии на версию у нас меняется УРЛ, теперь он должен вместо v1 должен содержать v2.

Удаляем старую подписку, поскольку метода event.update не существует. Можно это сделать отдельными запросами, но Битрикс24 накладывает на их частоту ограничения. При этом частота обращений учитывается по порталу и IP-адресу, с которого они делаются. Так что, если на портале установлено десять наших приложений, размещенных на одном сервере, то ограничение по запросам будет для них общим. Согласно документации: «Разрешается два запроса в секунду. Если лимит превышается, то ограничение начинает срабатывать после 50 запросов». Так что лучше нам будет удаление подписки обернуть в один батч-запрос. Я не буду расписывать здесь все тонкости, а предположу, что есть, как у меня лично, некий метод, который уже умеет формировать подобные запросы. Замечу только, что есть ограничение по кол-во команд, переданных в одном таком запросе, а именно — не более 50. Итак отписка/подписка:

if array res.result

foreach res.result as item

if not empty batch

if not empty res.result_errors

Как я уже сказал, я не вникаю в архитектуру приложения, и имена вызываемых функций здесь служат лишь для указания, какое действие выполняется в данный момент и какие данные оно использует. В этом коде мы точно уверены, что наши подписки никогда не превысят ограничения батч-запросов в 50 команд, но там, где это неочевидно, следует вставлять проверку. При этом нужно учитывать, что размер команд вместе с их параметрами (представьте обновление 5000 компаний или счетов за один раз) может составлять в байтах довольно большое число, так что не стоит собирать все команды в один массив, потом резать его по 50 штук, и затем отправлять эти нарезки на выполнение. Fatal error, cannot allocate memory могут быть запросто получены. Алгоритм обработки в данном случае должен быть иным. Пример в псевдокоде:

while row = getSomething()

if count batch equal 50

Иными словами, внутри цикла мы все время проверяем не достигли ли мы максимума в 50 запросов. Если да, то тут же их выполняем и очищаем наш массив batch — т.е. отсчет начат заново. По окончании цикла вновь проверяем batch, ведь последний проход мог закончится, так и не достигнув кол-ва 50. Если после цикла массив не пустой, то это необработанный остаток, выполняем его.

Ну, теперь и с установкой, и с запросами точно все.

Доставка полезной информации от экспертов по Битрикс24!

Подпишитесь, и раз в неделю у вас на почте будет подборка полезных советов и обзоров про Битрикс24

Источник

2

ответов

Для расширения функциональности Bitrix24 удобно использовать приложения. В данной статье описано создание с нуля локального serverless приложения.

Для установки нашего приложения нам понадобится собственно портал bitrix24, в котором мы обладаем правами администратора или правом установки и редактирования приложений.

Если такого портала нет — создать его можно здесь.

Панель управления приложениями доступна по адресу https://<your-portal-name>.bitrix24.com/marketplace/local/.

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

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

Официальная javascript-библиотека

Создадим папку с произвольным названием и в ней единственный пока файл index.html со следующим содержанием (исходный код):

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta http-equiv="X-UA-Compatible" content="ie=edge" />
    <title>Bitrix24 app tutorial</title>
    <!-- подключаем библиотеку BX24 -->
    <script src="https://api.bitrix24.com/api/v1/"></script>
  </head>
  <body>
    <script>
      /**
      * передаем методу  `init` в качестве параметра callback-функцию 
      * - наше приложение 
      */
      BX24.init(app);

      function app() {
        const initDate = BX24.getAuth();
        console.log("ititDate: ", initDate);
      }
    </script>
  </body>
</html>

Помещаем файл index.html в zip-архив и указываем этот архив в качестве значения поля Загрузите архив с вашим приложением (zip)* в диалоге создания приложения.
Затем нажимаем кнопку «Сохранить»

Посмотрим, что у нас получилось.

Кликаем по Перейти к приложению и видим… пустое место на месте нашего приложения.

Все необходимое для нас на данном этапе находится сейчас в консоли разработчика.

Мы видим, что наше приложение успешно получило данные необходимые для авторизации.

Официальная javascript-библиотека c promise

Использование callback-функций имеет свои преимущества, но не всем нравится или не всегда подходит к ситуации.
Поэтому попробуем получить тот же результат в promise-стиле. Для этого изменим наш index.html (исходный код)

   <body>
     <script>
       /**
-      * передаем методу  `init` в качестве параметра callback-функцию 
-      * - наше приложение 
-      */
-      BX24.init(app);
+       * оборачиваем метод  `init` в promise
+       */
+      var bx24Promise = new Promise(function(resolve, reject) {
+        try {
+          BX24.init(resolve);
+        } catch (err) {
+          resolve(err);
+        }
+      });
+
+      bx24Promise
+        .then(function() {
+          app();
+        })
+        })
+        .catch(function(err) {
+          console.error(err);
+        });

После этого переходим https://<your-portal-name>.bitrix24.com/marketplace/local/list/.
Переходим к редактированию нашего приложения. Измененный файл index.html помещаем в zip-архив и обновляем его в нашем приложении.
Смотрим результат — все работает.
Если откроем файл index.html в браузере локально, то увидим, что обработка ошибок тоже работает.

Неофициальная библиотека BX24

Если вы планируете писать приложение на typescript (можно использовать и с javascript) и/или обладаете умеренным авантюризмом, то можно попробовать использовать сторонние библиотеки для авторизации.
Например эту.
В этом случае наш index.html нужно будет изменить следующим образом (исходный код):

     <meta http-equiv="X-UA-Compatible" content="ie=edge" />
     <title>Bitrix24 app tutorial</title>
     <!-- подключаем библиотеку BX24 -->
-    <script src="https://api.bitrix24.com/api/v1/"></script>
+    <script src="https://unpkg.com/bx24@latest/lib/index.js"></script>
   </head>
   <body>
     <script>
-      /**
-       * оборачиваем метод  `init` в promise
-       */
-      var bx24Promise = new Promise(function(resolve, reject) {
-        try {
-          BX24.init(resolve);
-        } catch (err) {
-          resolve(err);
-        }
-      });
+        var bx24 = new BX24();

-      bx24Promise
-        .then(function() {
-          app();
+        bx24.getAuth()
+        .then(function(auth) {
+            console.log(auth);
         })
-        .catch(function(err) {
-          console.error(err);
-        });
-
-      function app() {
-        const initDate = BX24.getAuth();
-        console.log("ititDate: ", initDate);
-      }
     </script>
   </body>
 </html>

Опять архивируем, опять обновляем наше приложение, опять смотрим, опять все работает.

Инструменты разработки

Полагаю, что к этому времени вы уже достаточно устали от процедуры архивирования и обновления приложения.
Попробуем сделать процесс разработки чуть более удобным и быстрым.
Для этого нам понадобится nodejs .
Проверить его наличие на компьютере можно выполнив:

node -v 

В папке нашего проекта инициализируем npm:

npm init -y

Установим необходимые пакеты:

npm i axios react react-dom bx24
npm i -D parcel-bundler express

Можно аналогично создать проект с помощью create-react-ap или angular-cli.

Состояние проекта после всех изменений можно посмотреть здесь.

Создадим в корне нашего проекта файл server.js

const express = require('express');
const app = express();
const port = process.env.PORT || 3000;
const www = process.env.WWW || './dist';
app.use(express.static(www));
console.log(`serving ${www}`);
app.get('*', (req, res) => {
  res.sendFile(`index.html`, { root: www });
});
app.post('*', (req, res) => {
  res.sendFile(`index.html`, { root: www });
});
app.listen(port, () => console.log(`listening on http://localhost:${port}`));

Этот файл нам нужен для запуска сервера. Встроенные в create-react-app и angular-cli серверы не подойдут, так как сервер стороннего приложения должен отвечать на POST запросы. Для всех, кроме 127.0.0.1 есть еще требования к наличию https.

Создадим папки src и public
В папку public перенесем index.html и изменим его содержимое на:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta http-equiv="X-UA-Compatible" content="ie=edge" />
    <title>Bitrix24 app tutorial</title>
  </head>
  <body>
    <div id="root"></div>
    <script src="../src/index.js">
    </script>
  </body>
</html>

В папке src создадим файлы

// src/index.js
import App from './app/app';
import React from "react";
import ReactDOM from "react-dom";

import "./css/styles.css";

const rootElement = document.getElementById("root");
ReactDOM.render(<App />, rootElement);

// app/app.js
import React, { Component } from "react";
import getCurrentUser from "./services/get-current-user.service";

class App extends Component {
  constructor(props) {
    super(props);
    this.state = {
      loading: true
    };
    getCurrentUser().then(currentUser => {
      this.setState({
        user: currentUser,
        loading: false
      });
    });
  }
  render() {
    if (!this.state.loading) {
      return (
        <div className="App">
          <h1>
            Hello {this.state.user.LAST_NAME} {this.state.user.NAME}
          </h1>
          <h2>Start editing to see some magic happen!</h2>
        </div>
      );
    } else {
      return (
        <div>Загрузка...</div>
      )
    }
  }
}

export default App;

// app/services/get-current-user.service.js
import { BX24 } from "bx24";
import axios from "axios";

function getCurrentUser() {
  const bx24 = new BX24();
  const urlParams = new URLSearchParams(window.location.search);
  const baseUrl = `
    ${urlParams.get("PROTOCOL") === 0 ? "https" : "http"}://${urlParams.get("DOMAIN")}
`;

  const currentUserPromise = new Promise((resolve, reject) => {
    bx24.getAuth().then(auth => {
      axios({
        method: "get",
        url: baseUrl + "/rest/user.current?auth=" + auth.ACCESS_TOKEN
      }).then(response => {
        resolve(response.data.result);
      });
    });
  });
  return currentUserPromise;
}

export default getCurrentUser;

Если package.json еще не создан, выполним:

npm init -y

Добавим скрипты в package.json:

"scripts": {
    //
    "start": "node server.js",
    "watch": "parcel watch ./public/index.html"
}

Далее так как и команда start и команда watch не заканчиваются, их нужно запускать параллельно. Для этого в двух командных строках запускаем

npm run watch

и

npm run start

Завершим настройку среды разработки редактированием нашего приложения в Bitrix24.
Перейдем в диалог редактирования нашего приложения и укажем в поле
Укажите ссылку* значение http://127.0.0.1:3000/

Перейдите к просмотру вашего приложения:
Вы должны увидеть приветствие с именем текущего пользователя:

Если использовать официальную библиотеку, то отличаться будут только два файла:

// src/app/serviced/get-current-user.service.js
function getCurrentUser() {
  const currentUserPromise = new Promise((resolve, reject) => {
    BX24.init(function() {
      BX24.callMethod("user.current", {}, function(res) {
        resolve(res.answer.result);
      });
    });
  });
  return currentUserPromise;
}

export default getCurrentUser;

и

<!-- public/index.html -->
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta http-equiv="X-UA-Compatible" content="ie=edge" />
    <title>Bitrix24 app tutorial</title>
    <script src="https://api.bitrix24.com/api/v1/"></script>
  </head>
  <body>
    <div id="root"></div>
    <script src="../src/index.js">
    </script>
  </body>
</html>

Итоговый код проекта для использования официальной библиотеки здесь.

Ознакомиться со всеми возможными методами и возможностями API можно здесь.

Исходный код можно увидеть здесь.

И последнее замечание. Описанные выше способы и методы не являются набором лучших практик. Это скорее предложение к конструктивному обсуждению.

UPD: желающих высказаться о 1С-Битрикс или Битрикс24 прошу сделать небольшое интеллектуальное усилие и осознать, что статья не о Битрикс24 и совсем не о 1С-Битрикс.
Это если в Питере прохожий объясняет другому, как пройти к Петропавловской крепости и тут третий вмешивается с репликой:
«Да тиран был ваш Петр I. Тиран и деспот. И усы у него дурацкие».

Если есть конструктивные замечания к коду в СТАТЬЕ или к подходам или к используемым паттернам — добро пожаловать.

Добрый день.

Изучаю приложения Bitrix. Есть у них т.н. «приложения первого типа» — содержат обычные файлы html и js, общаются с API Битрикса с помощью специальной JS библиотеки. Проблем с добавлением самого приложения нет, проблем с обращением к данным Битрикса тоже нет — я могу спокойно получить список контактов или клиентов и т.д.

Вопрос в следующем — как встроить пункт вызова этого приложения в меню, к примеру, контакта?

Пошерстил руководство, нашел метод REST API — placement.bind. Нашел уроки, но все они касаются внешних приложений — с использованием access_token авторизации через OAth… Также смущает обязательность использования параметра HANDLER — в мануале это URL обработчика (по сути внешнего приложения), а мой обработчик тут же вот, во фрейме самого Битрикс.

В описании самого битрикс сказано, что все токены разрешений передаются приложению первого типа в момент вызова. Подозреваю, что требуется использовать файл install.html с вызовом методов Битрикса для встраивания приложения, но поиск в сети не даёт примеров хотя бы в общем виде.

Запрос в поддержку Битрикс отправлял, ответа от них пока что не поступало.

define('C_REST_CURRENT_ENCODING','windows-1251');

define('C_REST_WEB_HOOK_URL','https://xxx.bitrix24.ru/rest/1/douasdqdsxSWgc3mgc1/');

require_once('src/crest.php');

// put an example below
echo '<PRE>';
print_r(CRest::call(
   'crm.lead.add',
   [
      'fields' =>[
          'TITLE' => 'Lead name',//Title*[string]
          'NAME' => 'Name',//Name[string]
          'LAST_NAME' => 'Last name',//Last name[string]
      ]
   ])
);

echo '</PRE>';

require_once('src/crest.php');

// put an example below
echo '<PRE>';
print_r(CRest::call(
   'crm.lead.add',
   [
      'fields' =>[
          'TITLE' => 'Lead name',//Title*[string]
          'NAME' => 'Name',//Name[string]
          'LAST_NAME' => 'Last name',//Last name[string]
      ]
   ])
);

echo '</PRE>';

require_once('src/crest.php');

// put an example below
echo '<PRE>';
print_r(CRest::call(
   'crm.lead.add',
   [
      'fields' =>[
          'TITLE' => 'Lead name',//Title*[string]
          'NAME' => 'Name',//Name[string]
          'LAST_NAME' => 'Last name',//Last name[string]
      ]
   ])
);

echo '</PRE>';

define('C_REST_CURRENT_ENCODING','windows-1251');

define('C_REST_WEB_HOOK_URL','https://xxx.bitrix24.ru/rest/1/douasdqdsxSWgc3mgc1/');

require_once('src/crest.php');

// put an example below
echo '<PRE>';
print_r(CRest::call(
   'crm.lead.add',
   [
      'fields' =>[
          'TITLE' => 'Название лида',//Заголовок*[string]
          'NAME' => 'Имя',//Имя[string]
          'LAST_NAME' => 'Фамилия',//Фамилия[string]
      ]
   ])
);

echo '</PRE>';

require_once('src/crest.php');

// put an example below
echo '<PRE>';
print_r(CRest::call(
   'crm.lead.add',
   [
      'fields' =>[
          'TITLE' => 'Название лида',//Заголовок*[string]
          'NAME' => 'Имя',//Имя[string]
          'LAST_NAME' => 'Фамилия',//Фамилия[string]
      ]
   ])
);

echo '</PRE>';

require_once('src/crest.php');

// put an example below
echo '<PRE>';
print_r(CRest::call(
   'crm.lead.add',
   [
      'fields' =>[
          'TITLE' => 'Название лида',//Заголовок*[string]
          'NAME' => 'Имя',//Имя[string]
          'LAST_NAME' => 'Фамилия',//Фамилия[string]
      ]
   ])
);

echo '</PRE>';

crest’s People

'UF_CRM_1618612593' => [
          ['VALUE' => 246]
        ]

while (!$finish)
{
    /**
     * Выполняем пока не заберем все данные, в этом случае не стоит забывать и про задержку между хитами.
     * Либо каждый раз выбираем только 50, начиная с того элемента, на котором остановилась прошлая итерация
     */

    $users = CRest::call(
        'voximplant.statistic.get',
        [
            'order' => ['ID' => 'ASC'],
            'select' => $select,
            'filter' => [
                '>ID' => $leadID,
                'PORTAL_USER_ID' => $departmentId,
                'CALL_TYPE' => 1,
                ">CALL_START_DATE" => $startDate.'T00:00:00',
                "<CALL_START_DATE" => $endDate.'T23:59:59',
            ],
            'start' => -1
        ]
    );

    if (count($users['result']) > 0)
    {
        foreach ($users['result'] as $lead)
        {
            $leadID = $lead['ID'];
            $subResult = [];
            foreach ($select as $value) {
                $subResult[$value] = $lead[$value];
            }
            $finalResult[] = $subResult;
        }
        // Do something
    }
    else
    {
        $finish = true;
    }
}

echo json_encode($finalResult);