Отправка личного сообщения пользователю от мини-приложения

Метод для отправки пользователю личное сообщение от имени мини-приложения.

Метод требует наличие прав у мини-приложения - SendPrivateMessage. Подробнее по выдаче и настройки прав.

Перед отправкой личных сообщения от мини-приложения требуется вызвать на клиенте метод enablePrivateMessaging.

Для формирования подписи обратитесь к статье Проверка подписи.

Для отправки личного сообщения, с вложенным файлом обратитесь к статье по отправке файла.

Данный метод позволит Вам отправлять пользователю личное сообщение от имени мини-приложения. Личное сообщение может содержать в себе текст сообщения, изображения, непродолжительные видео, текстовые файлы (pdf, txt), а также inline команды*. * inline команды - часть сообщения, в виде небольших кнопок с зашитым внутри url, которые могут вести пользователя в конкретное место Вашего мини-приложения

POST https://api.miniapps.aitu.io/kz.btsd.messenger.apps.public.MiniAppsPublicService/SendPrivateMessage

Request Body

Name	Type	Description
app_id*	String	идентификатор вашего приложения, его можно получить из кабинета разработчика мини-приложения
user_id*	String	идентификатор пользователя, которому нужно отправить сообщение.
sign*	String	Подпись, формирование которой описано в статье Проверка подписи. API-Key можно получить из кабинета разработчика мини-приложения
message	String	текст сообщения Ограничения: текст до 4096 символов;
inline_commands	Object	Объект содержащий в себе список "кнопок" с заголовком и зашитым внутри параметром to_url* для перехода по нажатию. *to_url - путь ссылки на приложение после хоста Ограничение: Колличество кнопок до 3-х штук; Заголовок кнопки до 4096 символов;
media_list	List	Список с уникальными идентификаторами от файлов Ограничение: до 10 файлов

200: OK В случае успешного выполнения метода вы получите id сообщения

{
    "message_id": "ab28ed24-1a07-11ed-9f26-0242ac1d000d"
}

400: Bad Request некоторые возможные варианты

{
    "code":"malformed","msg":"too many media files, must equal or less 10"
}

{
    "code":"malformed","msg":"too long message, must equal or less than 4096"
}

403: Forbidden некоторые возможные варианты

{
    "code":"permission_denied","msg":"messaging disable for app: f58363ca-c427-11ed-aa20-acde48001122"
}

{
    "code":"permission_denied","msg":"messaging disable for app: d473b2ac-c427-11ed-8999-acde48001122"
}

404: Not Found некоторые возможные варианты

{
    "code":"not_found","msg":"mini app not found"
}

Пример тела запроса

{
   "app_id":"ab28ed24-1a07-11ed-9f26-0242ac1d000d",
   "user_id":"ab28ed24-1a07-11ed-9f26-0242ac1d000d",
   "sign":"4h6xYJSI3MX9-KaTbj0wcoc_Yy5j1fuiVhsGr0KDU88=",
   "message":"Привет, это новое приложение пишет тебе в личку",
   "inline_commands":{
      "commands":[
         {
            "redirect":{
               "text":"Принять",
               "to_url":"/example/1"
            }
         },
         {
            "redirect":{
               "text":"Отклонить",
               "to_url":"/example/2"
            }
         }
      ]
   },
   "media_list":[
      {
         "file_id":"ab28ed24-1a07-11ed-9f26-0242ac1d000d"
      }
   ]
}