Como funciona a resposta no corpo da resposta?

O Telegram lê um nome de método da API do Bot e seus argumentos da própria resposta do webhook, de modo que um bot simples pode responder sem chamar a API separadamente. É a maneira de menor latência para responder e a mais fácil de simular.

Do Update recebido, via um token de solicitação que lê message.chat.id. Se o seu payload de teste omitir esse caminho, o token é deixado na resposta textualmente em vez de resolver, e porque chat_id não tem aspas, a resposta volta como um JSON inválido em vez de um campo vazio. Vale a pena ver uma vez: um Update real com uma forma inesperada se comporta da mesma maneira.

Simular um webhook de bot do Telegram

Um mock POST que responde a um Update do Telegram com uma chamada sendMessage de volta para o mesmo chat.

O Telegram permite que um webhook responda a um Update retornando uma chamada de método da API do Bot no próprio corpo da resposta, em vez de fazer uma segunda solicitação de saída. Este modelo faz isso: ele lê o ID do chat do Update recebido e responde com um sendMessage endereçado de volta ao mesmo chat, para que você possa ver o ciclo completo funcionando antes de escrever qualquer código do bot.

Aceita uma chamada recebida e responde da maneira que o serviço espera.

Payload de resposta

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

Campos que valem a pena conhecer

Campo	O que significa
method	O nome do método da API do Bot que a própria resposta do webhook executa.
chat_id	Obtido do Update recebido via {{request.body.message.chat.id}}.
text	O texto de resposta; edite-o para testar uma resposta de bot diferente.

Criar o 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!\"}"
}'

Chame-o

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>

O que você obtém

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

Como isso difere do original

O token secreto do webhook do Telegram não é verificado — este mock responde a qualquer um que poste um Update correspondente, não apenas aos próprios servidores do Telegram.

Fontes

FAQ

Como funciona a resposta no corpo da resposta?: O Telegram lê um nome de método da API do Bot e seus argumentos da própria resposta do webhook, de modo que um bot simples pode responder sem chamar a API separadamente. É a maneira de menor latência para responder e a mais fácil de simular.
Ele verifica o token secreto?: Não. O token secreto do webhook do Telegram não é verificado, então o mock responde a qualquer um que poste um Update correspondente. Trate essa verificação como o trabalho do seu manipulador.
De onde vem chat_id?: Do Update recebido, via um token de solicitação que lê message.chat.id. Se o seu payload de teste omitir esse caminho, o token é deixado na resposta textualmente em vez de resolver, e porque chat_id não tem aspas, a resposta volta como um JSON inválido em vez de um campo vazio. Vale a pena ver uma vez: um Update real com uma forma inesperada se comporta da mesma maneira.

Pronto para usar?

Abrir no construtor de mocks para ajustar primeiro

Combina bem com este guia: Ecoe os dados da requisição de volta

Modelos relacionados

← Todos os modelos

Última atualização: 2026-10-17