# Modo inline no Telegram

## O que é o modo inline no Telegram?

Além do fato de que o bot pode 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 **Mensagem** .

O exemplo mais marcante e popular de um bot funcionando online é o @gif, com o qual você pode selecionar e enviar imagens gif:

<div data-with-frame="true"><figure><img src="/files/87eb332bda08f222f4b7949e22d4ce5c621b83b9" alt="" width="563"><figcaption><p>O bot @gif funcionará em qualquer chat.</p></figcaption></figure></div>

O bot @gif funcionará em qualquer chat.

## Como ativar o modo inline?

Para que o bot funcione no modo offline, você precisa ativar essa opção nas configurações do bot em [BotFather](https://t.me/BotFather).

Selecione o bot desejado e vá para o **Configurações do Bot**.

<div data-with-frame="true"><figure><img src="/files/1395e6824ec4fc8002ee069d4d796ede63d1f11c" alt="" width="315"><figcaption></figcaption></figure></div>

Depois escolha **Modo Inline**

<figure><img src="/files/641f1f781d5cd561b8727b4bb2702097c9880add" alt="" width="375"><figcaption></figcaption></figure>

Aqui você precisa ativar o modo offline, se ele não estiver ativado.

<figure><img src="/files/251e3a997dd5dcbf533c54d6ccc86aba95df5046" alt="" width="375"><figcaption></figcaption></figure>

## Como alterar o placeholder?

Se desejar, você pode alterar o placeholder que é exibido antes de inserir a consulta de busca. Por padrão, ele é ***Buscar…***

<div data-with-frame="true"><figure><img src="/files/45ddd7db192e67c07e5e0961abb8e3c02fc60ae5" alt="" width="563"><figcaption></figcaption></figure></div>

Para alterá-lo, clique em **Editar placeholder inline** botão:

<div data-with-frame="true"><figure><img src="/files/e906f2171bf276c5e72123445cfa51bd32eafcf6" alt="" width="563"><figcaption></figcaption></figure></div>

Defina o conteúdo exato do placeholder.

<div data-with-frame="true"><figure><img src="/files/59a7fd8403875418845eea2d11d52e0583f7db6c" alt="" width="563"><figcaption></figcaption></figure></div>

## Como configurar os resultados de saída

Depois de clicar em uma opção da lista no modo inline, uma mensagem será enviada, 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 acontece quase em tempo real.

Os dados na variável podem ser especificados de três maneiras. Vamos ver da forma mais simples até as configurações máximas.

### Um array com dados de texto

Por exemplo, a busca ocorrerá em um array de produtos.

<div data-with-frame="true"><figure><img src="/files/0f853da9b1b22ad80f8f7810baf19b1c723e2dce" alt="" width="563"><figcaption></figcaption></figure></div>

A variável inline\_bot é especificada nas configurações do projeto. A busca corresponde a qualquer variante do array que contenha a frase inserida.

<div data-with-frame="true"><figure><img src="/files/64643645f130c9becb3978ae04a2d706a1e6ed3f" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/997df37be8095aa47eb931cac77f5713bb2f4db4" alt="" width="563"><figcaption></figcaption></figure></div>

Quando você digita "@nome\_\_do seu\_\_bot" e as primeiras letras dos comandos, um menu é aberto com os valores que você especificou na variável do projeto.

Depois de 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:

<div data-with-frame="true"><figure><img src="/files/cc9120277f395ceb2b3567f8d62822a74cf156c2" alt=""><figcaption></figcaption></figure></div>

Dados de exemplo:

\["Leite", "Pão", "Macarrão", "Chocolate", "Ovos", "Manteiga", "Pãozinho", "Chá", "Legumes", "Frutas"]

### Saída na ausência de filtragem

Você pode definir uma chave vazia e atribuir a ela um array de valores em letras 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 busca especificado

{% hint style="warning" %}
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.](/doc/pt/chatbot/mensageiros/telegram/buttons.md#callback-button)

O botão funciona apenas no Telegram.
{% endhint %}

Para definir uma frase de busca, adicione o parâmetro inline\_query ao botão inline com um valor que é inserido automaticamente na consulta.

Recomenda-se usar esta opção para o modo offline, pois isso evitará erros e funcionará mais rápido.

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":"Статьи","type":"inline","inline\_query":"posts"},{"line":2,"index\_in\_line":0,"text":"Lista de produtos","type":"inline","inline\_query":"products"}]

<div data-with-frame="true"><figure><img src="/files/d3ab9360f359101a3f7184bd864d5047ab4747ea" alt="" width="375"><figcaption></figcaption></figure></div>

Quando você clica em um botão, por exemplo, um **Artigo,** a lista de botões encontrada será exibida (ao adicionar, você especificou "inline\_query":"posts" para este botão):

<div data-with-frame="true"><figure><img src="/files/c3613f477315cf05baf044df3dbb28f7ed29c33e" alt="" width="375"><figcaption></figcaption></figure></div>

As opções são retiradas de uma variável dada, como descrito acima em **"Dicionário com uma lista"** :

<figure><img src="/files/cc0d270130d75b31fbee3438659a4d2671b398cd" alt="" width="563"><figcaption></figcaption></figure>

### Observações

* A variável inline\_bot pode ser definida não apenas em variáveis gerais, mas também como uma variável simples, porém nesse caso seu valor deve estar entre aspas simples.

Exemplo no campo da calculadora:

inline\_bot = '\["Leite", "Pão", "Macarrão", "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:

<div data-with-frame="true"><figure><img src="/files/2fb8245b63c92f4a5349fc52af8869f74a3345de" alt="" width="563"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/chatbot/mensageiros/telegram/inline.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.