Для работы с историей контактов и лидов в Битрикс24 через PHP код нам понадобится использовать API данной платформы.
Существует несколько способов работать с историей контактов и лидов. В первую очередь, необходимо настроить взаимодействие с API. Для этого нужно получить доступ к своему аккаунту на портале Битрикс24 и создать приложение в разделе "Приложения". В процессе создания приложения необходимо указать ссылку на веб-хук для обработки входящих запросов к API.
После этого можно приступать к работе с историей контактов и лидов. Лиды и контакты хранятся в разных сущностях, поэтому для работы с ними используется разный набор методов API.
Для работы с историей лидов можно использовать метод "crm.lead.list". Он позволяет получить список всех лидов, а также фильтровать их по различным параметрам. Например, чтобы получить все лиды с определенным статусом, можно добавить параметр "filter" с указанием значения статуса.
Пример кода для получения списка лидов с определенным статусом:
$apiUrl = 'https://yourdomain.bitrix24.ru/rest/1/yourWebhook/'; $method = 'crm.lead.list'; $params = array( 'filter' => array('STATUS_ID' => 'NEW'), 'select' => array('ID', 'TITLE', 'NAME', 'LAST_NAME', 'DATE_CREATE') ); $queryUrl = $apiUrl . $method . '?' . http_build_query($params); $response = file_get_contents($queryUrl); $result = json_decode($response, true); if ($result && array_key_exists('result', $result)) { foreach ($result['result'] as $lead) { echo 'ID: ' . $lead['ID'] . '<br>'; echo 'Title: ' . $lead['TITLE'] . '<br>'; echo 'Name: ' . $lead['NAME'] . '<br>'; echo 'Last Name: ' . $lead['LAST_NAME'] . '<br>'; echo 'Created: ' . $lead['DATE_CREATE'] . '<br><br>'; } } else { echo 'Ошибка запроса: ' . $response; }
Аналогичным образом можно получить список контактов с помощью метода "crm.contact.list". В этом случае, фильтрация также может осуществляться по различным параметрам, например, по ID отвественного пользователя.
Пример кода для получения списка контактов с определенным отвественным:
$apiUrl = 'https://yourdomain.bitrix24.ru/rest/1/yourWebhook/'; $method = 'crm.contact.list'; $params = array( 'filter' => array('ASSIGNED_BY_ID' => '123'), 'select' => array('ID', 'NAME', 'LAST_NAME', 'DATE_CREATE') ); $queryUrl = $apiUrl . $method . '?' . http_build_query($params); $response = file_get_contents($queryUrl); $result = json_decode($response, true); if ($result && array_key_exists('result', $result)) { foreach ($result['result'] as $contact) { echo 'ID: ' . $contact['ID'] . '<br>'; echo 'Name: ' . $contact['NAME'] . '<br>'; echo 'Last Name: ' . $contact['LAST_NAME'] . '<br>'; echo 'Created: ' . $contact['DATE_CREATE'] . '<br><br>'; } } else { echo 'Ошибка запроса: ' . $response; }
Кроме получения списка лидов и контактов, API Битрикс24 также предоставляет методы для создания, обновления и удаления записей. Подробности по работе с другими методами API можно найти в официальной документации Битрикс24.
Надеюсь, этот ответ поможет вам понять, как работать с историей контактов и лидов в Битрикс24 через PHP код.