Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Добавить событие календаря для работы с клиентами», проанализируем лучшие практики и покажем, как правильно использовать добавить событие в реальных задачах.
Добавить событие календаря для работы с клиентами
> Scope: crm
>
> Кто может выполнять метод: пользователи с правом на изменение элемента CRM
События календаря можно добавлять автоматически, чтобы напомнить сотрудникам о встречах или звонках клиентам. Событие со ссылкой на контакт клиента появится в календаре ответственного сотрудника. В карточке контакта добавится дело для события.
Чтобы добавить событие в календарь, последовательно выполним два метода:
1. crm.contact.get — получим данные клиента
2. crm.activity.add — создадим событие календаря
1\. Получим данные клиента
Используем метод crm.contact.get с идентификатором клиента. Например, нас интересует контакт с идентификатором 1.
- JS
BX24.callMethod(
'crm.contact.get',
{
'id': 1
},
);- PHP
require_once('crest.php');
$resultContact = CRest::call(
'crm.contact.get',
[
'id' => 1
]
);В результате получим данные клиента, включая телефон PHONE и идентификатор ответственного сотрудника ASSIGNED_BY_ID.
{
"result": {
"ID": "1",
"POST": "Исполнительный директор",
"COMMENTS": null ,
"NAME": "Алексей",
"SECOND_NAME": "Кириллович",
"LAST_NAME": "Вронский",
"PHOTO": null,
"LEAD_ID": null,
"TYPE_ID": "SHARE",
"SOURCE_ID": "SELF",
"SOURCE_DESCRIPTION": null,
"COMPANY_ID": "52",
"BIRTHDATE": "",
"EXPORT": "Y",
"HAS_PHONE": "Y",
"HAS_EMAIL": "Y",
"HAS_IMOL": "N",
"DATE_CREATE": "2023-08-18T12:43:42+03:00",
"DATE_MODIFY": "2023-10-17T15:59:13+03:00",
"ASSIGNED_BY_ID": "61",
"CREATED_BY_ID": "57",
"MODIFY_BY_ID": "47",
"OPENED": "N",
"ORIGINATOR_ID": null,
"ORIGIN_ID": null,
"ORIGIN_VERSION": null,
"FACE_ID": null,
"LAST_ACTIVITY_TIME": "2025-03-15T10:38:21+02:00",
"ADDRESS": null,
"ADDRESS_2": null,
"ADDRESS_CITY": null,
"ADDRESS_POSTAL_CODE": null,
"ADDRESS_REGION": null,
"ADDRESS_PROVINCE": null,
"ADDRESS_COUNTRY": null,
"ADDRESS_LOC_ADDR_ID": null,
"UTM_SOURCE": null,
"UTM_MEDIUM": null,
"UTM_CAMPAIGN": null,
"UTM_CONTENT": null,
"UTM_TERM": null,
"LAST_ACTIVITY_BY": "1",
"PHONE": [
{
"ID": "1326",
"VALUE_TYPE": "MOBILE",
"VALUE": "88001001020",
"TYPE_ID": "PHONE"
},
],
"EMAIL": [
{
"ID": "1328",
"VALUE_TYPE": "WORK",
"VALUE": "vronsky@example.ru",
"TYPE_ID": "EMAIL"
},
]
},
"time": {
"start": 1747737934.888428,
"finish": 1747737934.945823,
"duration": 0.057394981384277344,
"processing": 0.029510021209716797,
"date_start": "2025-05-20T13:45:34+03:00",
"date_finish": "2025-05-20T13:45:34+03:00"
}
}2\. Создадим событие календаря
Чтобы создать событие, используем метод crm.activity.add. В него нужно передать данные клиента и произвольные параметры нового события.
SUBJECT— название события. Укажемcalendar title.
DESCRIPTION— описание. Например,calendar body.
DESCRIPTION_TYPE— формат текста описания. Возможные значения:1— обычный текст,2— HTML-разметка,3— BB-код. Зададим значение3.
OWNER_ID— идентификатор контакта. Передаем идентификатор клиента —1.
OWNER_TYPE_ID— идентификатор типа объекта CRM. Передаем3— контакт. Полный список типов объектов можно получить с помощью метода crm.enum.ownertype.
TYPE_ID— тип события. Укажем1— встреча. Список типов событий можно получить с помощью метода crm.enum.activitytype.
COMMUNICATIONS— контактные данные клиента:
VALUE— номер телефона, берем значениеVALUEиз массиваPHONE, который получен на первом шаге,
ENTITY_ID— идентификатор клиента, передаем1,
ENTITY_TYPE_ID— идентификатор типа объекта, передаем3—контакт.
START_TIMEиEND_TIME— дата и время начала и окончания в формате ISO 8601, укажем, например, длительность один час,
RESPONSIBLE_ID— идентификатор ответственного, передаемASSIGNED_BY_ID, который получен на первом шаге.
- JS
BX24.callMethod(
'crm.activity.add',
{
'fields': {
"SUBJECT": "calendar title",
"DESCRIPTION": "calendar body",
"DESCRIPTION_TYPE": 3,
"OWNER_ID": 1,
"OWNER_TYPE_ID": 3,
"TYPE_ID": 1,
"COMMUNICATIONS": [
{
'VALUE': "88001001020",
'ENTITY_ID': 1,
'ENTITY_TYPE_ID': 3
}
],
"START_TIME": "2025-05-20T14:00:00",
"END_TIME": "2025-05-20T15:00:00",
"RESPONSIBLE_ID": 61
}
},
);- PHP
require_once('crest.php');
$result = CRest::call(
'crm.activity.add',
[
'fields' => [
"SUBJECT" => "calendar title",
"DESCRIPTION" => "calendar body",
"DESCRIPTION_TYPE" => 3,
"OWNER_ID" => 1,
"OWNER_TYPE_ID" => 3,
"TYPE_ID" => 1,
"COMMUNICATIONS" => [
[
'VALUE' => "88001001020",
'ENTITY_ID' => 1,
'ENTITY_TYPE_ID' => 3
]
],
"START_TIME" => "2025-05-20T14:00:00",
"END_TIME" => "2025-05-20T15:00:00",
"RESPONSIBLE_ID" => 61,
]
]
);Если событие создано успешно, метод вернет его идентификатор. Если вы получили ошибку error, изучите описание возможных ошибок в документации метода crm.activity.add.
{
"result": 6915,
}Пример кода
Пример создает дело «Встреча» в CRM-карточке контакта и событие длительностью один час в календаре сотрудника.
- JS
var contactID = 1;
BX24.callMethod(
'crm.contact.get',
{
'id': contactID
},
function(resultContact) {
if (resultContact.error()) {
console.error(resultContact.error() + ': ' + resultContact.error_description());
} else {
var resultActivity = [];
if (resultContact.data().ASSIGNED_BY_ID && resultContact.data().PHONE) {
var contactPhone = resultContact.data().PHONE[0];
var staffID = resultContact.data().ASSIGNED_BY_ID;
BX24.callMethod(
'crm.activity.add',
{
'fields': {
"SUBJECT": "calendar title",
"DESCRIPTION": "calendar body",
"DESCRIPTION_TYPE": 3, // text, html, bbCode type id in: BX24.callMethod('crm.enum.contenttype');
"OWNER_ID": contactID,
"OWNER_TYPE_ID": 3, // BX24.callMethod('crm.enum.ownertype');
"TYPE_ID": 1, // BX24.callMethod('crm.enum.activitytype');
"COMMUNICATIONS": [
{
'VALUE': contactPhone.VALUE,
'ENTITY_ID': contactID,
'ENTITY_TYPE_ID': 3 // BX24.callMethod('crm.enum.ownertype');
}
],
"START_TIME": new Date().toISOString(),
"END_TIME": new Date(new Date().getTime() + 3600 * 1000).toISOString(),
"RESPONSIBLE_ID": staffID,
}
},
function(resultActivity) {
if (resultActivity.error()) {
console.error(resultActivity.error() + ': ' + resultActivity.error_description());
console.log(JSON.stringify({ 'message': 'Activity not added: ' + resultActivity.error_description() }));
} else {
console.log(JSON.stringify({ 'message': 'Activity add' }));
}
}
);
} else {
console.log(JSON.stringify({ 'message': 'Activity not added' }));
}
}
}
);- PHP
$contactID = 1;
$resultContact = CRest::call(
'crm.contact.get',
[
'id' => $contactID
]
);
$resultActivity = [];
if (!empty($resultContact['result']['ASSIGNED_BY_ID']) && !empty($resultContact['result']['PHONE']))
{
$contactPhone = reset($resultContact['result']['PHONE']);
$staffID = $resultContact['result']['ASSIGNED_BY_ID'];
$resultActivity = CRest::call(
'crm.activity.add',
[
'fields' => [
"SUBJECT" => "calendar title",
"DESCRIPTION" => "calendar body",
"DESCRIPTION_TYPE" => 3,//text,html,bbCode type id in: CRest::call('crm.enum.contenttype');
"OWNER_ID" => $contactID,
"OWNER_TYPE_ID" => 3, // CRest::call('crm.enum.ownertype');
"TYPE_ID" => 1, // CRest::call('crm.enum.activitytype');
"COMMUNICATIONS" => [
[
'VALUE' => $contactPhone['VALUE'],
'ENTITY_ID' => $contactID,
'ENTITY_TYPE_ID' => 3// CRest::call('crm.enum.ownertype');
]
],
"START_TIME" => date("Y-m-d H:i:s", time()),
"END_TIME" => date("Y-m-d H:i:s", time() + 3600),
"RESPONSIBLE_ID" => $staffID,
]
]
);
}
if (!empty($resultActivity['result']))
{
echo json_encode(['message' => 'Activity add']);
}
elseif (!empty($resultActivity['error_description']))
{
echo json_encode(['message' => 'Activity not added: ' . $resultActivity['error_description']]);
}
else
{
echo json_encode(['message' => 'Activity not added']);
}💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «Добавить событие календаря для работы с клиентами» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru
