editSharedWidgetData
Edita os dados públicos de um widget compartilhado (Bot API 10.4).
Retorno: Em caso de sucesso, retorna True.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
widget_id | String | Sim | ID do widget compartilhado (widget.id da mensagem enviada) |
public_data | String | Sim | Novo estado público, 0-1024 bytes (string vazia = apagar) |
cache_time | Integer | Opcional | Período de atualização no cliente, em segundos, 5-3600 (padrão 30) |
Exemplo de requisição
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/editSharedWidgetData" \
-H "Content-Type: application/json" \
-d '{"widget_id":"WIDGET_ID","public_data":"{\"r\":1,\"votes\":[3,5]}"}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/editSharedWidgetData",
json={
"widget_id": "WIDGET_ID",
"public_data": "{\"r\":1,\"votes\":[3,5]}"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/editSharedWidgetData`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"widget_id": "WIDGET_ID",
"public_data": "{\"r\":1,\"votes\":[3,5]}"
}),
});
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).sendSharedWidgetReenvia um widget compartilhado criado pelo bot (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).