InstaTunnel
Abrir menu de navegacion
Tutorial
15 min read
30 views

Bots de Telegram y Mini Apps en localhost: `setWebhook`, la cabecera Secret-Token y la nueva verificación de origen

Ejecute bots de Telegram y Mini Apps en localhost: configure `setWebhook`, verifique la cabecera secret-token y pase Bot API 10.2 la verificación de origen. Consejos para túneles estables.

IT
InstaTunnel Team
Published by the InstaTunnel team | Editorial policy
Bots de Telegram y Mini Apps en localhost: `setWebhook`, la cabecera Secret-Token y la nueva verificación de origen

Quick answer

Bots de Telegram y Mini Apps en localhost: Guía de Webhook 2026: webhook testing answer

For local webhook testing, run your app locally, expose it with a public HTTPS tunnel, and paste the stable callback URL into the provider dashboard.

How do I test webhooks on localhost?

Start your local server, open a public HTTPS tunnel to that port, configure the provider webhook URL, and inspect events in your local logs.

Why does a stable webhook URL matter?

Stable URLs prevent provider dashboards from needing manual callback updates every time you restart a tunnel.

Telegram solo puede entregar actualizaciones a una dirección HTTPS pública, y localhost no lo es. Desde el 20 de julio de 2026, las Mini Apps tienen una segunda restricción. Telegram ahora bloquea los métodos de Mini App cuando se llaman desde un origen distinto al dominio propio de la Mini App. En conjunto, estos dos hechos hacen de la URL de tu túnel una pieza clave de la configuración, no un detalle de pasada.

Esta guía cubre el desarrollo de un bot de Telegram y una Mini App para una máquina local:

  • registrar el webhook con setWebhook
  • autenticar solicitudes con la cabecera secret-token
  • manejar campos de actualización desconocidos sin disparar reintentos
  • validar initData de la Mini App
  • comprender qué hace la nueva verificación de origen para un entorno de desarrollo

Qué cambió en Bot API 10.2 (y qué se ha implementado desde entonces)

Telegram lanzó Bot API 10.2 el 14 de julio de 2026. Según el registro oficial de cambios, esa versión también endureció la seguridad de la Mini App al deshabilitar métodos de Mini App desde orígenes diferentes al dominio original de la Mini App. La protección se habilitó automáticamente para todas las Mini Apps el 20 de julio de 2026. Los Bots pueden optar por desactivarla a través de la Mini App BotFather. Desactivarlo significa asumir la responsabilidad de asegurar que la Mini App no tenga enlaces a sitios no confiables. El canal BotNews de Telegram anunció el cambio como una advertencia: los sitios externos abiertos desde enlaces dentro de una Mini App ya no pueden usar por defecto los métodos de la Mini App.

Otras adiciones de 10.2 vale la pena conocerlas, porque aparecen en tus payloads de webhook:

  • Mensajes efímeros: nuevos métodos de editar y eliminar, además de receiver_user y ephemeral_message_id en Message.
  • Mensajes enriquecidos: InputRichMessage obtuvo campos blocks y media.
  • Comunidades: un nuevo tipo Community, mensajes de servicio community_chat_added y community_chat_removed, y un campo community en ChatFullInfo.
  • Suscripciones: un nuevo campo superior subscription en Update, que transporta un objeto BotSubscriptionUpdated.

La Bot API ha seguido evolucionando desde entonces:

  • Bot API 10.3 (24 de agosto de 2026):
    • botones dentro de mensajes enriquecidos
    • botones en línea desactivados
    • los parámetros de ephemeral-message se consolidan en un único objeto ephemeral_message_parameters
    • un botón Stop nativo para borradores en flujo
    • un nuevo campo stopped_message_generation en Update
  • Bot API 10.4 (9 de noviembre de 2026):
    • widgets HTML, a través de sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData y editSharedWidgetData
    • tarjetas de billetera TON y mensajes de servicio de transferencia
    • respuestas efímeras desencadenadas por pulsaciones de botones
    • según las notas de versión de la biblioteca, nuevos tipos de actualización widget_query y shared_widget_query

Ninguno de los anuncios de 10.2–10.4 cambia cómo funciona setWebhook o la cabecera secret-token. El objeto Update sigue ganando campos de nivel superior, por lo que el Paso 3 es relevante.

Por qué localhost no funciona para los webhooks de Telegram

Un webhook es un POST HTTPS saliente desde los servidores de Telegram hacia tu URL. Telegram no puede alcanzar http://localhost:3000, por lo que necesitas un punto final HTTPS público que envíe el tráfico a tu máquina. Las exigencias documentadas de Telegram:

  • La URL debe ser HTTPS.
  • Los puertos compatibles para webhooks son 443, 80, 88 y 8443.
  • Mientras un webhook esté configurado, no puedes recibir actualizaciones mediante getUpdates.
  • Un certificado autofirmado requiere cargar el certificado público a través del parámetro certificate, lo cual rara vez vale la pena en desarrollo.
  • Según el resumen de Hookdeck sobre la guía de webhooks de Telegram, la entrega es IPv4-solo y necesita TLS 1.2 o posterior.
  • Las actualizaciones no entregadas no se almacenan por más de 24 horas.

Un túnel satisface todo esto a la vez. Te proporciona un nombre de host público con un certificado válido en el puerto 443 y reenvía el tráfico a un puerto local como 3000.

Solo hay una excepción para el lado del bot. Si ejecutas el servidor de código abierto telegram-bot-api localmente, Telegram documenta que tu bot puede usar una URL de webhook HTTP, cualquier dirección IP local y cualquier puerto. Eso elimina el túnel para la entrega del webhook. No hace que una Mini App sea alcanzable desde un teléfono, porque el cliente de Telegram aún tiene que cargar la URL de la Mini App.

Cada bot tiene exactamente una URL de webhook. Llamar a setWebhook de nuevo la reemplaza. Usa un bot de desarrollo separado, creado a través de BotFather, para que tus experimentos nunca desvíen el tráfico de producción.

Paso 1: Registrar el webhook con setWebhook

Inicia tu servidor local, inicia tu túnel, y luego registra la URL pública:

curl -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-subdomain.example.com/telegram/webhook",
    "secret_token": "'"$TELEGRAM_WEBHOOK_SECRET"'",
    "allowed_updates": ["message", "callback_query"],
    "drop_pending_updates": true
  }'

Los parámetros que realmente usarás:

Parámetro Qué hace
url URL HTTPS que recibe un Update JSON-serializado por POST. Una cadena vacía elimina el webhook.
secret_token Token secreto devuelto en la cabecera en cada solicitud. 1–256 caracteres.
allowed_updates Tipos de actualizaciones a recibir. Una lista vacía significa todos los tipos excepto chat_member, message_reaction y message_reaction_count. Si se omite, se mantiene la configuración anterior.
max_connections Conexiones HTTPS simultáneas para la entrega, 1–100, por defecto 40.
drop_pending_updates Descarta el backlog, útil cuando mueves un bot a una URL nueva.
ip_address IP fija para usar en lugar de resolver DNS.
certificate Certificado público (cargado como archivo) para configuraciones autofirmadas.

Dos hábitos que ahorran tiempo en desarrollo:

  • Establece drop_pending_updates cuando cambies URL, para que tu servidor local no se vea inundado de mensajes obsoletos.
  • Llama a getWebhookInfo cada vez que las entregas se detengan.

Un cambio de allowed_updates no se aplica a actualizaciones creadas antes de la llamada, por lo que algunas actualizaciones no deseadas pueden seguir llegando.

curl "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/getWebhookInfo"

Para volver a usar polling, ejecuta deleteWebhook.

Paso 2: Verificar la cabecera secret-token

Si proporcionas secret_token a setWebhook, Telegram lo incluye en cada solicitud de webhook en la cabecera X-Telegram-Bot-Api-Secret-Token. El token debe tener entre 1 y 256 caracteres, usando sólo A-Z, a-z, 0-9, _ y -.

Esto importa porque tu URL de túnel es pública. Sin un secreto, cualquiera que descubra la URL puede enviar actualizaciones falsificadas, y nada en la solicitud identifica a Telegram. Si no configuras ningún token, Telegram no envía ninguna cabecera.

El mecanismo es un secreto compartido, no una firma. Nada se calcula sobre el cuerpo, así que un secreto filtrado permite a un atacante forjar solicitudes hasta que lo rotates. Rotarlo es simple: llama de nuevo a setWebhook con un nuevo valor. La guía de Hookdeck también enumera los rangos de origen publicados por Telegram (149.154.160.0/20 y 91.108.4.0/22) como una segunda capa opcional, y señala que pueden cambiar.

Un manejador Express mínimo:

import express from "express";
import crypto from "node:crypto";

const SECRET = process.env.TELEGRAM_WEBHOOK_SECRET;
if (!SECRET) throw new Error("TELEGRAM_WEBHOOK_SECRET is not set");

const app = express();
app.use(express.json());

function secretMatches(received) {
  const a = Buffer.from(received ?? "");
  const b = Buffer.from(SECRET);
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

app.post("/telegram/webhook", (req, res) => {
  if (!secretMatches(req.get("x-telegram-bot-api-secret-token"))) {
    return res.sendStatus(401);
  }
  res.sendStatus(200); // acknowledge, then process
  handleUpdate(req.body).catch(console.error);
});

app.listen(3000);

Tres detalles valen la pena copiar:

  • La comparación es en tiempo constante.
  • La verificación se ejecuta antes de que cualquier lógica toque el cuerpo.
  • El manejador falla en modo cerrado si no se configura el secreto.

Telegram no publica un timeout de respuesta, así que no permita que la entrega dependa de trabajos lentos. Persist o haz cola del update primero, devuelve 200, luego procesa. Si devuelves 200 y luego fallas, el update se pierde, así que guárdalo antes de confirmar.

Paso 3: Tolerar campos desconocidos para que Telegram no reintente

Telegram trata cualquier respuesta distinta de 2xx como una entrega fallida. Repite la solicitud y se rinde tras lo que llama un “número razonable de intentos”, sin publicar un horario. Eso tiene una consecuencia aguda para parsers estrictos. Si tu manejador rechaza una actualización porque contiene un campo que no reconoces, Telegram seguirá reenviándola, y tus logs se llenarán de las mismas fallas.

Un Update contiene update_id más como mucho un otro campo, y el conjunto de esos campos sigue creciendo: managed_bot, guest_message, subscription, stopped_message_generation y, en 10.4, widget consultas. Un decodificador que falla con claves no esperadas puede empezar a devolver errores aunque no haya nada malo con tu bot. Reglas prácticas:

  • Analiza los campos que conoces e ignora el resto. En TypeScript con Zod, evita .strict() en los esquemas de webhook. En Go, evita DisallowUnknownFields en el decodificador. En Rust con serde, no añadas deny_unknown_fields a los tipos de Telegram.
  • Devuelve 200 para actualizaciones que no manejas. Una actualización no soportada no es un error.
  • Registra log de tipos de actualización desconocidos a un nivel bajo, para que notes nuevas características sin romper la entrega.
  • Deduplica por update_id. Telegram lo documenta como la forma de ignorar actualizaciones repetidas y devolver el orden. Después de una semana sin actualizaciones, el siguiente ID se elige al azar en lugar de secuencial, así que no cuentes en que sea consecutivo.
  • Ajusta tu biblioteca de Telegram y lee sus notas de versión antes de actualizar. Las bibliotecas difieren en cuán rápido cubren nuevas versiones de Bot API, y algunas eliminan silenciosamente los tipos de actualizaciones que no conocen. async function handleUpdate(update) { if (update.message) return onMessage(update.message); if (update.callback_query) return onCallback(update.callback_query); const kind = Object.keys(update).find((k) => k !== "update_id"); console.info("unhandled update kind:", kind); }

Usa allowed_updates como una segunda capa. Suscribirte únicamente a los tipos que manejas evita que lleguen eventos no relacionados.

Paso 4: Servir una Mini App desde localhost

Una Mini App es una página web que se ejecuta dentro del navegador in-app de Telegram y se comunica con el cliente a través de window.Telegram.WebApp. En desarrollo apunta a la URL de tu túnel:

  1. Inicia tu servidor de frontend en un puerto local.
  2. Inicia el túnel y toma nota del hostname público HTTPS.
  3. Configura esa URL donde se lanza la Mini App. Telegram documenta varias rutas: un botón web_app inline o de teclado, el botón de menú del bot (el /setmenubutton de BotFather o Bot Settings → Menu Button), la Mini App principal del bot en BotFather, y enlaces directos en la forma https://t.me/botusername/appname.
  4. Abre el bot dentro de Telegram y lanza la Mini App.

Mantén el hostname idéntico en todas las apariciones. La verificación de origen a continuación hace que eso sea más que una cuestión de orden.

Las Mini Apps de producción se sirven sobre HTTPS, lo que cualquier túnel proporciona. El entorno de prueba separado de Telegram es la excepción. Usa su propia cuenta y su propio bot, y su documentación permite enlaces de Mini App HTTP sin cifrar allí. Llamas a ello a través de https://api.telegram.org/bot<t token>/test/METHOD_NAME.

Dos trampas comunes de frameworks se repiten:

  • Comprobaciones de host. El servidor de desarrollo de Vite responde solo a solicitudes cuyo encabezado Host sea localhost, un subdominio .localhost o una dirección IP. De lo contrario devuelve “Blocked request. This host is not allowed.” Agrega el hostname de tu túnel a server.allowedHosts. Un punto inicial coincide con subdominios. No configures allowedHosts: true, porque eso acepta cualquier encabezado Host y expone el servidor de desarrollo a rebinding de DNS.
  • Hot reload. El WebSocket de HMR debe atravesar el túnel. Detrás de un túnel HTTPS puede necesitarse server.hmr.clientPort a 443. La guía de Strapi sugiere esto; pruébalo en tu configuración.

Para depurar dentro del cliente de Telegram, Telegram documenta estas opciones:

  • iOS: toca el icono de Settings 10 veces y activa Allow Web View Inspection, luego usa el menú Develop de Safari.
  • Android: habilita WebView Debug en la configuración de depuración de Telegram, y abre chrome://inspect/#devices.
  • Desktop: la beta de Windows/Linux tiene inspección webview experimental, y la beta de macOS tiene una opción de “Debug Mini Apps”.

Validar initData en tu servidor

Cuando la Mini App se abre, window.Telegram.WebApp.initData contiene una cadena de consulta firmada. Está vacío si la Mini App se lanzó desde un botón del teclado o desde el modo inline. Nunca confíes en initDataUnsafe ni en ningún objeto del lado del cliente. Envía la cadena sin procesar a tu backend y verifica con el algoritmo documentado de Telegram:

  1. Elimina el campo hash. Deja todos los demás valores recibidos, incluyendo signature, que existe para verificación de terceros.
  2. Ordena los pares clave=valor restantes alfabéticamente por clave y combínalos con saltos de línea (\n).
  3. Calcula una clave secreta: HMAC-SHA256 del token del bot, usando la cadena constante WebAppData como la clave.
  4. Calcula el HMAC-SHA256 de la cadena de verificación de datos con esa clave secreta, en hexadecimal.
  5. Compáralo con hash en tiempo constante, y rechaza valores de auth_date obsoletos. import crypto from "node:crypto"; function verifyInitData(initData, botToken, maxAgeSeconds = 3600) { const params = new URLSearchParams(initData); const hash = params.get("hash"); params.delete("hash"); const checkString = [...params.entries()] .sort(([a], [b]) => (a < b ? -1 : 1)) .map(([k, v]) => `${k}=${v}`) .join("\n"); const secret = crypto.createHmac("sha256", "WebAppData").update(botToken).digest(); const expected = crypto.createHmac("sha256", secret).update(checkString).digest("hex"); const valid = hash && hash.length === expected.length && crypto.timingSafeEqual(Buffer.from(hash), Buffer.from(expected)); const fresh = Date.now() / 1000 - Number(params.get("auth_date")) <= maxAgeSeconds; return Boolean(valid && fresh); }

Telegram solo dice que verifiques auth_date para evitar datos desactualizados. El periodo de una hora es tu elección. Si un tercero necesita validar los datos sin tu token de bot, Telegram ofrece un flujo Ed25519 signature que usa el ID numérico de tu bot y las claves públicas de Telegram.

La nueva verificación de origen de Mini App, explicada

Antes del 20 de julio de 2026, cualquier página abierta dentro del WebView de tu Mini App podría llamar a métodos de Telegram.WebApp.* como close(), expand(), el botón principal o sendData(). Ahora esas llamadas solo están permitidas desde el dominio propio de la Mini App. El registro de cambios de Telegram lo llama el “dominio original de Mini App”. La documentación de terceros lo describe como el dominio registrado en BotFather.

Qué significa en la práctica, según el análisis de Leadgram sobre el cambio:

  • Páginas en el dominio de la Mini App siguen funcionando.
  • Páginas en otro dominio, abiertas dentro de la Mini App, como una página de oferta, una página de pago o una página de autenticación, ya no pueden llamar a los métodos de Mini App. El artículo de AdsGram también señala que los entornos iframe y multi-dominio se ven afectados.
  • Todo lo demás sigue funcionando. Las páginas de terceros siguen abiertas en el webview, y los enlaces ordinarios, redirecciones HTTP, enlaces t.me y llamadas del lado del servidor no se ven afectadas. Exactamente una cosa está bloqueada: llamar a los métodos de la Mini App de Telegram desde un dominio ajeno. Las llamadas fetch simples desde tu página hacia un dominio de API separado son un asunto distinto.
  • El dominio registrado debe ser el real. Leadgram advierte que si la URL de tu Mini App apunta a una redirección, un rastreador o un acortador, la Mini App queda registrada en ese dominio. Las llamadas de Telegram desde tu dominio real quedan entonces bloqueadas. Apunta el registro al destino final.

Qué significa para localhost y túneles

La regla es sobre nombres de host. Estas son las consecuencias:

  • URLs aleatorias y rotativas significan que el hostname que sirve tu página cambia mientras el que registraste permanece antiguo. Espera que los métodos de la Mini App fallen hasta que lo actualices en todas partes.
  • Un subdominio estable te permite registrar una origin de la Mini App una vez. La URL en BotFather, la que ejecuta tu frontend y la que está en tu webhook se mantienen igual entre reinicios.
  • Entornos divididos merecen nombres de host separados, idealmente con un bot de desarrollo para cada uno. Mantén cada página que llama a Telegram.WebApp en el dominio registrado.

Una lista de verificación de depuración para cuando un método de la Mini App deje de funcionar repentinamente en desarrollo:

  1. Compara el origen de la página con la URL que registraste. ¿Son idénticos, incluso con el subdominio?
  2. Verifica si hay una redirección intermedia entre la URL registrada y la página.
  3. Busca en tu código Telegram.WebApp y verifica qué dominios sirven esas páginas. Leadgram sugiere recorrer el camino del usuario en Telegram Desktop o web.telegram.org con DevTools abiertos.
  4. Busca iframes o navegaciones a otros dominios, como proveedores de autenticación o páginas de pago.
  5. Confirma que el hostname del túnel no haya cambiado desde la última vez que lo registraste.

Si una página ajena solo llama a close() o a openLink(), la solución sugerida por Leadgram es reemplazar la llamada por un enlace ordinario https://t.me/... o una redirección.

¿Deberías optar por desactivarlo?

El BotFather Mini App te permite desactivarla, pero la redacción de Telegram es una advertencia: al hacerlo asumes la responsabilidad de asegurar que la Mini App no enlace a sitios no confiables. Optar por desactivarlo restaura el comportamiento antiguo, donde cualquier página dentro del webview puede activar la app, que es exactamente el agujero que Telegram cerró. Desactivarlo para hacer que un entorno de desarrollo funcione no es la solución adecuada cuando el problema real es un desajuste de origen. Arregla el desajuste, mantiene la protección, y reserva la opción de desactivarlo para casos en los que controles completamente cada página a la que la Mini App puede navegar.

Elegir un túnel: por qué un subdominio estable es la respuesta práctica

Cada pieza de configuración de Telegram en este artículo está vinculada a una URL: el endpoint del webhook, el dominio de la Mini App y el origen con el que Telegram compara cuando una página llama a un método de la Mini App. Cuando la URL cambia en cada reinicio, vuelves a registrar los tres cada vez. Una actualización olvidada produce síntomas confusos, como webhooks en silencio o métodos de Mini App que funcionaron ayer y fallan hoy.

Lo que te ofrecen las opciones gratuitas documentadas:

Opción Nombre de host Notas
ngrok Free Un dominio de desarrollo asignado por cuenta que no cambia al reiniciar el agente Límites según la documentación de ngrok: 1 GB de transferencia de datos y 20,000 solicitudes HTTP por mes, hasta 3 endpoints en línea. Los endpoints gratuitos no tienen timeout.
Cloudflare Quick Tunnel Hostname aleatorio trycloudflare.com en cada ejecución No se necesita cuenta, pero Cloudflare lo etiqueta como solo para pruebas, con un límite de 200 solicitudes concurrentes y sin Server-Sent Events.
Cloudflare named tunnel Un hostname que eliges en tu propio dominio Requiere una cuenta de Cloudflare y un dominio.

Ten en cuenta el intersticial de ngrok. En el nivel gratuito, ngrok muestra una página intersticial delante de todo el tráfico HTTP. ngrok dice que esto no afecta el acceso a la API ni el acceso programático, por lo que las entregas webhooks no deberían verse afectadas. Una página de Mini App cargada en el webview de Telegram es tráfico de navegador HTML, por lo que los usuarios pueden ver la página de advertencia. ngrok documenta dos formas de eliminarlo: actualizar a cualquier plan de pago, o hacer que el cliente envíe un encabezado de omisión o un User-Agent no estándar. La ruta de cabeceras es incómoda para una página que carga el webview de Telegram.

Otros servicios de tunelización ofrecen subdominios estables en planes gratuitos o de pago. Revisa los términos actuales de tu proveedor para la persistencia de subdominios, la duración de la sesión y las páginas de advertencia del navegador antes de depender de ellos.

Una lista de verificación de configuración

  1. Crea un bot de desarrollo dedicado en BotFather.
  2. Elige un túnel con un hostname estable, y usa ese hostname tanto para el webhook como para la Mini App.
  3. Llama a setWebhook una vez, con un secret_token y un allowed_updates estrecho.
  4. Registra la URL de la Mini App en el mismo hostname. Evita redirecciones.
  5. Permite el hostname en la comprobación de host de tu servidor de desarrollo.
  6. Verifica el header secret-token y initData en el servidor.
  7. Ignora y registra en logs los campos de actualización desconocidos, y deduplica por update_id.
  8. Cuando las entregas se detengan, verifica getWebhookInfo primero.

Preguntas frecuentes

¿Qué puertos puede Telegram enviar webhooks?
443, 80, 88 y 8443. Un túnel expone el puerto 443 y reenvía al puerto local que uses.

¿Qué pasa si mi webhook devuelve un error?
Telegram trata las respuestas que no son 2xx como fallos y reintenta, rindiéndose tras “un número razonable de intentos”. Un endpoint que falla ante entradas inesperadas puede provocar entregas repetidas.

¿Puedo omitir el túnel y usar getUpdates?
Para la lógica del bot, sí, siempre que no se haya configurado un webhook. Un Mini App aún necesita una URL que el cliente de Telegram pueda cargar, por lo que necesita un hostname público HTTPS. Las excepciones son el entorno de pruebas y un servidor local de Bot API, que sólo cubre el lado del bot.

¿Es obligatorio el token secreto?
No, pero sin él nada en una solicitud identifica a Telegram, y cualquiera que encuentre tu URL de túnel puede enviar actualizaciones falsificadas.

¿Es Bot API 10.2 la última versión?
No. Bot API 10.3 (24 de agosto de 2026) y 10.4 (9 de noviembre de 2026) se han lanzado desde entonces. El comportamiento de webhook y origen de la Mini App descrito aquí sigue aplicándose.

Fuentes

Continue from this article into the most relevant product guides and workflows.

Related Topics

#telegram bot localhost#telegram mini app localhost#telegram setWebhook#telegram webhook localhost#telegram bot api 10.2#telegram bot api update#telegram secret token header#X-Telegram-Bot-Api-Secret-Token#telegram webhook secret token#telegram mini app origin check#telegram mini app origin protection#telegram mini app development#telegram web app development#telegram mini apps tutorial#telegram bot tutorial#telegram bot webhook tutorial#telegram bot webhook https#telegram bot webhook tunnel#telegram bot ngrok alternative#telegram bot local development#test telegram bot locally#telegram bot webhook testing#telegram bot setWebhook error#telegram webhook not working#telegram webhook 404#telegram webhook ssl error#telegram bot retry updates#telegram bot unknown fields#telegram bot api migration guide#telegram bot api breaking changes#telegram botfather settings#telegram botfather mini app#botfather origin protection opt out#telegram mini app domain#telegram mini app stable subdomain#telegram mini app https localhost#telegram webhook vs long polling#telegram getUpdates vs webhook#telegram bot webhook security#telegram webhook validation#telegram initData validation#telegram web app initData#localhost tunneling#localhost tunnel for webhooks#expose localhost to internet#localhost https tunnel#static subdomain tunnel#persistent tunnel url#webhook testing tools#webhook debugging#local webhook development#developer infrastructure#cloud native development#devops tools#secure tunneling#reverse proxy for webhooks#instatunnel#telegram bot node.js webhook#telegram bot python webhook#telegram bot 2026

Keep building with InstaTunnel

Read the docs for implementation details or compare plans before you ship.

Share this article

More InstaTunnel Insights

Discover more tutorials, tips, and updates to help you build better with localhost tunneling.

Browse All Articles