Сервис в разработкеBot API и документация будут дорабатываться: список методов, лимиты и поведение могут измениться.

Ephemeral-сообщения

Сообщения, видимые одному человеку

Ephemeral-сообщение в группе видит только один получатель, с пометкой "видно только вам".

Отправка

Добавьте к обычному методу receiver_user_id (или callback_query_id - тогда получатель берётся из нажатия кнопки):

Shell

curl "https://bot.catup.lol/bot$TOKEN/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": -100123, "receiver_user_id": 123456789, "text": "Это видите только вы"}'

Так работают sendMessage, все медиа-методы, а sendContact, sendLocation, sendVenue - только в таком режиме.

Правила

ответ на ephemeral-сообщение - через reply_parameters.ephemeral_message_id;
message_thread_id - верхнее сообщение ephemeral-треда;
допустима только inline-клавиатура;
на действие после вызова команды есть 15 секунд, потом EPHEMERAL_ACTION_EXPIRED.

Правка и удаление

editEphemeralMessageText, editEphemeralMessageCaption, editEphemeralMessageMedia, editEphemeralMessageReplyMarkup, deleteEphemeralMessage.