Отправка сообщений

Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на домен platform-api2.max.ru вместо platform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных

POST/messages

Отправляет сообщение в диалог, групповой чат или канал

Кроме текста сообщения или посты могут содержать следующие типы вложений:

• image — изображение (JPG, JPEG, PNG, GIF, TIFF, BMP, HEIC)

• video — видео (MP4, MOV, MKV, WEBM, MATROSKA)

• audio — аудио (MP3, WAV, M4A и другие)

• file — файл для загрузки в (TXT, DOC и другие)

• sticker — стикер

• contact — контакт (данные контакта из телефонного справочника)

• inline_keyboard — сообщение или пост с кнопкой

• share — контент, прикрепленный по внешнему URL

• location — локация

Ограничения

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

Пример запроса с одной кнопкой-ссылкой

Больше примеров запросов с кнопками — в разделе «Клавиатура»

curl -X POST "https://platform-api2.max.ru/messages?user_id={user_id}" \
  -H "Authorization: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "Это сообщение с кнопкой-ссылкой",
  "attachments": [
    {
      "type": "inline_keyboard",
      "payload": {
        "buttons": [
          [
            {
              "type": "link",
              "text": "Откройте сайт",
              "url": "https://example.com"
            }
          ]
        ]
      }
    }
  ]
 }'

Авторизация

Параметры

Тело запроса

Результат

Коды ответов