README

一个类，用于通过传入的webhook将申请传输到bitrix24（创建新的潜在客户）

安装

使用composer

composer require atlas89/bitrix-createleads-api

使用

首先需要在bitrix24的管理控制台中添加传入的webhook

添加新潜在客户的URI

https://test.bitrix24.by/rest/1/q8khfywwh6a3c14n/crm.lead.add，其中

test -> $domain

rest/1/q8khfywwh6a3c14n - $hook

crm.lead.add - $uri_api

创建类对象。在构造函数中指定必要的数据

$client = new \atlasBitrixRestApi\ClientBitrix($domain, $hook, $uri_api);

或无需构造函数

$client = new \atlasBitrixRestApi\ClientBitrix();
    $client->setDomain(test);
    $client->setHook("rest/1/q8khfywwh6a3c14n");
    $client->setUriApi("/crm.lead.add/");

为新的潜在客户形成数据数组（通常使用网站表单的字段数据）

$data = [
        "TITLE" => "Запрос с сайта",
        "NAME" => "Дима",
        "SECOND_NAME" =>"Петрович",
        "LAST_NAME"=> "Смолов",
        "CURRENCY_ID" => "USD",
        "OPPORTUNITY" => 12500,
        "PHONE" => [ 
                        [ "VALUE" =>"+375111111111", "VALUE_TYPE" => "WORK"],
                    ],
        "EMAIL" => [
                        ['VALUE' => "mail@yandex.by", 'VALUE_TYPE' => 'HOME'],
                ],
        "COMMENTS" => "ПРИВЕТ НОВЫЙ ЛИД",
        "UTM_SOURCE" => "utm"
    ];

完整字段列表可在官方文档中找到

https://dev.1c-bitrix.ru/rest_help/crm/leads/crm_lead_fields.php

执行创建bitrix24新潜在客户的请求

$response = $client->createLead($data); 
json_decode($response, true));

响应以JSON格式返回。需要使用json_decode函数处理

在将新潜在客户添加到CRM bitrix24之前，会检查是否有具有指定电话号码和电子邮件地址的联系人。如果bitrix24中已存在联系人，则潜在客户将与现有联系人关联，并在系统中标记为重复。

电话号码检查掩码（针对白俄罗斯）应与+375(99)999-99-99相匹配

可用方法

从bitrix24获取联系人列表

$client->setUriApi("crm.contact.list");
$response=$client->getContacts();

使用过滤器从bitrix24获取联系人列表

$filter_phone =[
                            "filter" => [
                                "PHONE" => "номер телефона",
                            ],
                            "select" => [
                                "ID"
                            ]
                        ];
$client->setUriApi("crm.contact.list");
$response=$client->getContacts(filter_phone);

官方文档中的完整描述

https://dev.1c-bitrix.ru/rest_help/crm/contacts/crm_contact_list.php

从bitrix24获取潜在客户列表

$client->setUriApi("crm.lead.list");
$response=$client->getLeads();