> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buildzero.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Bot

> Interface principal — conversa com IA no Telegram

# Telegram Bot

O bot é a interface principal do BuildZero. Você conversa com ele como um chat normal no Telegram, e ele responde usando Claude AI com streaming em tempo real.

## Conversa com IA

* Respostas aparecem progressivamente — a mensagem vai sendo editada enquanto o Claude escreve
* Suporte a fotos — envie uma imagem e o bot analisa (multimodal)
* Histórico de sessão — o bot lembra do contexto da conversa
* Mensagens longas rotacionam automaticamente (proteção de 4096 chars do Telegram)

## Cancelamento

Envie `/cancel` a qualquer momento para cancelar a operação em andamento. O bot para de processar e confirma o cancelamento.

## Fila de mensagens

Se você enviar outra mensagem enquanto o bot está processando, ela entra na fila automaticamente. Você recebe uma confirmação e a mensagem é processada assim que a anterior terminar.

## Verbosidade

O bot pode mostrar o que a IA está fazendo (quais tools está usando) em diferentes níveis de detalhe. Configure com `set_settings`.

<Tabs>
  <Tab title="Nível 0 — Silencioso">
    Nenhuma indicação visual de tools. Só a resposta final.
  </Tab>

  <Tab title="Nível 1 — Reações (default)">
    Emoji na sua mensagem indicando a categoria da tool:

    * 💻 código/terminal
    * 🔍 busca
    * ✏️ edição
    * 🔑 auth
    * 📡 API
    * ⚙️ settings
    * 👍 sucesso / ❌ erro
  </Tab>

  <Tab title="Nível 2 — Preview">
    Blockquote inline com nome da tool e argumento principal:

    ```
    > 🔍 grep "pattern"...
    ```
  </Tab>

  <Tab title="Nível 3 — Verbose">
    YAML-like com args completos e resultado, cada tool em blockquote separado:

    ```
    > 🔍 grep
    >   pattern: "TODO"
    >   path: src/
    >
    > ✓ 3 matches found
    ```
  </Tab>
</Tabs>