Verificador de webhook para bots de Telegram
Verifica el webhook de tu bot de Telegram con un clic: la herramienta llama a getWebhookInfo, muestra la URL, las actualizaciones pendientes y el último error de entrega con una pista para corregirlo, y te permite configurar o eliminar el webhook.
El token se queda en tu navegador (localStorage) y solo se envía a api.telegram.org.
Configurar o cambiar el webhook
Cómo verificar el webhook de un bot de Telegram
- Pega el token del bot. Marca Servidor de pruebas si el bot está en el entorno de pruebas.
- Pulsa Verificar webhook. Obtienes uno de tres resultados: sin webhook (el bot usa
getUpdates), un webhook sin errores en las últimas 24 horas, o un problema de entrega con la hora y el texto del último error más una pista. - Revisa el contador de actualizaciones pendientes. Más de 100 se resalta: las actualizaciones se acumulan porque tu servidor no las acepta.
- Debajo ves la respuesta completa de
getWebhookInfo:url,has_custom_certificate,pending_update_count,last_error_date,last_error_message,max_connectionsy otros campos. - Para cambiarlo, abre Configurar o cambiar el webhook: ingresa una URL HTTPS y un
secret_tokenopcional, elige si quieres descartar las actualizaciones pendientes y pulsa setWebhook o deleteWebhook. La verificación se repite automáticamente.
Errores comunes de webhook
La pista se elige según el texto de last_error_message:
| El error se parece a | Qué revisar |
|---|---|
| SSL / certificado | Un certificado válido para el dominio (o uno autofirmado subido con el parámetro certificate de setWebhook), TLS 1.2+. |
| Wrong response from the webhook: 4xx/5xx | La ruta, tu comprobación de secret_token y los errores del servidor: Telegram espera 2xx. |
| Timeout / connection reset | El servidor debe ser accesible desde internet en el puerto 443, 80, 88 u 8443 y responder rápido. |
| Connection refused | Nada escucha en el puerto, o un firewall bloquea a Telegram. |
| Host can't be resolved | Los registros DNS del dominio del webhook. |
El formulario envía solo url, secret_token y drop_pending_updates. El secreto (1–256 caracteres A-Z a-z 0-9 _ -) llega en el encabezado X-Telegram-Bot-Api-Secret-Token de cada solicitud. Para allowed_updates, max_connections o un certificado, usa /es/telegram-bot-api-tester.html#setWebhook.
Privacidad
El token se queda en el localStorage de tu navegador, y getWebhookInfo, setWebhook y deleteWebhook se envían directamente a api.telegram.org; nada pasa por nuestro servidor. La misma llamada está disponible en /es/telegram-bot-api-tester.html#getWebhookInfo. Una guía completa de configuración está en /es/guides/telegram-bot-webhook.html, y el error 409 Conflict y otros se explican en /es/guides/telegram-bot-api-errors.html.
Preguntas frecuentes
¿Cómo sé si mi bot de Telegram tiene un webhook?
Llama a getWebhookInfo. Si url está vacía, no hay webhook configurado y el bot funciona con getUpdates. El verificador de arriba hace la llamada por ti y explica el resultado.
¿Cómo elimino el webhook de un bot de Telegram?
Llama a deleteWebhook: en la herramienta abre Configurar o cambiar el webhook y pulsa deleteWebhook. Marca Descartar actualizaciones pendientes solo si quieres descartar las actualizaciones en cola. Después, getUpdates vuelve a funcionar.
¿Por qué crece pending_update_count?
Telegram no puede entregar las actualizaciones: tu servidor no es accesible, es lento o responde con un estado que no es 2xx. Mira last_error_message; Telegram sigue reintentando y las actualizaciones se guardan hasta 24 horas.
¿Qué significa "Wrong response from the webhook"?
Tu servidor respondió con un estado HTTP distinto de 2xx, por ejemplo 404 por una ruta incorrecta o 500 por un fallo. Telegram espera una respuesta 2xx rápida y, si no, reintenta.
Otras utilidades
Buscador de chat IDEscapador de MarkdownV2 y HTMLValidador de initData de Mini AppBot API Tester