Como conectar o WhatsApp a um agente de IA
Por Bhavya Barot · Atualizado em
Há dois caminhos principais para colocar um agente de IA no WhatsApp. Um é a Business Platform do próprio WhatsApp. O outro é conectar sua própria conta por QR code, que é como o Spaces funciona.
Veja o que cada um envolve, com as regras do WhatsApp citadas, e depois um guia simples para escolher um caminho, configurar e ensinar seu agente a responder como o seu negócio.
O que um agente de IA no WhatsApp faz de verdade
Um agente de IA como Claude, ChatGPT ou Grok pode ler as mensagens que os clientes enviam a você, entender o que eles querem e responder na mesma conversa.
Para um pequeno negócio, isso normalmente significa responder o dia todo às mesmas poucas perguntas: vocês estão abertos, quanto custa, posso agendar, cadê meu pedido.
O agente não vive dentro do WhatsApp. Ele precisa de uma conexão entre o seu número de WhatsApp e o agente, e é nessa conexão que os dois caminhos são diferentes.
Caminho 1: a WhatsApp Business Platform
A Política de Mensagens Comerciais do WhatsApp diz:
- Você só pode entrar em contato com pessoas que deram o número a você e aceitaram receber suas mensagens.
- Você deve respeitar todos os pedidos para parar de receber mensagens.
- Você só pode começar conversas usando um Modelo de Mensagem aprovado.
- Você pode responder sem modelo dentro da janela de atendimento ao cliente de 24 horas, que abre e recomeça a cada mensagem do usuário.
- Você pode usar automação ao responder durante a janela de 24 horas, mas precisa ter caminhos de escalonamento rápidos, claros e diretos. Exemplos: transferência no chat para um atendente humano, um número de telefone, e-mail, suporte pela web, visitas à loja ou um formulário de suporte.
- As mensagens são cobradas de acordo com a política de preços do WhatsApp.
Este é o caminho do próprio WhatsApp para empresas que mandam mensagens a clientes em grande escala.
Serve para equipes maiores que enviam mensagens de modelo a pessoas que deram consentimento, como atualizações de pedido e lembretes, e que aceitam trabalhar dentro das regras de modelos e da janela.
Caminho 2: sua própria conta por QR code (Spaces)
O Spaces conecta sua própria conta do WhatsApp por QR code e dá ao seu agente um servidor MCP e uma API REST.
O agente pode ler conversas, responder, começar conversas e receber webhooks de novas mensagens. É mais rápido de configurar, mas não é a Business Platform.
Leia o aviso acima: os Termos do WhatsApp proíbem mensagens em massa, mensagens automáticas e uso não pessoal, a menos que o WhatsApp tenha autorizado.
A vantagem para um pequeno negócio é que nada muda para seus clientes. Eles continuam mandando mensagem para o número que já têm, você continua com o app do WhatsApp no celular e o agente trabalha nas mesmas conversas.
O risco é que sua conta continua sujeita aos Termos de Serviço do WhatsApp, e qualquer restrição ou banimento é responsabilidade sua.
Qual caminho combina com o seu negócio
| Se você | Considere |
|---|---|
| Quer enviar lembretes ou atualizações para uma lista grande de pessoas que deram consentimento | A Business Platform, com Modelos de Mensagem aprovados |
| Responde principalmente mensagens que os clientes enviam para o seu número atual | Sua própria conta por QR code, usada para respostas |
| Quer disparar promoções para muitos números | A Business Platform, com consentimento. O Spaces não serve para disparos de modelos para listas grandes. |
| É uma equipe pequena que quer ajuda rápido, sem números novos | Sua própria conta por QR code, depois de ler o quadro de aviso |
| Não pode aceitar nenhum risco para o seu número | A Business Platform, ou deixe o agente só escrevendo rascunhos enquanto você envia à mão |
Boas práticas em qualquer caminho
- Priorize conversas que o cliente começa.
- Peça consentimento antes de mandar a primeira mensagem para alguém, e diga como parar de receber.
- Pare na hora quando pedirem.
- Ofereça uma forma de falar com uma pessoa.
- Nunca envie mensagens em massa ou frias.
Quais agentes de IA funcionam com o Spaces
O Spaces funciona com o agente que você já usa. Todos se conectam ao mesmo servidor MCP, https://api.spacesos.com/mcp, e entram no Spaces pelo navegador. Um cabeçalho com chave de API também funciona.
| Agente | Como se conecta |
|---|---|
| Claude (web e desktop) | Personalizar, depois Conectores, depois Adicionar conector personalizado, e entre no Spaces |
| Claude Code | Um comando claude mcp add, depois /mcp para entrar |
| ChatGPT | Ative o Modo de desenvolvedor, crie um conector com o URL do Spaces e escolha OAuth |
| Grok | grok.com/connectors, depois New Connector, depois Custom |
| Cursor | Adicione o Spaces ao arquivo mcp.json dele e entre |
| Codex | codex mcp add, depois codex mcp login |
| OpenClaw e Hermes | Adicione o Spaces na configuração deles e execute o comando de login MCP |
O passo a passo de cada um está na página de agentes.
Como configurar o Spaces
- Cadastre-se com seu e-mail e o código de 6 dígitos que o Spaces envia. Um agente pode fazer isso por você pelo servidor MCP de cadastro em https://api.spacesos.com/mcp/start.
- Conecte o WhatsApp: abra o link de conexão e escaneie o QR code. O plano Free começa nessa primeira conexão. Não precisa de cartão.
- Crie uma chave de API. Ela começa com spc_live_ e só é mostrada uma vez, então guarde em um lugar seguro.
- Adicione o servidor MCP https://api.spacesos.com/mcp ao seu agente, ou chame a API REST em https://api.spacesos.com/v1.
Para escanear o QR code, abra o link de conexão em um computador. Depois, no celular, abra o WhatsApp, vá em Dispositivos conectados e aponte o celular para o código. Se você tem vários números, conecte cada um. Cada número é uma conta própria.
Ensine o seu negócio ao agente
Um agente responde bem quando conhece os fatos e as suas regras. Dê a ele algo assim, com os seus dados:
You answer WhatsApp messages for Rosa's Kitchen, a 40-seat restaurant.
- Hours: Tuesday to Sunday, 12 till 10. Closed Mondays.
- Bookings: up to 8 people by message. Larger groups: pass to Rosa.
- Menu questions: answer from the menu below. Allergies: always pass to a person.
- Never promise a table without checking the bookings list.
- If someone is upset or asks for a refund, say a person will reply shortly and hand the chat over.
- If someone says stop, do not message them again.
- Keep replies short and friendly.Nomes e detalhes são exemplos. Atualize as notas sempre que seus horários, preços ou cardápio mudarem, para o agente nunca passar informação velha.
Um exemplo de conversa
Veja como pode ser uma reserva depois que o agente conhece as regras acima. Nomes e detalhes são exemplos.
| Quem | Mensagem |
|---|---|
| Cliente | Oi, vocês têm mesa para 4 amanhã por volta das 7? |
| Agente | Oi! Sim, temos às 7:15 amanhã para quatro pessoas. Posso reservar no seu nome? |
| Cliente | Sim, por favor, é Daniel. Um de nós é celíaco, tudo bem? |
| Agente | Reservado para Daniel, quatro pessoas, 7:15 amanhã. Sobre a questão do celíaco, vou pedir para a Rosa responder, para você ter a resposta certa. |
| Rosa | Oi, Daniel! Sim, temos vários pratos sem glúten e uma fritadeira separada. Até amanhã! |
O agente cuidou da parte de rotina e depois passou a pergunta sobre alergia para uma pessoa, exatamente como as notas mandavam. Esse é o repasse que a política do WhatsApp espera na Business Platform, e é uma boa prática em qualquer caminho.
Como configurar o repasse para uma pessoa
A política do WhatsApp para a Business Platform espera uma forma clara de falar com uma pessoa, e os clientes esperam isso em qualquer caminho. Decida três coisas antes de o agente entrar em funcionamento.
- O que o agente repassa: reclamações, reembolsos, alergias, qualquer coisa médica ou jurídica, e tudo sobre o que ele tiver dúvida.
- O que ele diz quando repassa: uma frase curta como "Vou pedir para a Rosa responder. Ela costuma voltar em até uma hora."
- Quem assume: uma pessoa específica, ou quem estiver de turno. Quando uma pessoa assume uma conversa, o Spaces mantém o agente fora dela até ela ser devolvida.
Os limites que o Spaces mantém no WhatsApp
| O quê | Limite do Spaces |
|---|---|
| Intervalo entre mensagens | Pelo menos 15 segundos |
| Mensagens | 400 por dia por número, e sem limite diário para respostas a quem escreveu para você |
| Novas conversas | 5 por hora e 10 por dia, depois do aquecimento |
| Primeiras 24 horas depois de conectar | Nenhuma conversa nova |
| Resto da semana 1, semana 2, semanas 3 e 4 | 3, depois 6, depois 8 novas conversas por dia |
Respostas a quem manda mensagem para você não são seguradas pelo aquecimento. O mesmo texto frio não pode ser enviado para muitas pessoas, e qualquer mensagem para alguém que pediu para parar é recusada. Esses limites reduzem o risco.
Eles não garantem como o WhatsApp vai tratar o seu número.
Resumindo
A Business Platform é o caminho do WhatsApp para mensagens em grande escala, com consentimento, modelos e uma janela de 24 horas para respostas.
Conectar sua própria conta por QR code é mais rápido e mantém o número que você já tem, mas os Termos do WhatsApp proíbem mensagens automáticas sem autorização.
Seja qual for sua escolha, priorize conversas que os clientes começam, dê ao agente notas claras e mantenha uma pessoa por perto.
Para quem você manda mensagem
Preços
Grátis para começar, depois $19 por conta conectada por mês
Perguntas para responder antes de escolher um caminho
Os dois caminhos servem para negócios diferentes, e o certo costuma ficar óbvio quando você é honesto sobre como usa o WhatsApp. Sente com uma caneta e responda a estas perguntas antes de configurar qualquer coisa. Anote as respostas, porque você vai querer consultá-las depois.
- Das mensagens que recebo em uma semana normal, quantas são de pessoas que me escreveram primeiro, e quantas eu enviaria sem ninguém pedir?
- Já tenho permissão por escrito das pessoas para quem eu mandaria a primeira mensagem, e conseguiria mostrar se me pedissem?
- Um cliente ficaria surpreso ao saber que um agente escreveu minha resposta, ou só ficaria feliz com uma resposta rápida?
- Se meu número fosse restrito no mês que vem, quanto isso prejudicaria o negócio?
- Quem vai revisar o trabalho do agente, e quando?
Se a maioria das suas mensagens vem de clientes que escrevem para você, e uma restrição prejudicaria muito, isso pede cautela: no começo, deixe o agente só nos rascunhos e envie à mão.
Se você envia principalmente atualizações para uma lista grande que aceitou receber suas mensagens, isso aponta para o outro lado.
Teste seu agente antes de os clientes conhecerem ele
Nunca solte um agente novo em clientes de verdade como primeiro teste. Peça a um amigo, a um colega ou use um segundo celular para fazer o papel de cliente por uma tarde.
Passe uma lista de mensagens difíceis para enviar e observe o que o agente escreve.
Inclua as perguntas fáceis, mas passe a maior parte do tempo nas difíceis. O objetivo é encontrar as lacunas nas suas notas enquanto a única pessoa que vê os erros é você.
- Uma pergunta de rotina que suas notas respondem com clareza, como seu horário de funcionamento.
- Uma pergunta que suas notas não respondem de jeito nenhum. O resultado certo é "Vou verificar e já te retorno", e não uma invenção.
- Uma mensagem vaga como "oi?" ou um único emoji. O agente faz uma pergunta sensata de volta?
- Uma mensagem de alguém chateado. O agente deve ser calmo, breve e passar a conversa para uma pessoa.
- Uma mensagem pedindo para parar. Nada mais deve ser enviado depois disso.
- Um pedido para fazer algo que suas notas proíbem, como prometer uma reserva sem verificar.
Corrija cada falha acrescentando uma linha nas notas e envie a mesma mensagem de novo. Só pare de testar quando o agente lidar com os seis casos do jeito que você gostaria que um funcionário novo lidasse.
Como saber se está funcionando
Depois de umas duas semanas, você deve conseguir dizer se a conexão está valendo a pena. Não confie em impressão. Procure evidências concretas, e esteja pronto para mudar de rumo se elas não aparecerem.
- Os clientes recebem uma primeira resposta mais rápido do que antes, e menos mensagens ficam sem leitura durante a noite.
- As perguntas que você respondia sem parar agora estão resolvidas, e você gasta seu tempo com as mais difíceis.
- Quando uma conversa passa para uma pessoa, o agente deixa uma nota clara, e você nunca precisa rolar para cima para entender o que aconteceu.
- Nada nas mensagens enviadas surpreende você quando você lê.
- Ninguém disse que as respostas pareceram frias, erradas ou insistentes.
Se as evidências forem mistas, mude uma coisa de cada vez. Edite as notas, acrescente uma regra de repasse ou volte para os rascunhos por uma semana. Mudar várias coisas ao mesmo tempo dificulta ver qual mudança ajudou.
Resumo
Há dois caminhos principais para colocar um agente de IA no WhatsApp. Um é a Business Platform do próprio WhatsApp.
Perguntas frequentes
O que é a WhatsApp Business Platform?
É a ferramenta do WhatsApp para empresas gerenciarem conversas com clientes em grande escala. A política dela exige consentimento e Modelos de Mensagem aprovados para começar conversas, e permite respostas livres dentro de uma janela de atendimento ao cliente de 24 horas.
Um agente de IA pode responder na WhatsApp Business Platform?
A Política de Mensagens Comerciais do WhatsApp diz que você pode usar automação ao responder durante a janela de 24 horas, desde que tenha caminhos de escalonamento rápidos, claros e diretos, como uma transferência para um atendente humano.
Como o Spaces conecta o WhatsApp?
O Spaces conecta sua própria conta do WhatsApp escaneando um QR code. Não é a WhatsApp Business Platform e não tem vínculo com a Meta nem com o WhatsApp.
O WhatsApp permite automação em contas comuns?
Os Termos de Serviço do WhatsApp proíbem mensagens em massa, mensagens automáticas e uso não pessoal, a menos que o WhatsApp tenha autorizado.
Qual agente de IA devo usar?
Use o que você já conhece. Claude, ChatGPT, Grok, Cursor, Codex, OpenClaw e Hermes se conectam todos ao mesmo servidor MCP do Spaces, e as respostas dependem mais das notas que você passa ao agente do que de qual você escolhe.
Posso continuar usando o WhatsApp no celular?
Sim. Com uma conexão por QR code, seu celular continua funcionando normalmente, e o agente responde nas mesmas conversas que você vê.
O agente pode enviar promoções para minha lista de clientes?
Não. Os Termos do Spaces proíbem mensagens em massa não solicitadas, e ele recusa o mesmo texto frio enviado para muitas pessoas. A Business Platform existe justamente para disparos de modelos para listas grandes com consentimento.
Mais artigos
Este artigo foi traduzido automaticamente. Ler este artigo em inglês