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

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

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

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

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

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

Данный метод позволит Вам отправлять пользователю личное сообщение от имени мини-приложения. Личное сообщение может содержать в себе текст сообщения, изображения, непродолжительные видео, текстовые файлы (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

message

String

текст сообщения

Ограничения:

текст до 4096 символов;

inline_commands

Object

Объект содержащий в себе список "кнопок" с заголовком и зашитым внутри параметром to_url* для перехода по нажатию.

*to_url - путь ссылки на приложение после хоста

Ограничение:

Колличество кнопок до 3-х штук;

Заголовок кнопки до 4096 символов;

media_list

List

Ограничение:

до 10 файлов

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

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

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

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

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

PreviousОтправка Push-уведомлений всем пользователям NextОтправка файла для формирования личного сообщения от мини-приложения

Last updated 2 years ago

Was this helpful?

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