Skip to main content

Send message

Send message to dialog

Function SendMessage(Val URL, Val ChatID, Val Text, Val Attachments = "", Val Token = "") Export

ParameterCLI optionTypeDescription
URL--urlStringURL of webhook or a Bitrix24 domain, when token used
ChatID--chatString, NumberChat ID (as chatXXX) or User ID (as XXX)
Text--textStringMessage text
Attachments--blocksArray of StructureArray of attachments
Token--tokenStringAccess token, when app auth method used

Returns: Map Of KeyAndValue - serialized JSON of answer from Bitrix24 API


tip

Method at API documentation: im.message.add


Code example
    URL    = "https://b24-ar17wx.bitrix24.by/rest/1/1o2...";
ChatID = "chat" + "642";
Text = "Message text";
Image = "https://raw.githubusercontent.com/Bayselonarrend/OpenIntegrations/main/service/test_data/picture.jpg";
File = "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/document.docx";

Attachments = New Array;
Attachments.Add(OPI_Bitrix24.GetPictureBlock("Image1" , Image));
Attachments.Add(OPI_Bitrix24.GetFileBlock("File1.docx" , File));

Result = OPI_Bitrix24.SendMessage(URL, ChatID, Text, Attachments);

URL = "b24-ar17wx.bitrix24.by";
Token = "b529cb66006e9f06006b12e400000001000...";
UserID = 10;

Result = OPI_Bitrix24.SendMessage(URL, UserID, Text, , Token);
CLI command example
    
oint bitrix24 SendMessage --url "b24-ar17wx.bitrix24.by" --chat "chat + 450" --text "Message text" --blocks %blocks% --token "fe3fa966006e9f06006b12e400000001000..."

Result
{
"result": 5342,
"time": {
"start": 1720969163.89343,
"finish": 1720969163.95538,
"duration": 0.061945915222168,
"processing": 0.0366020202636719,
"date_start": "2024-07-14T14:59:23+00:00",
"date_finish": "2024-07-14T14:59:23+00:00",
"operating_reset_at": 1720969763,
"operating": 0
}
}