Comentou WHATSAPP? Aqui está o passo a passo. O Kapso (com K) é um serviço que dá um número de WhatsApp pro seu agente de IA. Ele usa a API oficial do WhatsApp (o caminho da própria Meta pra programas trocarem mensagem) e é parceiro oficial da Meta (“Meta Business Partner”). Lá dentro tem caixa de entrada pra equipe, automações (workflows), agentes de IA, funções e disparos em massa. E tem skills (manuais que o Claude Code lê) pra você pedir em português: “monta um fluxo que marca horário pelo WhatsApp”.
Antes de tudo, cinco verdades:
- Não é “sem custo nenhum”. O plano grátis do Kapso tem 2.000 mensagens por mês. As taxas da Meta são à parte (por mensagem entregue). E o Claude Code exige um plano pago do Claude (Pro em diante).
- O número grátis pronto é americano (+1). Dá pra usar o seu próprio número (chip próprio, qualquer país), mas aí passa pelas aprovações da Meta.
- Não é “só ligar e pronto”. Precisa de conta no Kapso, da chave de API, do Claude Code e das aprovações da Meta (nome de exibição, verificação da empresa, modelos de mensagem, pagamento). As skills estão em fase alfa.
- Quem responde no WhatsApp é o agente que você monta no Kapso, não o Claude sozinho. O Claude Code ajuda a construir.
- Os passos vêm da documentação oficial e NÃO FORAM TESTADOS POR NÓS. As imagens são capturas das páginas públicas do Kapso.
| O que é | Detalhe |
|---|---|
| Nome | Kapso (com K). No vídeo saiu “Capsu”; em outros vídeos, “Capso”. O certo é Kapso |
| O que faz | Conecta um número ao WhatsApp oficial (API de nuvem da Meta) e deixa agentes e automações usarem |
| Recursos | Caixa de entrada da equipe, workflows e agentes de IA, funções, disparos em massa |
| Pro seu agente | Skills pro Claude Code, Cursor e Codex (fase alfa), servidor MCP e linha de comando (CLI) |
| Plano grátis | US$ 0/mês + US$ 2 de crédito, 2.000 mensagens/mês, 1 número conectado |
| Taxas da Meta | À parte, repassadas “at cost, no markup” (sem margem do Kapso) |
| Número | Americano pré-verificado grátis, ou seu chip próprio, ou o app WhatsApp Business que você já usa |
Como funciona, em palavras simples
Pense no Kapso como a “operadora” entre o WhatsApp e o seu agente:
- Você conecta um número ao Kapso (pelo site, sem programar).
- As mensagens chegam numa caixa de entrada que a sua equipe toda pode ver.
- Um agente ou automação responde do jeito que você configurou: tira dúvida, faz perguntas, chama um humano.
- O Claude Code, com as skills do Kapso, monta isso pra você a partir de um pedido escrito.
Os três jeitos de conectar um número, na página do Kapso:
Página pública kapso.com, 01/11/2026. Os números da imagem são exemplos do site.
O caminho mais simples
Passo da documentação, não testado por nós. Os passos 1 a 3 são no site, sem código. O passo 4 é um comando de copiar e colar. Reserve uns 30 minutos (fora o tempo das aprovações da Meta).
Separe o que você vai precisar
- Uma conta no Facebook. A conexão do número passa pela tela da Meta, onde você cria (ou escolhe) um Portfólio Empresarial da Meta (Meta Business Portfolio) e uma conta do WhatsApp Business.
- Um número pra WhatsApp: o americano grátis do Kapso, ou um chip só pra isso, ou o número que você já usa no app WhatsApp Business.
- O Claude Code, que vem no plano pago do Claude (Pro em diante; veja em claude.com/pricing). No plano grátis do Claude ele não está incluído.
- Os dados da sua empresa em dia na Meta (nome, endereço, telefone e um site com HTTPS), se você for usar em produção.
Crie a conta grátis e conecte um número
Crie a conta em app.kapso.ai (o plano grátis não pede cartão, segundo o site). Depois vá em Connected numbers → Connect new number e escolha um dos três jeitos:
| Opção | Pra quem | O que precisa |
|---|---|---|
| Instant setup | Começar agora, só pra testar | Conta no Facebook. O número é americano (+1) |
| Bring your own SIM | Ter um número seu, de qualquer país | Um chip dedicado, com verificação única |
| WhatsApp Business App | Continuar usando o app que você já tem | O número ativo no app WhatsApp Business e o celular perto (você escaneia um QR code) |
A documentação diz que leva “cerca de 5 minutos” (a home do site fala em 2). O Kapso abre a tela da Meta, você entra com o Facebook, escolhe o portfólio e confirma.
Atenção: conectar o número não pula as regras da Meta. Revisão do nome de exibição, verificação da empresa, revisão dos modelos de mensagem e forma de pagamento ainda podem travar o envio de verdade (docs do Kapso).
Pegue a sua chave do Kapso
No painel do Kapso, crie uma chave de API do projeto (API keys). É ela que deixa o Claude Code falar com a sua conta. Guarde como KAPSO_API_KEY e não compartilhe.
Se preferir não lidar com chave, a outra opção da documentação é instalar a linha de comando do Kapso e entrar pelo navegador (veja “Para quem quer ir além”).
Instale as skills no Claude Code
Abra o Terminal na pasta do seu projeto (no Mac: ⌘ + espaço, digite “Terminal” e Enter) e cole:
npx skills add gokapso/agent-skillsEsse comando baixa as skills do Kapso (manuais que o Claude Code lê quando precisa): integrate-whatsapp (conectar, mandar mensagens e modelos), automate-whatsapp (workflows, agentes, funções e bancos de dados), integrate-whatsapp-calling (ligações) e observe-whatsapp (logs e por que uma mensagem não chegou). Elas estão em fase alfa e mudam rápido. Precisa do Node.js instalado (é ele que traz o npx).
Antes de abrir o Claude Code, deixe a chave do passo 3 disponível no Terminal (troque pelo valor real, e não salve isso em nenhum arquivo que vá pro GitHub):
export KAPSO_API_KEY="sua_chave_do_kapso"Depois abra o Claude Code:
claudePeça o agente em português
O exemplo oficial do Kapso, em inglês, é este:
Add a workflow that books appointments over WhatsAppTraduzido por nós:
Crie um fluxo que marca horários pelo WhatsAppUm pedido mais completo, escrito por nós como exemplo:
Usando as skills do Kapso, crie um fluxo no WhatsApp que responde quem manda mensagem, pergunta o nome e o melhor dia e horário, confirma o pedido e me avisa na caixa de entrada pra eu aprovar. Antes de mandar qualquer mensagem de verdade, me mostre o fluxo e peça a minha confirmação.Importante: isso é um pedido de exemplo, não uma demonstração funcionando. As fontes não confirmam integração com Google Agenda nem outro calendário: o que existe são workflows, agentes, funções e bancos de dados dentro do Kapso. Se você quiser que o horário caia na sua agenda, isso é uma integração extra que você vai ter que montar e testar.
Respeite as regras da Meta antes de ligar pra valer
- Só mande mensagem pra quem pediu (opt-in). A política do WhatsApp exige que a pessoa tenha dado o número e concordado em receber mensagens suas.
- A janela de 24 horas. Cada mensagem do cliente abre (ou renova) uma janela de atendimento de 24 horas. Dentro dela você responde livre. Fora dela, só com modelo de mensagem aprovado pela Meta (template), que é cobrado.
- As taxas da Meta são por mensagem entregue, variam pela categoria (marketing, utilidade, autenticação, atendimento) e pelo país de quem recebe. O Brasil tem preço próprio na tabela da Meta.
- Comece no número de teste, com o seu próprio celular, antes de abrir pros clientes.
O que é verdade (e o que o vídeo simplificou)
- “Você não precisa desenvolver nada, a ferramenta já está pronta”: exagero. Você ainda precisa da conta no Kapso, de um plano pago do Claude pro Claude Code, da chave de API e das aprovações da Meta (nome de exibição, verificação da empresa, modelos, pagamento). E as skills estão em fase alfa.
- O nome: no vídeo saiu “Capsu” e “Capsule”. O certo é Kapso, com K. (No reel de referência que circulou, “Capso”: também errado.)
- “Agenda reuniões”: as fontes não confirmam integração com calendário. O exemplo oficial (“books appointments”) é um pedido de exemplo pra montar um fluxo, não uma integração pronta com a sua agenda.
- “2.000 mensagens grátis”: verdade no plano Free do Kapso, por mês. Mas as taxas da Meta são à parte.
Página pública kapso.com/pricing, 01/11/2026. Preços em dólar, sem as taxas da Meta.
Para quem quer ir além
Opcional. Passo da documentação, não testado por nós (docs.kapso.ai, kapso.com/whatsapp-agent-skills, kapso.com/whatsapp-claude-code e o README das skills, consultados em 01/11/2026).
Plugin do Claude Code (skills + MCP)
Em vez do npx, dá pra instalar o plugin do Kapso, que traz as skills e o servidor MCP (a “tomada” que deixa o Claude ver suas conversas, números e modelos ao vivo). Dentro do Claude Code, rode um de cada vez:
/plugin marketplace add gokapso/agent-plugins/plugin install kapso@kapsoCom o plugin, a página do Kapso diz que dá pra conectar a sua conta do Kapso pelo próprio agente.
Só o MCP, na mão
Com a KAPSO_API_KEY já exportada no Terminal (passo 4), o comando oficial é:
claude mcp add --transport http kapso https://api.kapso.ai/mcp --header "Authorization: Bearer $KAPSO_API_KEY"Comece com um pedido que só lê, como sugere o Kapso:
List my WhatsApp numbers and their quality ratingO Claude Code pede permissão antes de rodar cada ferramenta do Kapso. Confirme com calma antes de deixar ele mandar mensagem ou mexer em modelos.
Codex
O Kapso também tem plugin pro Codex. No Terminal:
codex plugin marketplace add gokapso/agent-pluginscodex plugin add app-69e50baf29a48191847ceec3bfd887a4@kapsoA linha de comando do Kapso (CLI)
Pra quem prefere entrar pelo navegador em vez de usar chave. Precisa do Node.js 20.19 ou mais novo:
npm install -g @kapso/clikapso loginkapso statusAs skills preferem a CLI quando ela está instalada e logada. Sem a CLI, elas usam a KAPSO_API_KEY e o endereço KAPSO_API_BASE_URL=https://api.kapso.ai (README das skills).
As skills, uma por uma
| Skill | Pra que serve | Pedido de exemplo do Kapso |
|---|---|---|
integrate-whatsapp | Conectar números, receber mensagens (webhooks), mandar mensagens e modelos | “Let our customers connect their own WhatsApp numbers” |
automate-whatsapp | Workflows, agentes, funções e bancos de dados dentro do Kapso | “Add a workflow that books appointments over WhatsApp” |
observe-whatsapp | Logs, por que uma mensagem ou modelo não chegou, saúde de cada número | “Why did yesterday's reminders fail for some customers?” |
integrate-whatsapp-calling | Ligações pelo WhatsApp e agentes de voz | (sem exemplo na página) |
O repositório das skills não traz arquivo de licença, então não copiamos os arquivos pra cá: o comando npx skills add baixa direto da fonte oficial.
O agente do próprio Kapso
Dentro do painel existe o Kapso Agent: você descreve o que quer e ele monta workflows e modelos lá dentro, sem Claude Code. O uso de IA sai dos seus créditos (o site fala em “no markup”, só a taxa de pagamento). Não testamos.
Os outros planos
| Plano | Preço | Mensagens/mês | Números conectados |
|---|---|---|---|
| Free | US$ 0 (+ US$ 2 de crédito) | 2.000 | 1 (+ número sandbox) |
| Pro | US$ 25/mês | 100.000 (+ US$ 0,002 por extra) | 3 (+ US$ 10 por extra) |
| Platform | US$ 299/mês | 1.000.000 (+ US$ 0,001 por extra) | 50 (+ US$ 5 por extra) |
O Kapso conta todas as mensagens no limite, as que você manda e as que recebe (docs de preço). Taxas da Meta sempre à parte.
Perguntas rápidas
Precisa saber programar?
Pra criar a conta e conectar o número, não: é tudo pelo site. Pra usar as skills, você precisa do Claude Code (um comando no Terminal e um pedido em português). Pra colocar um atendimento de verdade no ar, ajuda muito saber conferir o que o Claude montou e testar antes.
É grátis?
O plano Free do Kapso é US$ 0 por mês, com US$ 2 de crédito e 2.000 mensagens por mês (não são ilimitadas: ilimitados são os agentes e workflows). Mas não é grátis de ponta a ponta: as taxas da Meta são cobradas à parte, por mensagem entregue, e o Claude Code pede um plano pago do Claude (Pro em diante).
Funciona no meu computador? E no meu celular?
O Kapso é um site: abre em qualquer navegador. O Claude Code roda no Terminal do computador (Mac, Linux ou Windows). O WhatsApp do seu cliente é o normal, no celular dele. Se você usa o app WhatsApp Business, dá pra continuar usando ele junto com o Kapso.
O número é brasileiro?
O número grátis pronto é americano (+1). Pra ter um número brasileiro, use o seu próprio chip (qualquer país) ou o app WhatsApp Business que você já usa, sujeito às aprovações da Meta.
É seguro? Posso ser banido?
- É o caminho oficial (API da Meta, parceiro oficial), não um “WhatsApp pirata”. Isso reduz o risco, mas não zera: as regras da Meta valem.
- Só mande pra quem pediu (opt-in) e respeite a janela de 24 horas. Spam e mensagem sem permissão podem derrubar a qualidade do número.
- Guarde a
KAPSO_API_KEYsó no seu computador e nunca suba pro GitHub. - As mensagens passam pelo Kapso e pela Meta, e pelo modelo de IA que você usar no agente.
O Claude responde sozinho no meu WhatsApp?
Não. Quem responde é o agente ou workflow que você monta no Kapso. O Claude Code, com as skills, ajuda você a construir e consertar esse agente.
Limites honestos
- Não é grátis de ponta a ponta: Kapso Free + taxas da Meta + plano pago do Claude pro Claude Code.
- 2.000 mensagens por mês no Free.
- Número grátis americano; brasileiro só com seu chip ou o app Business, com aprovação da Meta.
- Aprovações da Meta podem travar o envio de verdade mesmo com o número conectado.
- Skills em fase alfa: comandos e nomes podem mudar.
- Sem integração de calendário confirmada.
- Não testamos o Kapso nem medimos nada. Os dados foram consultados em 01/11/2026 e podem mudar.
Créditos e fonte
- Produto: Kapso, “WhatsApp for developers”, Meta Business Partner. Capturas das páginas públicas kapso.com e kapso.com/pricing, em 01/11/2026.
- Skills e instalação: kapso.com/whatsapp-agent-skills, Claude Code + Kapso e a documentação do Kapso.
- Conectar número: docs do Kapso, Connect WhatsApp.
- Taxas e janela de 24 horas: preços da Meta e a política do WhatsApp Business.
- Claude Code no plano Pro: claude.com/pricing.
- Código-fonte das skills: github.com/gokapso/agent-skills (sem arquivo de licença; não copiamos nada de lá).
- Este guia não é afiliado ao Kapso, à Meta nem à Anthropic.
Comentários
Ficou com alguma dúvida ou tem algo a acrescentar? Participe da conversa.
Sem precisar de conta. Clique em Entrar e escolha um nome para comentar.
Carregando a conversa…
Privacidade dos comentáriosDiretrizes para comentários