Use this method when you need to tell the user that something is happening on the bot's side.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…

Use this method when you need to tell the user that something is happening on the bot's side. The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status).

Example: The ImageBot needs some time to process a request and upload the image. Instead of sending a text message along the lines of “Retrieving image, please wait…”, the bot may use sendChatAction with action = upload_photo. The user will see a “sending photo” status for the bot.

Telegram only recommends using this method when a response from the bot will take a noticeable amount of time to arrive.

See sendChatAction official docs for a list of supported actions and other info.

Actions Helper

The SDK also has a helper method for supplying the chat action. This is especially useful with code completion with your IDE.

Example

use Telegram\Bot\Api; use Telegram\Bot\Actions; $telegram = new Api('BOT TOKEN'); $telegram->sendChatAction([ 'chat_id' => 'CHAT_ID', 'action' => Actions::RECORD_VIDEO ]);
use Telegram\Bot\Actions; Telegram::sendChatAction([ 'chat_id' => 'CHAT_ID', 'action' => Actions::RECORD_VIDEO ]);
Path Params
string
required

Your Bot Token

Body Params
string

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

string
Defaults to Required

Type of action to broadcast. Choose one, depending on what the user is about to receive: typing for text messages, upload_photo for photos, record_video or upload_video for videos, record_audio or upload_audio for audio files, upload_document for general files, find_location for location data.

Responses

Language
Request
Click Try It! to start a request and see the response here! Or choose an example:
application/json