Telegram Bot API

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

  1. Pega el token del bot. Marca Servidor de pruebas si el bot está en el entorno de pruebas.
  2. 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.
  3. Revisa el contador de actualizaciones pendientes. Más de 100 se resalta: las actualizaciones se acumulan porque tu servidor no las acepta.
  4. Debajo ves la respuesta completa de getWebhookInfo: url, has_custom_certificate, pending_update_count, last_error_date, last_error_message, max_connections y otros campos.
  5. Para cambiarlo, abre Configurar o cambiar el webhook: ingresa una URL HTTPS y un secret_token opcional, 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 aQué revisar
SSL / certificadoUn 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/5xxLa ruta, tu comprobación de secret_token y los errores del servidor: Telegram espera 2xx.
Timeout / connection resetEl servidor debe ser accesible desde internet en el puerto 443, 80, 88 u 8443 y responder rápido.
Connection refusedNada escucha en el puerto, o un firewall bloquea a Telegram.
Host can't be resolvedLos 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