Back to Picoclaw

Telegram

docs/channels/telegram/README.pt-br.md

0.2.82.2 KB
Original Source

Voltar ao README

Telegram

O canal Telegram utiliza long polling via a API de Bot do Telegram para comunicação baseada em bots. Suporta mensagens de texto, anexos de mídia (fotos, voz, áudio, documentos), transcrição de voz via Groq Whisper e tratamento de comandos integrado.

Configuração

json
{
  "channel_list": {
    "telegram": {
      "enabled": true,
      "type": "telegram",
      "token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      "allow_from": ["123456789"],
      "proxy": "",
      "use_markdown_v2": false
    }
  }
}
CampoTipoObrigatórioDescrição
enabledboolSimSe o canal Telegram deve ser habilitado
tokenstringSimToken da API de Bot do Telegram
allow_fromarrayNãoLista de IDs de usuários permitidos; vazio significa todos os usuários
proxystringNãoURL do proxy para conexão com a API do Telegram (ex. http://127.0.0.1:7890)
use_markdown_v2boolNãoHabilitar formatação Telegram MarkdownV2

Configuração inicial

  1. Pesquise por @BotFather no Telegram
  2. Envie o comando /newbot e siga as instruções para criar um novo bot
  3. Obtenha o Token da API HTTP
  4. Preencha o Token no arquivo de configuração
  5. (Opcional) Configure allow_from para restringir quais IDs de usuário podem interagir (os IDs podem ser obtidos via @userinfobot)

Formatação Avançada

Você pode definir use_markdown_v2: true para habilitar opções de formatação aprimoradas. Isso permite que o bot utilize todos os recursos do Telegram MarkdownV2, incluindo estilos aninhados, spoilers e blocos de largura fixa personalizados.

json
{
  "channel_list": {
    "telegram": {
      "enabled": true,
      "type": "telegram",
      "token": "YOUR_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"],
      "use_markdown_v2": true
    }
  }
}