O que é o modo inline no Telegram?
Além de o bot poder responder a qualquer solicitação diretamente em um chat pessoal ou grupo, usando o modo online, você pode acessar globalmente o bot em um chat, grupo ou canal.
Para contatar um bot que tenha o modo online ativado, basta digitar @*nome do bot* no campo Mensagem.
O exemplo mais marcante e popular de um bot funcionando online é o @gif, com o qual você pode selecionar e enviar imagens gif:
O bot @gif funcionará em qualquer chat.
Como ativar o modo inline?
Para que o bot funcione no modo offline, você precisa ativar esta opção nas configurações do bot no BotFather.
Selecione o bot desejado e vá para as Configurações do Bot.
Em seguida, escolha Modo Inline
Aqui você precisa ativar o modo offline se ele não estiver ativado.
Como alterar o placeholder?
Se desejar, você pode alterar o placeholder que é exibido antes de inserir a consulta de pesquisa. Por padrão, é Pesquisar…
Para alterá-lo, clique no botão Editar Placeholder Inline:
Defina o conteúdo exato do placeholder.
Como configurar os resultados de saída
Após clicar em uma opção da lista no modo inline, uma mensagem será enviada, que é indicada no cabeçalho da opção selecionada, e você pode ajustar a reação no funil para esse valor.
Para especificar os dados a serem exibidos no modo inline, você precisa definir a variável inline_bot. No modo inline, a busca por valores na variável inline_bot ocorre quase em tempo real.
Os dados na variável podem ser especificados de três maneiras. Vamos analisar do mais simples ao máximo de configurações.
Um array com dados de texto
Por exemplo, a pesquisa ocorrerá em um array de produtos.
A variável inline_bot é especificada nas configurações do projeto. A pesquisa corresponde a qualquer variante do array que contenha a frase inserida.
Ao digitar '@nome__do__seu__bot' e as letras iniciais dos comandos, um menu é aberto com os valores que você especificou na variável do projeto.
Após clicar no item desejado, uma mensagem do usuário será enviada ao bot, para a qual você pode configurar a reação no bot.
A configuração do bloco fica assim:
Exemplo de dados:
["Leite", "Pão", "Massa", "Chocolate", "Ovos", "Manteiga", "Pãozinho", "Chá", "Legumes", "Fruta"]
Saída na ausência de filtragem
Você pode definir uma chave vazia e atribuir a ela um array de valores em minúsculas ou um array de dicionários. O bot acessará o dicionário usando uma chave vazia e exibirá botões com valores do array atribuído.
Um botão inline com o valor de pesquisa especificado
Por favor, observe!
Botões inline no Telegram não são callbacks.
Se você precisar receber callbacks, leia sobre botões de callback no Telegram.
O botão funciona apenas no Telegram.
Para definir uma frase de pesquisa, adicione o parâmetro inline_query ao botão inline com um valor que é automaticamente inserido na consulta.
Recomenda-se usar esta opção para o modo offline, pois evitará erros e funcionará mais rapidamente.
Por exemplo, adicione três botões que correspondam ao exemplo do capítulo anterior.
[{"line":0,"index_in_line":0,"text":"Mostrar o menu","type":"inline","inline_query":"menu"},{"line":0,"index_in_line":1,"text":"Artigos","type":"inline","inline_query":"posts"},{"line":2,"index_in_line":0,"text":"Lista de produtos","type":"inline","inline_query":"products"}]
Ao clicar em um botão, por exemplo, Artigo, a lista encontrada de botões será exibida (ao adicionar, você especificou "inline_query":"posts" para este botão):
As opções são retiradas de uma variável fornecida, conforme descrito acima na seção "Dicionário com uma lista":
Notas
- A variável inline_bot pode ser definida não apenas em variáveis gerais, mas também como uma variável simples, mas neste caso seu valor deve estar entre aspas simples.
Exemplo no campo calculadora:
inline_bot = '["Leite", "Pão", "Massa", "Chocolate", "Ovos", "Manteiga", "Massa Folhada", "Chá", "Legumes", "Frutas", "#{aa}"]'
Você também pode passar qualquer valor como variável para uma configuração mais flexível.
Por exemplo, uma opção simples em um array:
