Skip to content

Instantly share code, notes, and snippets.

@peas
Created September 3, 2026 18:10
Show Gist options
  • Select an option

  • Save peas/199dd26cd6ee08f4ec29eb65ec317b0b to your computer and use it in GitHub Desktop.

Select an option

Save peas/199dd26cd6ee08f4ec29eb65ec317b0b to your computer and use it in GitHub Desktop.
Exercicio B (StartSe): assistente Telegram + Claude 100% visual no Make.com, sem codigo

Exercício B: seu assistente no Telegram, 100% visual (Make.com) 🧩

Paulo Silveira × StartSe — Imersão Vale do Silício

Esta é a versão sem código e sem Claude Code do exercício do assistente pessoal. Lá, o Claude Code monta um servidor pra você. Aqui, você mesmo monta tudo arrastando caixinhas no Make.com, um automatizador visual. É o mesmo Lego, com peças maiores: menos poder, zero código.

O que você vai montar: mandou mensagem pro seu bot no Telegram → o Make acorda → pergunta pro Claude → devolve a resposta no chat. Três caixinhas.


Parte 0 — As contas (~15 min)

  1. Telegram — se ainda não tem: app na loja, número de telefone, pronto.
  2. Bot no Telegram — procure @BotFather/newbot → escolha nome e username (termina em bot). Guarde o token (formato 123456:ABC-DEF...). Importante: use um bot novo pra este exercício. O Telegram só permite um "ouvinte" (webhook) por bot; um bot já usado em outra ferramenta dá conflito.
  3. Claude (API)console.anthropic.com → crie uma API key e coloque ~US$ 5 de créditos. É o cérebro.
  4. Makemake.com → conta gratuita (1.000 créditos por mês, dá pra ~250 mensagens — de sobra pra montar e testar).

Checkpoint: você tem o token do @BotFather e a API key da Anthropic.


Parte 1 — O cenário de 3 caixinhas (~20 min)

Atalho: o Make tem um template oficial pronto com exatamente esse fluxo, o nº 14822 "Send replies to Telegram messages using Claude AI". Clique em "Use template" e ele já monta as caixinhas; você só conecta as contas. Abaixo, o mesmo caminho feito à mão, pra entender cada peça:

Caixinha 1 — ouvir o Telegram

  1. No Make: Create a new scenario → adicione o módulo Telegram Bot → Watch Updates.
  2. Em Connection, clique Add e cole o token do @BotFather. O Make registra o webhook sozinho; você não configura nada no Telegram.

Caixinha 2 — perguntar pro Claude

  1. Adicione o módulo Anthropic Claude → Create a Prompt ligado ao anterior.

  2. Em Connection, cole sua API key da Anthropic.

  3. Escolha o modelo: Haiku 4.5 (rápido e barato, ótimo pra começar) ou Sonnet (mais esperto, ~3× o preço).

  4. No campo da mensagem do usuário, mapeie o texto que veio do Telegram (clique no campo e selecione Message: Text da caixinha 1).

  5. No system prompt, descreva seu assistente. Sugestão:

    Você é meu assistente pessoal no Telegram. Responda em português, curto e direto, sem enrolação. Se não souber, diga que não sabe.

Caixinha 3 — responder no chat

  1. Adicione Telegram Bot → Send a Text Message or a Reply.
  2. Em Chat ID, mapeie o Chat ID que veio da caixinha 1.
  3. Em Text, mapeie a resposta do Claude (caixinha 2).

Ligar

  1. Salve e ative o cenário (botão de liga/desliga, modo Immediately).
  2. Mande "oi" pro seu bot. 🎉

Checkpoint: o bot responde qualquer pergunta, de qualquer lugar, sem nenhum servidor seu — o Make é o servidor.


Custos reais

Uso Quanto
Montar e brincar R$ 0 no Make (free) + centavos de API
Bot pessoal diário (~30 msgs/dia) Make Core ~US$ 9/mês + API ~US$ 3-4/mês (Haiku)

Exercícios a mais (um por vez)

O esqueleto está pronto; agora é encaixar peças. Cada item abaixo é um upgrade que os assistentes reais do Paulo fazem, adaptado ao Make:

  1. Memória — do jeito que está, cada mensagem é independente (o bot não lembra a anterior). O Make tem Data Store (mini-banco visual): guarde o histórico por Chat ID e inclua no prompt (Get record → prompt com histórico → Claude → Add/Replace record).
  2. Voz — quando vier message.voice: Telegram Bot → Download a File + OpenAI → Create a Transcription (Whisper; precisa de uma conta OpenAI, a Anthropic não transcreve áudio). Dica: o Telegram entrega .oga; renomeie para .ogg no mapeamento do arquivo.
  3. AgendaGoogle Calendar → Search Events (login visual com o Google) → Claude resume → Telegram. "O que tenho amanhã?" em três caixinhas.
  4. Drive, Gmail, Tasks — todos têm conector nativo com "Sign in with Google". Comece sempre lendo (buscar, resumir); escrever e apagar merecem muito mais cuidado.

Regras de ouro valem aqui também: ler à vontade, escrever com confirmação, dinheiro e senhas não passam pelo bot.


"E o claude -p? O Make roda o Claude Code?"

Não. O Make chama a API do Claude: uma pergunta entra, uma resposta sai. O exercício A roda o Claude Code (claude -p) num servidor — um agente com ferramentas: lê arquivos, roda programas, mexe em git, pesquisa em background por 20 minutos, e pode até evoluir o próprio bot.

É a troca honesta entre os dois exercícios: aqui você monta sozinho, em meia hora, sem escrever uma linha — e sente o teto mais cedo. Quando o teto incomodar, o exercício A está te esperando. As histórias completas estão em paulo.com.br.


Exercício da palestra "Agentes, Orquestração e Disposable Software", de Paulo Silveira (paulo.com.br · @paulosilveira), para a Imersão Vale do Silício da StartSe. Setembro/2026.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment