﻿---
sidebar_position: 2
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Изменить сообщение
 Изменяет сообщение в диалоге



`Функция ИзменитьСообщение(Знач URL, Знач IDСообщения, Знач Текст = "", Знач Вложения = "", Знач Токен = "") Экспорт`

  | Параметр | CLI опция | Тип | Обяз. | Назначение |
  |-|-|-|-|-|
  | URL | --url | Строка | &#x2714; | URL внешнего вебхука или адрес Bitrix24 при использовании токена |
  | IDСообщения | --message | Строка, Число | &#x2714; | ID сообщения для изменения |
  | Текст | --text | Строка | &#x2716; | Новый текст сообщения |
  | Вложения | --blocks | Массив из Структура | &#x2716; | Новый массив блоков вложений |
  | Токен | --token | Строка | &#x2716; | Токен авторизации, если используется не вебхук |

  
  Возвращаемое значение:   Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrxi24

<br/>

:::tip
Метод в документации API: [im.message.update](https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=93&LESSON_ID=12117)
:::
<br/>


```bsl title="Пример использования для 1С:Предприятие/OneScript"
    URL         = "https://b24-ar17wx.bitrix24.by/rest/1/ps5...";
    IDСообщения = "28850";

    Текст = "Новый текст сообщения";

    Результат = OPI_Bitrix24.ИзменитьСообщение(URL, IDСообщения, Текст);

    URL         = "b24-ar17wx.bitrix24.by";
    Токен       = "a8e65667006e9f06006b12e400000001000...";
    IDСообщения = "28852";

    Картинка = "https://raw.githubusercontent.com/Bayselonarrend/OpenIntegrations/main/service/test_data/picture.jpg";
    Файл     = "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/document.docx";

    Вложения = Новый Массив;
    Вложения.Добавить(OPI_Bitrix24.ПолучитьБлокКартинки("Картинка1", Картинка));
    Вложения.Добавить(OPI_Bitrix24.ПолучитьБлокФайла("Файл1.docx"  , Файл));

    Результат = OPI_Bitrix24.ИзменитьСообщение(URL, IDСообщения, Текст, Вложения, Токен);
```
    

 <Tabs>
  
    <TabItem value="bash" label="Bash" default>
        ```bash
            oint bitrix24 ИзменитьСообщение \
              --url "b24-ar17wx.bitrix24.by" \
              --message 29788 \
              --text "Новый текст сообщения" \
              --blocks "[{'IMAGE':{'NAME':'Картинка1','LINK':'https://raw.githubusercontent.com/Bayselonarrend/OpenIntegrations/main/service/test_data/picture.jpg'}},{'FILE':{'NAME':'Файл1.docx','LINK':'https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/document.docx'}}]" \
              --token "***"
        ```
    </TabItem>
  
    <TabItem value="bat" label="CMD/Bat" default>
        ```batch
            oint bitrix24 ИзменитьСообщение ^
              --url "b24-ar17wx.bitrix24.by" ^
              --message 29788 ^
              --text "Новый текст сообщения" ^
              --blocks "[{'IMAGE':{'NAME':'Картинка1','LINK':'https://raw.githubusercontent.com/Bayselonarrend/OpenIntegrations/main/service/test_data/picture.jpg'}},{'FILE':{'NAME':'Файл1.docx','LINK':'https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/document.docx'}}]" ^
              --token "***"
        ```
    </TabItem>
</Tabs>


```json title="Результат"
{
 "result": true,
 "time": {
  "start": 1728409847.24148,
  "finish": 1728409847.29817,
  "duration": 0.0566887855529785,
  "processing": 0.0310389995574951,
  "date_start": "2024-10-08T20:50:47+03:00",
  "date_finish": "2024-10-08T20:50:47+03:00",
  "operating_reset_at": 1728410447,
  "operating": 0
 }
}
```
