sendSticker

Categoria: Mídia · Bot API 10.3 · Documentação oficial

Envia um sticker.

Retorno: Em caso de sucesso, retorna Message.

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`business_connection_id`	`String`	Opcional	ID da conexão comercial
`chat_id`	`Integer or String`	Sim	Chat ID ou @username
`message_thread_id`	`Integer`	Opcional	ID do tópico do fórum
`direct_messages_topic_id`	`Integer`	Opcional	ID do tópico de mensagens diretas (Bot API 10.0)
`ephemeral_message_parameters`	`EphemeralMessageParameters`	Opcional	Objeto JSON EphemeralMessageParameters — mensagem efêmera visível para um único usuário (Bot API 10.3)
`sticker`	`InputFile or String`	Sim	file_id ou URL do sticker
`emoji`	`String`	Opcional	Emoji do sticker
`disable_notification`	`Boolean`	Opcional	Enviar sem som
`protect_content`	`Boolean`	Opcional	Proteger conteúdo
`allow_paid_broadcast`	`Boolean`	Opcional	Permitir transmissão paga
`message_effect_id`	`String`	Opcional	ID do efeito da mensagem
`suggested_post_parameters`	`SuggestedPostParameters`	Opcional	Objeto JSON SuggestedPostParameters
`reply_parameters`	`ReplyParameters`	Opcional	Objeto JSON ReplyParameters
`reply_markup`	`InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply`	Opcional	Objeto JSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply

As descrições dos parâmetros são resumos concisos; consulte a documentação oficial para ver o texto completo.

Exemplo de requisição

curl

curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendSticker" \
  -H "Content-Type: application/json" \
  -d '{"chat_id":123456789,"sticker":"FILE_ID"}'

Python

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/sendSticker",
    json={
        "chat_id": 123456789,
        "sticker": "FILE_ID"
    },
    timeout=30,
)
print(resp.json())

JavaScript

const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendSticker`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "chat_id": 123456789,
    "sticker": "FILE_ID"
  }),
});
console.log(await res.json());

Guia passo a passo: Como criar um bot no Telegram grátis: do BotFather à primeira mensagem

sendPhotoEnvia uma foto.
sendVideoEnvia um vídeo.
sendDocumentEnvia um documento.
sendAudioEnvia um áudio.
sendAnimationEnvia uma animação (GIF).
sendVoiceEnvia uma mensagem de voz.
sendVideoNoteEnvia uma mensagem de vídeo (vídeo circular).
sendMediaGroupEnvia um grupo de mídias (álbum).
sendPaidMediaEnvia mídia paga (Bot API 8.0+).
sendDiceEnvia um dado.
sendLivePhotoEnvia uma live photo (foto + vídeo, Bot API 10.0).