como podemos ajudar?

visão geral

A Zoey AI é uma plataforma que conecta suas lojas online (Braip, Yampi) ao WhatsApp para automatizar atendimento e recuperação de vendas usando inteligência artificial.

como funciona

1. Você conecta sua loja (Braip ou Yampi) para receber as vendas automaticamente
2. Conecta o WhatsApp via QR Code para enviar e receber mensagens
3. Cria cérebros com instruções personalizadas para a IA
4. Cria agentes que ligam um cérebro a uma instância do WhatsApp
5. Configura automações que disparam mensagens automaticamente baseado em eventos de vendas

criar conta

A Zoey AI usa autenticação via Google. Basta clicar em "Entrar com Google" na tela de login. Sua conta é criada automaticamente no primeiro acesso.

whatsapp

A conexão com o WhatsApp é feita através da Evolution API. Cada instância representa um número de WhatsApp conectado.

conectar um número

reconectar instância

Se a instância mostrar status desconectado, clique no ícone de reconexão (🔄) no card da instância. Um novo QR Code será gerado para você escanear.

excluir instância

Clique no ícone de lixeira no card da instância. A instância será removida e o número desvinculado.

lojas (braip / yampi)

Conecte sua plataforma de vendas para a Zoey receber notificações de novas vendas automaticamente.

conectar braip

conectar yampi

provedores de ia

A Zoey suporta 3 provedores de IA. Você precisa configurar pelo menos um para que os cérebros funcionem.

provedores disponíveis

• Claude (Anthropic) — modelos: claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5
• ChatGPT (OpenAI) — modelos: gpt-4o, gpt-4o-mini, gpt-4-turbo
• Gemini (Google) — modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.0-flash

como configurar

cérebros

Um cérebro é a personalidade e conhecimento da IA. Ele define como a IA se comporta, o que sabe e como responde.

campos de um cérebro

• nome — identificação do cérebro (ex: "Suporte Vendas")
• especialidade / descrição — resumo do que o cérebro faz
• avatar — emoji para identificação visual
• provedor de ia — qual IA será usada (Claude, ChatGPT ou Gemini)
• prompt do sistema — instrução detalhada que define o comportamento da IA
• acesso interno — se ativado, o cérebro terá acesso aos dados de vendas da empresa
• categoria interna — classifica o cérebro (vendas, financeiro, operacional, rh, geral)

assistente de criação de cérebro

Ao criar um novo cérebro, você pode usar o assistente inteligente que guia a criação do prompt do sistema passo a passo através de perguntas.

cérebro do dashboard

Você pode marcar um cérebro como ☆ dashboard para que ele apareça no chat do dashboard principal, permitindo conversas rápidas.

agentes

Um agente conecta um (ou mais) cérebros a uma instância do WhatsApp. É o agente que faz o atendimento automático.

criar agente

status do agente

• ativo — instância conectada e funcionando
• desconectado — instância perdeu conexão (reconecte o WhatsApp)
• inativo — agente desativado manualmente

automações (disparos rápidos)

As automações enviam mensagens automaticamente quando ocorre um evento de venda (ex: boleto gerado, compra aprovada, pedido cancelado).

como funciona

1. Uma venda chega via webhook da loja (Braip/Yampi)
2. A automação verifica se o evento bate com a regra configurada
3. Se bater, agenda o envio da mensagem (com delay se configurado)
4. No horário agendado, o agente envia a mensagem personalizada via WhatsApp

campos da automação

• nome — identificação da automação
• evento — qual status de venda dispara (pendente, aprovado, cancelado, reembolso, transporte)
• forma de pagamento — filtro opcional (boleto, pix, cartão)
• agente — qual agente enviará a mensagem
• cérebro — qual cérebro gerará a resposta
• delay (minutos) — tempo de espera antes do envio (0 = imediato)
• horário permitido — janela de horário para envio (ex: 8h às 20h)
• instrução adicional — prompt extra para personalizar a mensagem deste disparo

sequências agendadas

As sequências são automações em múltiplos passos que enviam mensagens ao longo de vários dias.

exemplo de uso

Recuperação de boleto pendente:

• Dia 0 — "Olá! Vi que seu boleto foi gerado, posso ajudar?"
• Dia 1 — "Lembrete amigável sobre seu pedido pendente"
• Dia 3 — "Última chance! Seu boleto vence em breve"

campos da sequência

• evento disparador — qual status de venda inicia a sequência
• objetivo — recuperar venda, follow-up, revenda, etc.
• passos — lista de mensagens com delay em dias entre cada uma
• horário permitido — janela de envio para todos os passos

dashboard

O dashboard é a página inicial e mostra um resumo das suas vendas com estatísticas e as vendas mais recentes.

estatísticas exibidas

• total em vendas — soma dos pedidos aprovados
• pedidos aprovados, pendentes, cancelados — contagem por status
• últimas vendas — tabela com as vendas mais recentes

chat do dashboard

Se um cérebro estiver configurado como ☆ dashboard, um chat aparecerá para perguntas rápidas sobre vendas, clientes e métricas.

vendas

A página de vendas exibe todas as vendas recebidas dos webhooks. Você pode filtrar, buscar e excluir vendas.

informações da venda

• nome e telefone do cliente
• produto e plano
• valor e forma de pagamento
• status (aprovado, pendente, cancelado, reembolso, chargeback)
• data de recebimento

conversas

Visualize todas as conversas do WhatsApp em tempo real. Veja as mensagens trocadas entre a IA e os clientes.

funcionalidades

• lista de conversas — com busca por telefone ou agente
• histórico completo — mensagens do cliente e respostas da IA
• envio manual — envie mensagens manualmente através da interface
• atualização automática — novas mensagens aparecem a cada 10 segundos

equipe de ia

O módulo de equipe permite conversar com múltiplos cérebros ao mesmo tempo. Cada cérebro responde com sua especialidade.

como usar

histórico de conversas

Todas as conversas são salvas. Use a barra lateral esquerda para acessar chats anteriores ou criar uma nova conversa.

tarefas

A página de tarefas mostra todos os envios agendados pelas automações e sequências.

status das tarefas

• pendente — aguardando horário de envio
• processando — sendo enviada agora
• enviado — mensagem entregue com sucesso
• erro — falha no envio (verifique detalhes)
• ignorado — pulada (fora do horário, duplicada, etc.)
• cancelado — cancelada manualmente

Clique em uma tarefa para ver os detalhes completos, incluindo a mensagem enviada e possíveis erros.

modo claro / escuro

A Zoey suporta dois temas visuais:

• modo escuro — o padrão, com fundo preto e acentos laranja
• modo claro — fundo branco com as mesmas cores de destaque

Para alternar, clique no ícone de sol/lua no topo da barra lateral.

perguntas frequentes

a ia não está respondendo no whatsapp

• Verifique se a instância do WhatsApp está com status conectado
• Verifique se o agente está ativo e vinculado à instância correta
• Confirme que o cérebro tem um provedor de IA configurado em Integrações
• Verifique se a API Key do provedor é válida

as vendas não estão chegando

• Confirme que a URL do webhook foi cadastrada corretamente no painel da loja
• Verifique se a loja está com status ativo na página de Integrações
• Faça uma compra de teste para verificar

a automação não disparou

• Verifique se a automação está ativada
• Confirme se o evento da venda corresponde ao configurado (ex: pendente, aprovado)
• Verifique o horário permitido — mensagens fora da janela são adiadas
• Veja a página de Tarefas para verificar o status do envio

o qr code expirou

QR Codes têm validade limitada. Feche o modal e clique em reconectar para gerar um novo.

como trocar o provedor de ia de um cérebro

Edite o cérebro em Cérebros → altere o campo "provedor de ia" e salve.

posso usar mais de um número de whatsapp?

Sim! Crie múltiplas instâncias na página de WhatsApp. Cada agente pode ser vinculado a uma instância diferente.