Atendente virtual de WhatsApp com IA

O atendente virtual é uma skill que você instala no seu agente de IA (Claude Code, Claude Desktop, Codex ou Antigravity). Ela usa o servidor MCP do Turbo Notify para ler as mensagens que os clientes mandam ao número da empresa e responder, com o que você ensinou sobre o negócio.

Este guia é para quem tem uma empresa que vende produtos ou serviços e quer atender, tirar dúvidas e encaminhar vendas pelo WhatsApp sem escrever código.

Quem faz o quê

Papel	Quem é	O que faz
Atendente virtual	A IA	Responde os clientes, guarda o que cada um já contou e chama uma pessoa quando precisa.
Atendente	Uma pessoa da equipe com o celular do número conectado (ou o WhatsApp Web dele)	Acompanha as conversas, aprova ou corrige as respostas e assume uma conversa quando quiser. Não precisa de cadastro.
Administrador	Um número cadastrado	Ensina o negócio, pausa, apaga dados de um cliente e muda o modo. Escreve para o número da empresa, de outro celular.
Quem configurou	A pessoa que instalou a skill no agente	Faz a configuração inicial e decide quem é administrador.
Contato	O cliente	Só conversa. Nunca consegue ver dados de outro cliente nem dar ordens ao atendente virtual.

Numa empresa de uma pessoa só, a mesma pessoa costuma ser quem configurou, administrador e atendente.

Cadastre como administrador um número que não seja o número conectado. O celular do número conectado é o do atendente, e separar os dois evita que quem só atende também apague dados ou mude regras. Se você cadastrar o próprio número conectado, a skill avisa e a decisão final é sua.

Antes de começar

O número principal conectado, como no Começo rápido, ou um número extra.
O servidor MCP conectado ao seu agente: entre com a sua conta (o plugin o declara) no modo assistido, ou use a chave do template Agente de IA (MCP) no runner. Veja Servidor MCP: Conexão.
Python 3.9 ou mais novo no computador onde o agente roda. Sem ele a skill funciona em modo manual, só com aprovação de uma pessoa, e avisa antes de começar.
Cada resposta do atendente virtual consome a cota de mensagens do número, como qualquer envio. Veja Cota e uso.

1. Instale a skill

Escolha o seu agente:

Claude Code

claude plugin marketplace add turbo-notify/agent-skills#v1
claude plugin install turbo-notify@turbo-notify

Claude Desktop e Cowork: em Customize, aba Plugins, clique em Add, Add marketplace, Add from a repository e informe turbo-notify/agent-skills. Depois, em Discover, escolha turbo-notify e clique em Add. No Cowork, use uma pasta que você escolheu.

Codex

codex plugin marketplace add turbo-notify/agent-skills --ref v1
codex plugin add turbo-notify@turbo-notify

Antigravity

agy plugin install https://github.com/turbo-notify/agent-skills

O código está em turbo-notify/agent-skills (abre em nova aba) , aberto para leitura.

2. Configure conversando

Peça ao agente: “configure o atendente virtual do Turbo Notify”. Ele faz uma pergunta por vez:

O nome da empresa como os clientes conhecem, e o idioma de quem administra (português ou inglês).
Se é só você ou se há administradores (números com DDD).
Qual dos seus números atende os clientes (o principal ou um extra).
O que ensinar sobre o negócio: a empresa, o que vende, preços, perguntas frequentes, políticas, o tom de voz e quando chamar uma pessoa. Para cada assunto ele pergunta se o cliente pode ler ou se é só para a equipe.
Se há outros servidores MCP seus (catálogo, agenda, CRM), como eles devem ser usados. Veja Conecte outros MCPs com segurança.

A configuração termina com um teste: mande “oi” para o número, de um celular que não seja de um administrador cadastrado (um amigo, um segundo chip), e veja o rascunho de resposta chegar. Quem é administrador nunca é tratado como cliente: o que ele escreve vira comando.

3. Comece no modo assistido

O atendente virtual começa no modo assistido: ele prepara a resposta e uma pessoa aprova antes de sair. Recomendamos ficar nele pelo menos a primeira semana. O rascunho chega na conversa do número com ele mesmo (o “Eu” do WhatsApp) e aos administradores.

/enviar 1 envia o rascunho 1.
/enviar 1 texto seu envia o seu texto no lugar.
/modo automático passa a responder sem aprovação. Só um administrador muda o modo, e o modo automático é para o Claude Code ou o Codex com o executor (veja o que cada agente consegue).

Como os clientes são atendidos

Só conversas diretas. Mensagens de grupo são ignoradas.
No idioma do cliente. Ele escreve em português, inglês ou outro idioma e recebe a resposta no mesmo.
Responde como numa conversa. A mensagem nova recebe uma resposta normal, sem citação. O atendente virtual só cita uma mensagem anterior quando a resposta depende dela.
Cada cliente tem a sua memória. A skill guarda a conversa, um resumo dos assuntos anteriores e uma ficha com o que o cliente contou (nome, interesse, preferências). Conversas longas são resumidas sozinhas.
Cada cliente só vê o que é dele. Número, nome e conversa de outro cliente nunca entram numa resposta, e texto que a equipe marcou como interno também não.
Chama uma pessoa quando precisa. Em vez de inventar um preço ou um prazo, avisa o cliente de que alguém da equipe vai continuar e avisa os administradores. Os motivos estão em Quando o atendente virtual chama uma pessoa.
Quem só agradece não recebe resposta. Um “obrigado”, um “ok” ou um 👍 no fim da conversa fica sem resposta e não chama ninguém: a próxima mensagem do cliente é atendida normalmente. Se a mensagem traz uma pergunta ou qualquer outra coisa além do agradecimento (“ok, e o frete?”), ela é respondida como as outras.
Quem pede para parar, para. Um cliente que diz que não quer mais mensagens não recebe mais, até um administrador decidir o contrário.
Nunca finge ser uma pessoa. Se perguntarem, o atendente virtual diz que é um atendente virtual.
Só responde a quem escreveu primeiro.

Quando o atendente virtual chama uma pessoa

O cliente recebe uma mensagem dizendo que alguém da equipe vai continuar, os administradores recebem um aviso com o motivo e o atendente virtual para de responder aquele cliente até alguém usar /retomar. Isso acontece quando:

a resposta não está no que você ensinou e a pergunta é sobre preço, estoque, prazo, promessa, compromisso ou política;
o cliente pede uma pessoa ou está irritado;
o pedido não tem a ver com o seu negócio;
surge um problema de pagamento, um pedido de troca ou de reembolso, uma reclamação ou um assunto jurídico, ou o cliente pede que o atendente virtual prometa ou confirme algo por escrito (ele pode repetir a regra que você escreveu, mas quem decide o caso é uma pessoa);
duas respostas seguidas não ajudaram o cliente;
chega só uma imagem, um áudio, um vídeo ou um arquivo sem texto legível (antes disso, ele pode pedir a pergunta por escrito);
a skill não consegue ler a resposta do modelo de IA, nem depois de pedir de novo uma vez; os administradores recebem o motivo.

Uma pergunta simples sobre uma regra que você escreveu, como o prazo de troca ou as formas de pagamento, é respondida na hora.

Assumir e devolver a conversa

Quando um atendente responde pelo celular do número ou pelo WhatsApp Web, o atendente virtual entende que uma pessoa assumiu e para de responder aquele cliente. Para devolver, o atendente escreve /retomar na conversa do número com ele mesmo. Um administrador também pode devolver. Para que a conversa volte sozinha quando ninguém escreve por um tempo, defina auto_resume_after_minutes (mínimo 5, por exemplo 30) no arquivo memory-policy.json da pasta de dados: o tempo conta a partir da última mensagem de uma pessoa, só vale para conversas assumidas por uma pessoa (não para pausa de administrador nem para cliente que pediu para parar), e os administradores recebem um aviso quando acontece.

Comandos pelo WhatsApp

Os comandos começam com /, em português ou inglês. Administradores escrevem para o número da empresa, de outro celular. Atendentes escrevem na conversa do número com ele mesmo. /ajuda mostra o que cada pessoa pode fazer.

Todos (administradores e atendentes)

Comando	O que faz
`/ajuda`	Lista o que você pode fazer.
`/status`	Última verificação de mensagens, fila, quem espera uma pessoa, modo e versão.
`/fila`	Quem espera uma pessoa e os rascunhos.
`/enviar n [texto]`	Envia o rascunho n, ou o seu texto no lugar.
`/resumo`	Quantos clientes há em cada situação.
`/retomar [n ou número]`	Devolve uma conversa ao atendente virtual.
`/assumir n`	Uma pessoa assume a conversa.
`/cliente x`	A ficha de um cliente.
`/conversa número [n]`	As últimas mensagens de um cliente.
`/nota número texto`	Guarda uma nota sobre um cliente.

Só administradores

Comando	O que faz
`/clientes [filtro]`	A lista de clientes.
`/admins`, `/admin add`, `/admin remover`	Quem administra.
`/ensinar`, `/pronto`, `/publico`, `/interno`	Ensinar algo ao atendente virtual.
`/conhecimento`	O que o atendente virtual sabe.
`/fontes`	Outros sistemas que ele pode consultar.
`/pausar`	Pausa todos os clientes, ou um.
`/esquecer número`	Apaga os dados de um cliente.
`/modo assistido` ou `/modo automático`	Define se as respostas esperam aprovação.
`/idioma pt` ou `/idioma en`	Idioma dos comandos.
`/politica`	Os números da memória (por exemplo, por quantos dias guardar).

Um comando que não dá para desfazer (apagar dados de um cliente, remover um administrador) responde com um código de quatro dígitos. Mande /confirmar com o código em até dez minutos.

Ensinar o negócio pelo WhatsApp

Um administrador manda /ensinar preços, escreve o que quiser em várias mensagens e termina com /pronto. O texto é guardado palavra por palavra e começa como interno. Mande /publico para o cliente poder ler, ou /interno para ficar só com a equipe. Para um cliente específico, /nota número texto guarda uma observação que só vale para ele.

A cada mensagem, o atendente virtual lê sempre os arquivos da empresa, do tom de voz e de quando chamar uma pessoa. Dos outros arquivos públicos, junta até três: os que mais combinam com as palavras da mensagem do cliente e da conversa até ali (“pagar” encontra “pagamento”, “devolver” encontra “troca”). Escreva um assunto por arquivo e, no nome do assunto e no começo do texto, use as palavras que o cliente usaria.

Conecte outros MCPs com segurança

Se você já tem outros servidores MCP, como um catálogo de produtos, uma agenda ou um CRM, o atendente virtual pode usá-los para responder melhor (preço, horário, situação de um pedido). Com o executor, ele trabalha com uma cópia datada do que o outro sistema tinha quando você configurou, e você pede para atualizar a cópia de tempos em tempos. Preço e estoque do momento só são consultados numa sessão aberta. Na configuração, a skill pergunta o que cada um é e você escolhe uma classe:

Classe	Quem pode receber a informação
Pública	Os clientes. Só para fontes de leitura sem dados pessoais de clientes (catálogo, horário de funcionamento).
Interna	A equipe (administradores e atendentes).
Só administradores	Os administradores (por exemplo, financeiro).
Desligada	Ninguém. É o que vale para um servidor que ninguém classificou.

Regras que a skill segue:

Só leitura. Os outros servidores servem para consultar. Tudo o que vai para o cliente sai pelo Turbo Notify.
Dados de um cliente (os pedidos dele, por exemplo) só entram em rascunhos que uma pessoa aprova, nunca em resposta automática.
Antes de sair, toda resposta passa por uma conferência: se tiver número ou nome de outro cliente, texto interno, uma chave de acesso ou um dado pessoal que o cliente não deu, a resposta é bloqueada e vira um chamado para uma pessoa.

Você muda a classificação a qualquer momento com /fontes.

Onde ficam os dados

Tudo fica no computador onde a skill roda, na pasta que você escolheu na configuração (por padrão, ~/.turbo-notify/attendant). O Turbo Notify não recebe cópia. Quem acessa essa pasta vê as conversas, as fichas e o que você ensinou, então proteja o computador com senha e criptografia de disco, e encerre as sessões do WhatsApp Web de quem sair da equipe.

O texto das conversas com os clientes fica guardado por 90 dias e depois é apagado. O resumo das conversas e a ficha do cliente ficam até você usar /esquecer. O prazo (raw_retention_days) está no arquivo memory-policy.json da pasta de dados, e /politica mostra os números atuais.
O cliente pediu para apagar? Use /esquecer número. O apagamento deixa só uma linha de registro (quem pediu, qual número, quando).
A política de privacidade da sua empresa deve dizer que você usa atendimento automatizado.
A primeira resposta de cada conversa avisa o cliente de que vem de uma inteligência artificial, no idioma dele. O aviso volta depois de um dia sem resposta do atendente. Não dá para desligá-lo.

Mantenha a skill em dia

A skill confere a versão cerca de uma vez por hora e avisa os administradores, por mensagem, quando existe uma nova, com o comando certo para o seu agente. Instalando com #v1 (Claude Code) ou --ref v1 (Codex), uma mudança que quebra compatibilidade nunca chega sozinha. Para os comandos de atualização de cada agente, veja Skills para agentes.

O que cada agente consegue

Claude Code e Codex: respondem com o computador ligado e o agente fechado, pelo executor. Aceitam o modo automático e o modo assistido, e mantêm um contexto separado para cada cliente.
Claude Desktop e Cowork: só modo assistido, com você presente. Toda resposta passa por aprovação.
Antigravity: só modo assistido, em uma sessão que você mantém aberta. Toda resposta passa por aprovação.

No Claude Desktop, no Cowork e no Antigravity, nada é respondido enquanto o aplicativo está fechado, e toda resposta passa por aprovação. Se você precisa de atendimento a qualquer hora, use o Claude Code ou o Codex.

O executor é um programa curto da skill, que você deixa rodando no terminal. Ele consulta o Turbo Notify a cada 20 segundos e só chama o modelo de IA quando chega mensagem, então enquanto ninguém escreve não gasta nada do seu plano de IA.

Limites e cuidados

O computador precisa estar ligado e conectado. Mensagens que chegam enquanto ele está desligado são lidas na volta, se estiverem dentro da retenção do seu plano (1 hora por padrão em todos os planos). Reinicie depressa. Veja Retenção.
O atendente virtual segue os mesmos limites do envio: ritmo entre mensagens, cota do plano e proteções do número. Veja Proteja o seu número.
Revise as respostas no modo assistido antes de passar para o automático, e volte para o assistido se algo mudar na empresa.

Próximos passos

Skills para agentes: o que é uma skill, como instalar e atualizar.
Construa um agente de IA: o caminho com código, para quem quer montar o próprio agente.
Servidor MCP: as ferramentas, os escopos e os limites.