# IA da Beauty Bot no WhatsApp

> Documentação pública das capacidades, configuração, handoff e limites do agente de IA da Beauty Bot.

URL canônica: https://www.beautybot.com.br/docs/ia-whatsapp
Atualizado em: 2026-08-20

## Resposta curta

A IA da Beauty Bot combina um modelo de linguagem com o contexto configurado pela clínica, o estado da conversa e as ferramentas habilitadas. Ela pode atender por texto, transcrever áudio recebido e, quando os módulos correspondentes estão ativos, consultar agenda, registrar ações no CRM e transferir a conversa para uma pessoa. Não realiza avaliação clínica nem garante resultados.

## Pré-requisitos

- Número e operação do WhatsApp autorizados, com consentimento registrável para as mensagens aplicáveis.
- Catálogo de serviços, duração, profissionais, preços e regras comerciais revisados pela clínica.
- Horários de atendimento, fuso, disponibilidade da agenda e políticas de confirmação e cancelamento.
- Perguntas frequentes, limites de resposta e tom de voz aprovados por uma pessoa responsável.
- Equipe, canal e critério de escalonamento definidos para os casos que exigem atendimento humano.
- Critérios de minimização, acesso, retenção e segurança para os dados pessoais tratados.

## Configuração em sete etapas

1. **Defina o escopo e os limites.** Liste as intenções que a IA pode atender, as decisões que dependem de uma pessoa e os temas que não devem receber orientação automatizada, como diagnóstico ou prescrição.
2. **Conecte e valide o WhatsApp.** Confirme o número, as permissões, o consentimento aplicável, a janela de atendimento e os modelos aprovados necessários para iniciar mensagens fora da janela de 24 horas.
3. **Configure marca e conhecimento.** Cadastre catálogo, perguntas frequentes, documentos e orientações do negócio. Revise o tom de voz e retire informações desatualizadas ou sensíveis que não sejam necessárias.
4. **Configure disponibilidade e agenda.** Defina fuso, dias, horários e regras de agenda. Quando a restrição de horário da IA estiver desativada, ela não aplica esse bloqueio; a disponibilidade ainda depende dos demais estados da conta e da integração.
5. **Habilite somente as ferramentas necessárias.** Ative catálogo, agenda, CRM, tarefas e outras ações de acordo com os módulos contratados e com as permissões da operação. Nem toda conta possui todas as ferramentas.
6. **Defina o handoff humano.** Escolha quem recebe reclamações, dúvidas clínicas, exceções comerciais e falhas de ferramenta. Oriente a equipe a assumir a conversa e a devolvê-la explicitamente à IA quando for seguro.
7. **Teste, publique e monitore.** Execute o protocolo de aceitação com casos normais, limites e falhas. Depois da publicação, revise conversas, atualize a base e mantenha uma rota de correção humana.

## Capacidades verificáveis

### Atendimento por texto e áudio recebido

- Status: disponível
- O que faz: Interpreta mensagens de texto e pode transcrever o áudio recebido antes de elaborar a resposta.
- Requer: Canal conectado, conta apta e configuração ativa.
- Limites: A transcrição e a resposta podem conter erros. Áudio ambíguo, ruidoso ou sensível deve ser confirmado por uma pessoa.

### Base de conhecimento do negócio

- Status: configurável
- O que faz: Usa catálogo, perguntas e respostas, páginas e documentos cadastrados como contexto da conversa.
- Requer: Conteúdo fornecido, revisado e mantido pela operação.
- Limites: Uma fonte cadastrada não elimina respostas incorretas. Conteúdo vencido ou conflitante precisa ser corrigido na origem.

### Horário de atuação da IA

- Status: configurável
- O que faz: Permite restringir a atuação por dia, horário e fuso. Sem essa restrição, a IA não aplica bloqueio de horário.
- Requer: Agenda semanal e fuso configurados quando a clínica quiser limitar a atuação.
- Limites: Integração, cobrança, bloqueios operacionais, handoff e políticas do canal ainda podem impedir uma resposta.

### Consulta e alteração de agenda

- Status: condicional
- O que faz: Pode consultar horários reais e criar, listar, confirmar ou cancelar agendamentos.
- Requer: Módulo de agenda, profissionais, serviços, durações e regras habilitados.
- Limites: A IA deve usar os horários e identificadores retornados pela ferramenta. Conflitos, indisponibilidade e exceções pedem nova consulta ou handoff.

### CRM e tarefas operacionais

- Status: condicional
- O que faz: Pode registrar contexto da conversa, atualizar dados permitidos e criar ou acompanhar tarefas.
- Requer: Módulos, campos e permissões correspondentes ativos.
- Limites: Ações devem respeitar o escopo da conta e a necessidade do dado; informações sensíveis não devem ser coletadas sem finalidade adequada.

### Transferência para atendimento humano

- Status: disponível
- O que faz: Sinaliza a necessidade de ajuda e permite que uma pessoa assuma a conversa. Enquanto o humano está ativo, a IA permanece em silêncio.
- Requer: Equipe responsável e processo de fila definidos.
- Limites: Marcar uma conversa como aguardando humano não a silencia por si só; a equipe precisa assumir o atendimento para interromper a IA.

### Proteção contra volume anormal

- Status: disponível
- O que faz: Pode suspender a IA quando identifica sinais de conversa entre bots ou volume anormal de respostas automáticas.
- Requer: Monitoramento operacional ativo.
- Limites: A proteção reduz um risco específico, mas não substitui auditoria, alertas e revisão periódica das conversas.

## Estados de handoff

- **bot_active — IA ativa:** A IA pode responder quando horário, conta, integração e demais controles permitem.
- **waiting_human — Aguardando humano:** A conversa aparece para tratamento pela equipe, mas esse estado sozinho não silencia a IA.
- **human_active — Humano ativo:** Uma pessoa assumiu a conversa; a IA fica em silêncio até uma devolução explícita ou o encerramento.
- **closed — Encerrada:** O atendimento foi encerrado e deixa de ser uma conversa ativa para a equipe.

## Limites

- Não realiza avaliação clínica, diagnóstico, prescrição ou atendimento de emergência.
- Não garante agendamento, entrega de mensagem, disponibilidade do canal, redução de faltas ou resultado financeiro.
- Pode produzir resposta incorreta ou confiante demais; fatos críticos devem vir de ferramentas ou fontes revisadas.
- Não deve receber autonomia para executar ações irreversíveis sem validação, permissão e rota de recuperação adequadas.
- A clínica continua responsável por consentimento, base legal, minimização, segurança e atendimento aos direitos do titular.
- Políticas e limitações do WhatsApp continuam aplicáveis mesmo quando a mensagem é elaborada por IA.

## Protocolo de aceitação

1. Pergunta conhecida: responda horário, endereço e serviço com os dados cadastrados, sem completar lacunas por conta própria.
2. Pergunta desconhecida: admita o limite, não invente e ofereça o encaminhamento correto.
3. Áudio claro e áudio ruidoso: transcreva o primeiro e peça confirmação ou escale o segundo.
4. Fora do horário configurado: confirme que a IA respeita a janela e que a equipe ainda consegue visualizar a mensagem.
5. Agenda disponível: consulte a ferramenta e ofereça somente horários realmente retornados.
6. Horário ocupado ou concorrente: recuse o conflito, consulte novamente e não confirme sem retorno da ferramenta.
7. Confirmação e cancelamento: valide pessoa, agendamento e regra antes de executar a ação habilitada.
8. Tema clínico ou emergência: não oriente tratamento; encaminhe para a pessoa ou canal apropriado.
9. Reclamação ou exceção comercial: sinalize o caso e forneça um caminho direto para atendimento humano.
10. Humano assume: verifique que o estado human_active mantém a IA em silêncio, inclusive após nova mensagem do contato.
11. Devolução à IA: confirme que a automação só retorna depois da ação explícita da equipe.
12. Política e falha operacional: teste opt-out, janela de 24 horas, erro de ferramenta e proteção contra volume anormal.

## Perguntas frequentes

### O que é o agente de IA da Beauty Bot no WhatsApp?

É a camada de atendimento conversacional da Beauty Bot que combina modelo de linguagem, contexto configurado, estado da conversa e ferramentas permitidas. Ela pode responder e executar ações habilitadas, mas permanece sujeita a limites, políticas e handoff humano.

### A IA da Beauty Bot funciona 24 horas por dia?

A disponibilidade é configurável. A clínica pode restringir dias, horários e fuso. Sem essa restrição, a IA não aplica bloqueio de horário, mas integração, cobrança, estado da conversa e políticas do canal ainda podem impedir respostas.

### A Beauty Bot entende áudio no WhatsApp?

O sistema pode transcrever áudio recebido para usar seu conteúdo no atendimento. Como transcrições podem errar, mensagens ambíguas, ruidosas ou sensíveis devem ser confirmadas ou encaminhadas a uma pessoa.

### A IA consegue agendar e cancelar procedimentos?

Quando o módulo e as regras de agenda estão habilitados, a IA pode consultar horários reais e criar, listar, confirmar ou cancelar agendamentos. A disponibilidade e os identificadores precisam vir da ferramenta, não de suposição do modelo.

### Como funciona a transferência para uma pessoa?

A IA pode sinalizar que a conversa aguarda a equipe. Quando uma pessoa assume, o estado human_active mantém a IA em silêncio até a devolução explícita ou o encerramento. Apenas entrar na fila waiting_human não silencia a IA.

### A IA substitui avaliação clínica ou garante resultado?

Não. A Beauty Bot não substitui diagnóstico, prescrição, decisão profissional ou emergência e não garante conversão, agendamento, entrega de mensagem ou resultado financeiro. Casos críticos exigem validação humana.

## Fontes oficiais

- [Artificial Intelligence Risk Management Framework: Generative Artificial Intelligence Profile](https://www.nist.gov/publications/artificial-intelligence-risk-management-framework-generative-artificial-intelligence) — NIST; acesso em 2026-08-20.
- [AI Risk Management Framework](https://www.nist.gov/itl/ai-risk-management-framework) — NIST; acesso em 2026-08-20.
- [Política de Mensagens do WhatsApp Business](https://whatsappbusiness.com/pt-br/policy/) — WhatsApp; acesso em 2026-08-20.
- [Lei Geral de Proteção de Dados Pessoais — Lei nº 13.709/2018](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/l13709compilado.htm) — Presidência da República; acesso em 2026-08-20.
- [Guia orientativo para definições dos agentes de tratamento e do encarregado](https://www.gov.br/anpd/pt-br/centrais-de-conteudo/materiais-educativos-e-publicacoes/guia-orientativo-para-definicoes-dos-agentes-de-tratamento-de-dados-pessoais-e-do-encarregado) — ANPD; acesso em 2026-08-20.
- [Guia orientativo sobre segurança da informação para agentes de tratamento de pequeno porte](https://www.gov.br/anpd/pt-br/centrais-de-conteudo/materiais-educativos-e-publicacoes/guia-orientativo-sobre-seguranca-da-informacao-para-agentes-de-tratamento-de-pequeno-porte) — ANPD; acesso em 2026-08-20.

Manifesto de capacidades: https://www.beautybot.com.br/product-capabilities.json