¿Cómo funciona la respuesta en el cuerpo de la respuesta?

Telegram lee un nombre de método de la API del Bot y sus argumentos desde la propia respuesta del webhook, para que un bot simple pueda responder sin llamar a la API por separado. Es la forma de latencia más baja de responder y la más fácil de burlar.

¿De dónde viene chat_id?

De la Actualización entrante, a través de un token de solicitud que lee message.chat.id. Si tu payload de prueba omite esa ruta, el token se deja en la respuesta al pie de la letra en lugar de resolverse.

Simular un webhook de bot de Telegram

Un mock POST que responde a una Actualización de Telegram con una llamada a sendMessage de vuelta al mismo chat.

Telegram permite que un webhook responda a un Update devolviendo una llamada a un método de la Bot API en el propio cuerpo de la respuesta, en lugar de hacer una segunda petición saliente. Esta plantilla hace justo eso: lee el ID del chat del Update entrante y responde con un sendMessage dirigido a ese mismo chat, de modo que puedas ver el ciclo completo funcionando antes de escribir una línea de código del bot.

Acepta una llamada entrante y responde de la manera que espera el servicio.

Payload de respuesta

{
  "method": "sendMessage",
  "chat_id": {{request.body.message.chat.id}},
  "text": "Thanks, got it!"
}

Campos que vale la pena conocer

Campo	Lo que significa
method	El nombre del método de la API del bot que realiza la propia respuesta del webhook.
chat_id	Tomado de la Actualización entrante a través de {{request.body.message.chat.id}}.
text	El texto de respuesta; edítalo para probar una respuesta de bot diferente.

Crear el mock

curl -X POST https://quickmock.dev/api/mocks \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "POST",
  "response_status": 200,
  "content_type": "application/json",
  "response_body": "{\"method\":\"sendMessage\",\"chat_id\":{{request.body.message.chat.id}},\"text\":\"Thanks, got it!\"}"
}'

Llamarlo

curl -X POST -H 'Content-Type: application/json' -d '{"update_id":900000001,"message":{"message_id":42,"date":1717200000,"chat":{"id":987654321,"type":"private"},"text":"/start"}}' https://quickmock.dev/m/<slug>

Lo que obtienes

POST a Telegram Update -> 200 {"method":"sendMessage","chat_id":987654321,"text":"Thanks, got it!"}
the webhook response itself is treated as a Bot API method call

En qué se diferencia de la realidad

El token secreto del webhook de Telegram no se comprueba: este mock responde a cualquiera que publique una Actualización coincidente, no solo a los propios servidores de Telegram.

Fuentes

Preguntas frecuentes

¿Cómo funciona la respuesta en el cuerpo de la respuesta?: Telegram lee un nombre de método de la API del Bot y sus argumentos desde la propia respuesta del webhook, para que un bot simple pueda responder sin llamar a la API por separado. Es la forma de latencia más baja de responder y la más fácil de burlar.
¿Verifica el token secreto?: No. El token secreto del webhook de Telegram no se verifica, por lo que el mock responde a cualquiera que publique una Actualización coincidente. Considera esa verificación como trabajo de tu controlador.
¿De dónde viene chat_id?: De la Actualización entrante, a través de un token de solicitud que lee message.chat.id. Si tu payload de prueba omite esa ruta, el token se deja en la respuesta al pie de la letra en lugar de resolverse.

¿Listo para usarlo?

Ábrelo en el generador de mocks para ajustarlo primero

Combina bien con esta guía: Repetir los datos de la solicitud

Plantillas relacionadas

← Todas las plantillas

Última actualización: 2026-10-17