sendSharedWidget
Reenvia um widget compartilhado criado pelo bot (Bot API 10.4).
Retorno: Em caso de sucesso, retorna Message.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
chat_id | Integer or String | Sim | Chat ID ou @username |
message_thread_id | Integer | Opcional | ID do tópico do fórum |
widget_id | String | Sim | ID do widget compartilhado (widget.id da mensagem enviada) |
chat_data | String | Opcional | Estado do widget neste chat (chat_data), 0-1024 bytes |
caption | String | Opcional | Legenda (0-1024) |
parse_mode | String | Opcional | HTML, Markdown, MarkdownV2 |
caption_entities | Array of MessageEntity | Opcional | Array JSON de MessageEntity para a legenda |
show_caption_above_media | Boolean | Opcional | Mostrar legenda acima do widget |
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 |
reply_parameters | ReplyParameters | Opcional | Objeto JSON ReplyParameters |
reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | Opcional | Objeto JSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply |
Exemplo de requisição
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendSharedWidget" \
-H "Content-Type: application/json" \
-d '{"chat_id":123456789,"widget_id":"WIDGET_ID"}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendSharedWidget",
json={
"chat_id": 123456789,
"widget_id": "WIDGET_ID"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendSharedWidget`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"widget_id": "WIDGET_ID"
}),
});
console.log(await res.json());
Guia passo a passo: Exemplos de widget do Telegram: HTML completo e bot em Python
Métodos relacionados
sendWidgetEnvia uma mensagem com um widget HTML (Bot API 10.4).answerWidgetQueryResponde a uma consulta de um widget (Bot API 10.4).editMessageWidgetDataEdita os dados de um widget em uma mensagem (Bot API 10.4).editSharedWidgetDataEdita os dados públicos de um widget compartilhado (Bot API 10.4).