sendWidget
Envía un mensaje con un widget HTML (Bot API 10.4).
Devuelve: Si la llamada tiene éxito, devuelve Message.
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
chat_id | Integer or String | Sí | ID del chat o @username |
message_thread_id | Integer | Opcional | ID del tema del foro |
html | String | Sí | Código HTML del widget: 1-32768 bytes, máximo 4096 bytes tras la compresión zlib |
width | Integer | Opcional | Ancho del widget en píxeles lógicos (omitir para ocupar todo el ancho del mensaje) |
height | Integer | Opcional | Alto del widget en píxeles lógicos, 50-600 (omitir para ajustarse al contenido) |
public_data | String | Opcional | Estado público del widget (public_data), 0-1024 bytes — visible dondequiera que se muestre el widget |
chat_data | String | Opcional | Estado del widget en este chat (chat_data), 0-1024 bytes |
caption | String | Opcional | Leyenda (0-1024) |
parse_mode | String | Opcional | HTML, Markdown o MarkdownV2 |
caption_entities | Array of MessageEntity | Opcional | Array JSON de MessageEntity para la leyenda |
show_caption_above_media | Boolean | Opcional | Mostrar la leyenda encima del widget |
allow_queries | Boolean | Opcional | Permitir que el widget envíe consultas al bot (widget_query) |
is_shared | Boolean | Opcional | Crear un widget compartido — se puede volver a enviar con sendSharedWidget |
disable_notification | Boolean | Opcional | Enviar sin sonido |
protect_content | Boolean | Opcional | Proteger el contenido |
allow_paid_broadcast | Boolean | Opcional | Permitir difusión de pago |
message_effect_id | String | Opcional | ID del efecto del mensaje |
reply_parameters | ReplyParameters | Opcional | Objeto JSON ReplyParameters |
reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | Opcional | Objeto JSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply |
Ejemplo de solicitud
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendWidget" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendWidget",
json={
"chat_id": 123456789,
"html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendWidget`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
}),
});
console.log(await res.json());
Guía paso a paso: Widgets de Telegram: HTML interactivo dentro de los mensajes de tu bot
Métodos relacionados
sendSharedWidgetVuelve a enviar un widget compartido creado por el bot (Bot API 10.4).answerWidgetQueryResponde a una consulta de un widget (Bot API 10.4).editMessageWidgetDataEdita los datos de un widget en un mensaje (Bot API 10.4).editSharedWidgetDataEdita los datos públicos de un widget compartido (Bot API 10.4).