Documentação do produto
Como funciona a IA da Beauty Bot no WhatsApp
Referência pública para configurar, testar e supervisionar o agente de IA sem confundir capacidade técnica com promessa de resultado.
Revisado em
Pré-requisitos
Revise estes itens antes de permitir atendimento automático.
- 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
A publicação deve acontecer somente depois de escopo, dados, ferramentas e handoff terem sido testados.
- 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
Disponível não significa universal: conta, integração, módulos, permissões e configuração alteram o que pode ser executado.
Atendimento por texto e áudio recebido
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
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
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
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
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
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
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 e transferência para uma pessoa
O estado human_active é a trava que mantém a IA em silêncio. A fila waiting_human tem outro papel.
| Estado | Nome no painel | Comportamento |
|---|---|---|
| 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 que devem permanecer explícitos
- 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: 12 testes
Execute os testes com a configuração real da clínica e registre entrada, saída esperada, resultado e responsável pela correçã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 e formatos
A descrição das capacidades foi confrontada com o produto. Os limites regulatórios e de risco usam as fontes primárias abaixo. Esta página também está disponível em Markdown e como manifesto JSON.
- Artificial Intelligence Risk Management Framework: Generative Artificial Intelligence Profile — NIST; conferida em 2026-08-20.
- AI Risk Management Framework — NIST; conferida em 2026-08-20.
- Política de Mensagens do WhatsApp Business — WhatsApp; conferida em 2026-08-20.
- Lei Geral de Proteção de Dados Pessoais — Lei nº 13.709/2018 — Presidência da República; conferida em 2026-08-20.
- Guia orientativo para definições dos agentes de tratamento e do encarregado — ANPD; conferida em 2026-08-20.
- Guia orientativo sobre segurança da informação para agentes de tratamento de pequeno porte — ANPD; conferida em 2026-08-20.