Chat Actions

Clients can show actions such as typing or uploading while preparing a response.

Showing an Action

sendChatAction indicates that work has started.

client.command("status", async (ctx) => {
  await ctx.sendChatAction({ type: "typing" });

  const status = await getStatus();
  await ctx.reply(status);
});

Chat actions remain visible for a short time. Send the action again if the work takes longer.

Reporting Upload Progress

Upload actions can include a progress percentage.

await client.sendChatAction(chatId, {
  type: "uploadingDocument",
  progress: 50,
});

See ChatActionType for all available actions.

Cancelling an Action

The cancel action indicates that no response will follow.

await client.sendChatAction(chatId, { type: "cancel" });