Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Отправить сообщение в Ленту CRM crm.livefeedmessage.add». Вы узнаете экспертные методики работы с crm.livefeedmessage.add и научитесь избегать типичных ошибок начинающих разработчиков.
Отправить сообщение в Ленту CRM crm.livefeedmessage.add
> Scope: crm
>
> Кто может выполнять метод: любой пользователь
Метод добавляет сообщение в ленту CRM.
Параметры метода
Названиетип | Описание |
|---|---|
POST_TITLEstring | Заголовок сообщения |
MESSAGEtext | Текст сообщения. |
| SPERM | Права на просмотр сообщения, пример: |
ENTITYTYPEID integer | Тип сущности, в которой опубликовано сообщение: — 1 — лид; — 2 — сделка; — 3 — контакт; — 4 — компания |
ENTITYID integer | ID конкретного лида/сделки/контакта/компании, в которой опубликовано сообщение. |
FILESfile | Файлы сообщения |
Примеры кода
Пример 1
- cURL (Webhook)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"POST_TITLE":"Немного о сервисе","MESSAGE":"Битрикс24 создан на базе платформы Bitrix Framework.","SPERM":{"CRMCONTACT":["CRMCONTACT3","CRMCONTACT7"],"CRMCOMPANY":["CRMCOMPANY1","CRMCOMPANY3"],"CRMDEAL":["CRMDEAL3","CRMDEAL5"],"CRMLEAD":["CRMLEAD9","CRMLEAD11"],"SG":["SG5","SG9"],"U":["U1","U3"],"DR":["DR1","DR7"]},"ENTITYTYPEID":3,"ENTITYID":3}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/crm.livefeedmessage.add- cURL (OAuth)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"POST_TITLE":"Немного о сервисе","MESSAGE":"Битрикс24 создан на базе платформы Bitrix Framework.","SPERM":{"CRMCONTACT":["CRMCONTACT3","CRMCONTACT7"],"CRMCOMPANY":["CRMCOMPANY1","CRMCOMPANY3"],"CRMDEAL":["CRMDEAL3","CRMDEAL5"],"CRMLEAD":["CRMLEAD9","CRMLEAD11"],"SG":["SG5","SG9"],"U":["U1","U3"],"DR":["DR1","DR7"]},"ENTITYTYPEID":3,"ENTITYID":3},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.livefeedmessage.add- JS
try
{
const response = await $b24.callMethod(
"crm.livefeedmessage.add",
{
fields:
{
"POST_TITLE": "Немного о сервисе",
"MESSAGE": "Битрикс24 создан на базе платформы Bitrix Framework.",
"SPERM": {
"CRMCONTACT": ["CRMCONTACT3", "CRMCONTACT7"],
"CRMCOMPANY": ["CRMCOMPANY1", "CRMCOMPANY3"],
"CRMDEAL": ["CRMDEAL3", "CRMDEAL5"],
"CRMLEAD": ["CRMLEAD9", "CRMLEAD11"],
"SG": ["SG5", "SG9"],
"U": ["U1", "U3"],
"DR": ["DR1", "DR7"],
},
"ENTITYTYPEID": 3,
"ENTITYID": 3,
}
}
);
const result = response.getData().result;
console.info("Создано сообщение с ID " + result);
}
catch(error)
{
console.error(error);
}- PHP
try {
$response = $b24Service
->core
->call(
'crm.livefeedmessage.add',
[
'fields' => [
'POST_TITLE' => 'Немного о сервисе',
'MESSAGE' => 'Битрикс24 создан на базе платформы Bitrix Framework.',
'SPERM' => [
'CRMCONTACT' => ['CRMCONTACT3', 'CRMCONTACT7'],
'CRMCOMPANY' => ['CRMCOMPANY1', 'CRMCOMPANY3'],
'CRMDEAL' => ['CRMDEAL3', 'CRMDEAL5'],
'CRMLEAD' => ['CRMLEAD9', 'CRMLEAD11'],
'SG' => ['SG5', 'SG9'],
'U' => ['U1', 'U3'],
'DR' => ['DR1', 'DR7'],
],
'ENTITYTYPEID' => 3,
'ENTITYID' => 3,
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Создано сообщение с ID ' . $result;
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error creating live feed message: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
"crm.livefeedmessage.add",
{
fields:
{
"POST_TITLE": "Немного о сервисе",
"MESSAGE": "Битрикс24 создан на базе платформы Bitrix Framework.",
"SPERM": {
"CRMCONTACT": ["CRMCONTACT3", "CRMCONTACT7"],
"CRMCOMPANY": ["CRMCOMPANY1", "CRMCOMPANY3"],
"CRMDEAL": ["CRMDEAL3", "CRMDEAL5"],
"CRMLEAD": ["CRMLEAD9", "CRMLEAD11"],
"SG": ["SG5", "SG9"],
"U": ["U1", "U3"],
"DR": ["DR1", "DR7"],
},
"ENTITYTYPEID": 3,
"ENTITYID": 3,
}
},
function(result)
{
if(result.error())
console.error(result.error());
else
console.info("Создано сообщение с ID " + result.data());
}
);- PHP CRest
require_once('crest.php');
$result = CRest::call(
'crm.livefeedmessage.add',
[
'fields' => [
'POST_TITLE' => 'Немного о сервисе',
'MESSAGE' => 'Битрикс24 создан на базе платформы Bitrix Framework.',
'SPERM' => [
'CRMCONTACT' => ['CRMCONTACT3', 'CRMCONTACT7'],
'CRMCOMPANY' => ['CRMCOMPANY1', 'CRMCOMPANY3'],
'CRMDEAL' => ['CRMDEAL3', 'CRMDEAL5'],
'CRMLEAD' => ['CRMLEAD9', 'CRMLEAD11'],
'SG' => ['SG5', 'SG9'],
'U' => ['U1', 'U3'],
'DR' => ['DR1', 'DR7'],
],
'ENTITYTYPEID' => 3,
'ENTITYID' => 3,
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';Пример 2
- cURL (Webhook)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"POST_TITLE":"POST_TITLE","MESSAGE":"MESSAGE","SPERM":{"CRMLEAD":["CRMLEAD9","CRMLEAD11"],"U":["U1"]},"ENTITYTYPEID":1,"ENTITYID":56374,"FILES":[["1.gif","R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=="],["2.gif","..."]]}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/crm.livefeedmessage.add- cURL (OAuth)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"POST_TITLE":"POST_TITLE","MESSAGE":"MESSAGE","SPERM":{"CRMLEAD":["CRMLEAD9","CRMLEAD11"],"U":["U1"]},"ENTITYTYPEID":1,"ENTITYID":56374,"FILES":[["1.gif","R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=="],["2.gif","..."]]},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.livefeedmessage.add- JS
try
{
const response = await $b24.callMethod(
"crm.livefeedmessage.add",
{
fields:
{
"POST_TITLE": "POST_TITLE",
"MESSAGE": "MESSAGE",
"SPERM": {
"CRMLEAD": ["CRMLEAD9", "CRMLEAD11"],
"U": ["U1"],
},
"ENTITYTYPEID": 1,
"ENTITYID": 56374,
"FILES": [
["1.gif", "R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=="],
["2.gif", "..."]
],
}
}
);
const result = response.getData().result;
console.info("Создано сообщение с ID " + result);
}
catch(error)
{
console.error(error);
}- PHP
try {
$response = $b24Service
->core
->call(
'crm.livefeedmessage.add',
[
'fields' => [
'POST_TITLE' => 'POST_TITLE',
'MESSAGE' => 'MESSAGE',
'SPERM' => [
'CRMLEAD' => ['CRMLEAD9', 'CRMLEAD11'],
'U' => ['U1'],
],
'ENTITYTYPEID' => 1,
'ENTITYID' => 56374,
'FILES' => [
['1.gif', 'R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=='],
['2.gif', '...'],
],
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Создано сообщение с ID ' . $result;
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Ошибка при создании сообщения: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
"crm.livefeedmessage.add",
{
fields:
{
"POST_TITLE": "POST_TITLE",
"MESSAGE": "MESSAGE",
"SPERM": {
"CRMLEAD": ["CRMLEAD9", "CRMLEAD11"],
"U": ["U1"],
},
"ENTITYTYPEID": 1,
"ENTITYID": 56374,
"FILES": [
["1.gif", "R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=="],
["2.gif", "..."]
],
}
},
function(result)
{
if(result.error())
console.error(result.error());
else
console.info("Создано сообщение с ID " + result.data());
}
);- PHP CRest
require_once('crest.php');
$result = CRest::call(
'crm.livefeedmessage.add',
[
'fields' => [
'POST_TITLE' => 'POST_TITLE',
'MESSAGE' => 'MESSAGE',
'SPERM' => [
'CRMLEAD' => ['CRMLEAD9', 'CRMLEAD11'],
'U' => ['U1'],
],
'ENTITYTYPEID' => 1,
'ENTITYID' => 56374,
'FILES' => [
['1.gif', 'R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=='],
['2.gif', '...']
],
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';Дополнительно
crm.timeline.comment.add
💡 Экспертное мнение и рекомендации
Советы эксперта по интеграции:
- Всегда используйте кэширование при частых запросах к crm.livefeedmessage.add, чтобы разгрузить базу данных.
- Соблюдайте стандарты PSR при написании обработчиков для «Отправить сообщение в Ленту CRM crm.livefeedmessage.add».
- Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru