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

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

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

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

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

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

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

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

Request Body

NameTypeDescription

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 файлов

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

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

{
   "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"
      }
   ]
}

Last updated

#407:

Change request updated