Edit sent messages

ctx.reply() returns a ReplyHandle so that you can edit the message you just sent on the provider. This is useful when you post "Processing..." and replace it with the final text.

That is not a reply type; it updates a message you already sent.

Basic edit

The following example sends a placeholder message, does work, then updates the same message in place:

const sentMessage = await ctx.reply('Processing...');
// ... do some work ...
await sentMessage.edit('Done! Here are your results.');

Edit with attachments

You can attach files when editing plain text or markdown content. The next example attaches a file when updating the message text:

await sentMessage.edit('Updated report attached.', {
 files: [{ filename: 'report.pdf', url: 'https://example.com/report.pdf' }],
});

Edits update the existing platform message rather than posting a new one. Not every provider supports message editing. For which capabilities each provider supports, see Agents and providers.

Related