Botões no bot do Telegram: teclado de resposta, botões inline e telefone ou localização com um toque

São os botões que decidem se um bot do Telegram parece um bom atendente ou um formulário chato. O cliente que pode tocar em “Rastrear pedido” ou “Compartilhar meu número” responde em um segundo; quem precisa digitar o número do pedido, o celular com DDD no formato certo ou o endereço completo muitas vezes desiste no meio.

O Telegram oferece aos bots dois tipos de botão bem diferentes, e confundir os dois é o motivo mais comum de um bot ficar travado e confuso. Este guia explica o teclado de resposta e os botões inline, como pedir telefone ou localização com um toque e como montar tudo no MonoChat. O Telegram afirma ter mais de 1 bilhão de usuários ativos, então seu bot costuma ser o primeiro contato do cliente com a sua empresa.

Os dois tipos de botão num relance

	Teclado de resposta	Teclado inline
Onde aparece	No lugar do teclado do cliente, embaixo da caixa de mensagem	Embaixo de uma mensagem específica
O que o toque faz	Envia o texto do botão para o chat, como se fosse digitado	Envia dados ocultos ao bot, abre link ou Mini App; nada é publicado no chat
Pode pedir telefone ou localização	Sim (request_contact, request_location), em chats privados	Não
Depois do toque	Pode se esconder (one_time_keyboard)	Continua embaixo da mensagem
Melhor para	Respostas que devem ficar no chat: menu, Sim/Não, compartilhar contato ou localização	Ações sobre uma mensagem: links, confirmar/cancelar, escolher num card

Na Bot API eles se chamam ReplyKeyboardMarkup com objetos KeyboardButton e InlineKeyboardMarkup com objetos InlineKeyboardButton. O guia de bots do Telegram resume: diferente do teclado de resposta, apertar um botão inline não envia mensagem para o chat.

Teclado de resposta: respostas como se o cliente tivesse digitado

O teclado de resposta troca as letras do cliente por uma grade com os seus botões. Quando o cliente toca em “Horário de funcionamento”, esse texto aparece no chat enviado por ele, e o bot lê como qualquer outra mensagem. Por isso é ótimo para menus e respostas curtas: o histórico fica legível, e o atendente que abrir o chat depois vê exatamente o que foi escolhido.

Algumas opções definem o comportamento:

• resize_keyboard deixa o teclado só da altura dos botões. Sem isso, dois botões ocupam a altura de um teclado inteiro.
• one_time_keyboard esconde o teclado assim que ele é usado. Ele continua disponível por um ícone na caixa de texto, mas o cliente volta às letras.
• input_field_placeholder mostra uma dica de 1 a 64 caracteres na caixa de mensagem, como “Escolha uma opção”.
• is_persistent mantém os botões visíveis mesmo com o teclado normal escondido.

Como o toque envia texto puro, o nome do botão também é a sua chave de roteamento. Mantenha curto, único e estável: se “Rastrear pedido” virar “Cadê meu pedido?”, atualize a condição do fluxo que espera esse texto.

Pedir o telefone com “Compartilhar contato”

O bot do Telegram nunca vê sozinho o número do cliente. O único jeito é pedir: um botão de teclado com request_contact em true. Quando o cliente toca, o Telegram envia o número dele para o bot como contato. A Bot API avisa que isso só funciona em chats privados.

É muito mais confiável que “digite seu telefone”: sem DDI ou DDD esquecido, sem espaço no lugar errado, e é o número da conta do Telegram. É o primeiro passo natural para ligar o cliente a um pedido, um agendamento ou um registro no CRM.

Dois hábitos fazem o cliente tocar com mais confiança:

1. Diga por quê. “Compartilhe seu número para acharmos seu pedido” funciona melhor que um botão solto. O telefone é dado pessoal pela LGPD; informar a finalidade é o esperado.
2. Dê uma alternativa. Tem gente que não compartilha o número. Aceite também o número do pedido ou o e-mail, ou passe para um atendente.

Pedir a localização

request_location funciona igual: um toque envia a localização atual do cliente como mensagem de localização. Serve para endereço de entrega, loja mais próxima, envio de técnico ou para conferir se o endereço está na sua área de atendimento. Também só em chats privados, e quem decide é o cliente.

Botões inline: ações embaixo de uma mensagem

Botões inline pertencem a uma mensagem; fazem sentido quando a escolha é sobre ela: “Confirmar” e “Mudar horário” embaixo do resumo de um agendamento, “Ver cardápio” embaixo da saudação de um restaurante, “Pagar com Pix” embaixo de uma cobrança. Três tipos são os mais usados:

• Botões de callback: enviam ao bot até 64 bytes de dados (callback_data). Nada aparece no chat; o bot decide o próximo passo.
• Botões de URL: abrem uma página, como sua tabela de preços ou o rastreio dos Correios.
• Botões de Web App: abrem uma Mini App dentro do Telegram, como um formulário de agendamento ou um catálogo.

Um detalhe muda a experiência. Depois do toque em um botão de callback, o Telegram mostra um indicador de progresso até o bot chamar answerCallbackQuery, e pede que os bots façam isso mesmo quando não há nada para mostrar. Bot que pula esse passo deixa o botão “carregando”, e o cliente toca de novo e de novo.

Sobre contas Telegram Business. Se você conecta um bot a uma conta Telegram Business para ele responder nos seus chats pessoais, o Telegram não aceita teclado de resposta nem botões de Web App nas mensagens enviadas em nome dessa conta. Eles funcionam no chat com o próprio bot, que é como um bot conectado pelo token do BotFather, como no MonoChat, conversa com os clientes.

Qual usar em cada caso

Situação	Use
Menu principal: “Preços”, “Horário”, “Falar com atendente”	Teclado de resposta (respostas rápidas)
Sim/Não, notas, escolher horário	Teclado de resposta que some após um toque
Pegar o telefone do cliente	Botão de compartilhar contato
Endereço de entrega ou loja mais próxima	Botão de enviar localização
Confirmar ou cancelar o agendamento desta mensagem	Botões inline de callback
Abrir site, rastreio ou página de pagamento	Botão inline de URL
Formulário ou catálogo dentro do Telegram	Botão inline de Web App

Regra simples: se a resposta precisa aparecer na conversa, teclado de resposta. Se o botão age sobre uma mensagem ou sai do Telegram, botão inline.

Como criar botões do Telegram no MonoChat

O MonoChat conecta o seu bot pelo token do BotFather (veja como criar o bot e pegar o token). Desde a versão 3.8.41 (1º de novembro de 2026), o MonoChat envia respostas rápidas, solicitações de localização e de informações de contato como botões do teclado de resposta do Telegram, mostra o cabeçalho de imagem, vídeo ou documento das mensagens com botões, responde a todo toque para que nenhum botão fique carregando e pode mostrar o indicador de digitação.

1. Respostas rápidas (teclado de resposta). No fluxo, adicione um nó Enviar mensagem (ou crie uma das suas Mensagens curtas) e escolha o tipo Texto. Escreva o texto, ligue Resposta rápida e, em Botões, clique em Adicionar para cada botão. Defina Tipo como text e escreva o nome do botão em cada idioma que você atende. O Telegram mostra os botões embaixo da caixa de mensagem, dois por linha, no tamanho certo. Mensagens de imagem, vídeo e documento também aceitam respostas rápidas.

2. Peça o telefone. Escolha o tipo Solicitação de informações de contato e escreva a mensagem, por exemplo “Para localizar seu pedido, compartilhe seu número de telefone.” O Telegram mostra o botão Compartilhar informações de contato no idioma do cliente. Ele some depois de um toque, e o número chega no chat como contato. Uma resposta rápida do tipo user-phone-number faz o mesmo dentro de um menu.

3. Peça a localização. Escolha o tipo Solicitação de localização. O cliente vê o botão Enviar localização, e a localização chega como mensagem de localização.

4. Botões inline. Escolha o tipo Botão. Selecione um Tipo de cabeçalho se quiser imagem, vídeo ou documento no topo, escreva o texto (até 1.024 caracteres) e adicione os botões: postback para callback, web-url para link e app-url para Mini App. Os nomes têm até 20 caracteres. Um toque em postback chega no chat como Resposta de botão.

5. Direcione pela resposta. Comece o fluxo de bot com Nova mensagem recebida e ligue É bot?. Depois da pergunta, adicione um nó Se com a condição Texto da mensagem para as respostas rápidas, ou Tipo de mensagem para separar contato ou localização compartilhados de texto digitado. Quem escolher “Falar com atendente” vai para um nó Atribuir conversa.

6. Mostre que está digitando. Nas configurações do canal, ative Ativar indicador de digitação. O cliente vê “digitando” enquanto um atendente escreve e enquanto um nó de IA do fluxo prepara a resposta; durante o envio de imagem ou documento, o Telegram mostra que uma foto ou arquivo está sendo enviado.

Cada conversa, cada toque e cada contato compartilhado cai na mesma caixa de entrada da equipe que suas conversas de WhatsApp, Instagram e Messenger, então quem assume vê o que o cliente tocou.

Exemplo: o bot de entrega de uma farmácia

Cliente: /start Bot: Oi! Aqui é a Farmácia Vila Mariana, de São Paulo. Como podemos ajudar? (botões: Entrega em casa · Horário · Falar com o farmacêutico) Cliente: Entrega em casa Bot: Compartilhe seu número para encontrarmos sua receita. (botão: Compartilhar informações de contato) Cliente: (compartilha o contato) Bot: Obrigado! Onde entregamos? (botão: Enviar localização) Cliente: (compartilha a localização) Bot: Entregamos aí hoje entre 16h e 18h. (botões inline: Confirmar · Mudar horário)

Três teclados de resposta guardam as respostas no chat, e um teclado inline confirma o resumo. “Falar com o farmacêutico” vai direto para uma pessoa.

Erros para evitar

• Botões demais. De dois a seis por teclado se leem bem no celular. Menus longos vão para uma Mini App ou para um segundo passo.
• Pedir o telefone logo de cara. Peça quando o cliente souber para quê.
• Teclado que nunca some. O cliente acha que não pode digitar. Use teclado de uso único para perguntas pontuais.
• Botão sem resposta. Todo toque merece retorno, nem que seja “Recebido, só um instante”.
• Sem caminho para uma pessoa. Mantenha sempre “Falar com atendente”. Nosso guia de Telegram para empresas fala de transferência e horários.

Se você também usa WhatsApp, as ideias valem com outros limites: veja o guia de mensagens interativas do WhatsApp. Para incluir respostas com IA entre os botões, leia como criar um bot de IA no Telegram.

Comece grátis em app.monochat.ai e conecte seu bot do Telegram em poucos minutos.

Fontes

• Telegram Bot API: ReplyKeyboardMarkup, KeyboardButton, InlineKeyboardButton, answerCallbackQuery, sendChatAction (Bot API 10.3) (acessado em 2 de novembro de 2026)
• Telegram: recursos dos bots, teclados (acessado em 2 de novembro de 2026)
• FAQ do Telegram: mais de 1 bilhão de usuários ativos (acessado em 2 de novembro de 2026)
• Central de ajuda do MonoChat: tipos de mensagem, respostas rápidas, solicitações e indicador de digitação no Telegram (acessado em 2 de novembro de 2026)
• Changelog do MonoChat 3.8.41 (acessado em 2 de novembro de 2026)