Интеграция Bitrix24 с чертом лысым

В этой статье мы разберемся как очень просто сделать интеграцию битрикс 24 с чем угодно, на примере открытого JSON API StarWars - https://swapi.dev/

В результате мы получим в нашу CRM контакты лидов из вселенной звездных войн.

Сначала заходим и регистрируем себе бесплатный б24 https://www.bitrix24.ru/

Мы создадим "Серверное локальное приложение с интерфейсом в Битрикс24" как в официальной инструкции, но с принципиальным отличием. Вот алгоритм того что оно будет делать:

1. Обратится к  swapi.co и сгенерирует список контактов в переменную массива
2. Используя класс CRest добавит методом crm.contact.add новых контактов в б24.
3. PROFIT

1. Напишем код получения лидов в файле index.php:

$url = 'https://swapi.dev/api/people/?format=json';
$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_HEADER => 0,
    CURLOPT_RETURNTRANSFER => 1,
    CURLOPT_URL => $url,
));
$result = json_decode(curl_exec($curl),1);
$peoples=[];
foreach ($result['results'] as $key => $man){
    $peoples[$key]['name'] = $man['name'];
    $peoples[$key]['phone'] = $man['height'].$man['mass'];
}
//dump($peoples);
curl_close($curl);

2.1 Скачаем библиотеку работы с API б24 https://github.com/bitrix-tools/crest. Поместим её на нашем сервере в папке crest рядом с файлом Index.php

2.2 Создадим в нашем б24 входящий веб-хук для внешнего доступа к REST API. Дадим ему доступ на CRM.

2.3 в файле crest/settings.php пропишем наш сгенерированный веб хук :

define('C_REST_WEB_HOOK_URL','https://b24-reh9k3.bitrix24.ru/rest/1/OUR_GENERATED_WEBHOOK/');//url on creat Webhook

2.4 допишем в Index.php код проходящийся по массиву $peoples и добавляющий лидов в CRM:

    require_once('crest/crest.php');
//    $phone = 123123;
//    $name = 'mytestname';
    foreach ($peoples as $contact){
        $fields['PHONE'][0]=array( "VALUE" => $contact['phone'], "VALUE_TYPE" => "WORK" );
        $fields['NAME'] = $contact['name'];
        $result =  CRest::call('crm.contact.add',array('fields' => $fields));
        //dump($result);
        dump('Пользователь '.$contact['name'].' добавлен с id = '.$result['result']);
    }

2.5 откроем наше приложение: Приложение->Мои приложения->Тут выбрать наше приложение и нажать "Перейти к приложению"

Приложение автоматически добавит лидов

2.6 Проверить результат можно в меню CRM->Контакты

PROFIT

курс Приложения Битрикс24 (здесь примеры реализаций)
https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=99&INDEX=Y 

Документация по REST Б24:
https://dev.1c-bitrix.ru/rest_help/users/user_current.php

основы использования CRest 
https://dev.1c-bitrix.ru/rest_help/rest_sum/crest.php
https://github.com/bitrix-tools/crest

https://phpqa.ru/pets/b24/