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

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

POST /v1/bot/messages доступен только для chat_id, к которому подключён этот бот. content поддерживает текст, Markdown, media, menu и keyboard.

curl -X POST https://chat.wokey.pro/_keychat/v1/bot/messages \
  -H "Authorization: Bearer $KEYCHAT_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"chat_id":"<uuid>","content":{"text":"Готово"},"idempotency_key":"job-42"}'

Идемпотентность

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

Обновить сообщение

replace_event_id заменяет ранее отправленное этим ботом сообщение. Так можно заменить «Формирую ответ…» результатом и одновременно обновить кнопки.

Бот отвечает

На время вычислений интерфейс может показывать стандартную анимацию «…». Ошибки и служебные состояния отображайте системными сообщениями.

Практика с SDK

Используйте Markdown только для доверенного или экранированного текста. Для повторяемой отправки всегда сохраняйте тот же idempotency_key до получения окончательного результата.

Редактировать можно только сообщения этого бота. replace_event_id сохраняет место сообщения в истории, а reply_to_event_id создаёт обычный ответ.

await bot.sendMessage({
  chat_id: chatId,
  content: { text: '**Ready**', format: 'markdown' },
  idempotency_key: crypto.randomUUID()
});