Conecte o WhAIgent com sua loja atacadista
Atenda consultas de WhatsApp com a informação do seu negócio e do seu catálogo, organize cada oportunidade em um CRM e passe a conversa para uma pessoa quando o caso pedir. O WhAIgent é uma plataforma externa que se conecta à sua loja com um token de leitura.
O que você ganha com a integração
- Respostas com contexto: o assistente usa a informação que o negócio carrega e o catálogo sincronizado da sua loja.
- Consultas mais seguras: para informar preço de tabela e estoque, o WhAIgent exige o código exato do produto e consulta o valor que a loja devolve naquele momento.
- Prospects organizados: ao atualizar clientes já vinculados, o WhAIgent preserva notas, status, etapas e responsáveis locais; as coincidências ambíguas são informadas como conflito.
- Controle humano: um vendedor pode intervir, enviar uma mensagem manual e manter a IA pausada enquanto cuida do caso.
- Acompanhamento comercial: cada oportunidade é classificada por status, etapa, etiqueta, origem e vendedor.
- Operação separada por negócio: cada loja mantém suas próprias conexões, conhecimento, conversas, prospects e permissões.
Esses benefícios dependem da configuração do negócio, da disponibilidade das plataformas conectadas e do uso que a equipe fizer. A integração organiza e acelera tarefas, mas não garante tráfego, vendas nem conversões.
O que é o WhAIgent?
O WhAIgent centraliza o trabalho comercial que começa no WhatsApp. O cliente conversa com um assistente configurado para o negócio; o sistema guarda o histórico, registra ou vincula o prospect e permite que a equipe continue o atendimento dentro da mesma operação.
Não é apenas um bot de respostas: reúne IA, controle humano, prospects, vendedores, campanhas, acompanhamentos, base de conhecimento e métricas em um só lugar. A equipe mantém a decisão sobre quando a IA intervém, que informação pode usar e que ações exigem atenção humana.
O que o WhAIgent pode fazer
💬 Atender conversas de WhatsApp
- Receber e responder mensagens de texto.
- Receber áudios, transcrevê-los e processar a consulta como texto.
- Receber imagens junto com sua descrição ou legenda, e pedir uma explicação por texto quando a imagem chega sem contexto suficiente.
- Guardar o histórico e o status de cada conversa.
- Pausar ou reativar o assistente e enviar mensagens manuais pela caixa de entrada.
- Encaminhar um caso e tentar notificar a pessoa configurada por meio de um template aprovado pela Meta.
⚠️ O WhAIgent não interpreta visualmente o conteúdo de uma imagem. Se o cliente precisa consultar algo que só aparece na foto, tem que descrever por texto.
📚 Responder com informação própria do negócio
- Usar um prompt e instruções definidos para a marca, com tom e idioma próprios.
- Consultar documentos carregados na base de conhecimento e buscar conteúdo relevante por busca semântica.
- Usar o catálogo sincronizado da sua loja.
- Consultar a web aberta ou limitar a busca a sites autorizados.
- Testar respostas em um sandbox antes de usá-las em uma conversa real.
A base de conhecimento aceita perguntas frequentes, políticas, fichas de produto, processos de compra e documentação institucional. Não carregue ali senhas, tokens nem informação que um cliente não deva receber.
🗂️ Organizar prospects e oportunidades
- Criar, consultar, editar e excluir prospects, com campos obrigatórios e opcionais definidos pelo negócio.
- Capturar dados durante a conversa, de forma antecipada ou no fechamento.
- Trabalhar em visão de tabela ou Kanban, com status e etapas comerciais independentes.
- Adicionar notas, origem e etiquetas; buscar, filtrar e exportar informação.
- Importar bases por CSV.
- Atribuir vendedores de forma individual ou em massa e distribuir oportunidades disponíveis entre os vendedores ativos.
👥 Trabalhar em equipe
- Proprietário: administra o negócio e sua equipe.
- Manager: configura e opera os módulos administrativos habilitados. É o papel que conecta a integração.
- Vendedor: trabalha com os prospects e as conversas do seu escopo. Não configura conexões, integrações, campanhas, métricas nem ajustes gerais.
📣 Campanhas, acompanhamentos e métricas
- Preparar campanhas de WhatsApp com templates aprovados pela Meta, segmentando audiências a partir do CRM e verificando destinatários antes do envio.
- Enviar campanhas por email quando o negócio tem SMTP configurado, e programar acompanhamentos de WhatsApp ou email conforme status e atraso.
- Revisar conversas e status de atendimento, analisar o pipeline e as origens de prospects, e comparar a atividade dos vendedores.
- Consultar custos de mensageria quando a Meta os informa, com estimativas identificadas como tais quando o valor exato não está disponível.
⚠️ Uma pessoa importada ao CRM não fica automaticamente habilitada a receber marketing: o negócio deve ter uma base válida de consentimento e respeitar as regras de WhatsApp, email e proteção de dados aplicáveis. O faturamento definitivo do WhatsApp é consultado na Meta; uma estimativa dentro do WhAIgent não substitui a fatura do fornecedor.
Como funciona a integração com sua loja
A integração inicial é de leitura. Cada negócio conecta a sua própria loja com um token individual. O WhAIgent não envia essa credencial a outros fornecedores e não a exibe novamente depois de salvá-la.
- Catálogo: o WhAIgent copia e indexa a informação autorizada dos produtos visíveis para poder encontrá-los. Quando o cliente envia um código exato, consulta preço de tabela e estoque atual na sua loja.
- Clientes: o manager pode importar clientes ao CRM e revisar quantos registros foram criados, atualizados, ignorados ou ficaram em conflito.
A integração não cria pedidos, não modifica estoque e não escreve informação comercial dentro da loja.
Como o assistente responde sobre produtos
O fluxo foi desenhado para evitar que um nome parecido acabe mostrando o preço ou o estoque do produto errado.
1. Consulta por nome
Se o cliente pergunta, por exemplo, por “camiseta preta”, o WhAIgent busca coincidências no catálogo sincronizado e propõe nomes e códigos. Nessa etapa não confirma preço nem disponibilidade.
2. Confirmação por código
Para consultar preço e estoque, o cliente precisa escrever o código ou SKU exato e completo na mensagem atual. Só então o WhAIgent faz a consulta ao vivo e responde com a moeda confirmada pelo negócio, o preço de tabela geral e o estoque informado pela loja para o produto ou suas variações.
Preços especiais, descontos personalizados e condições finais são confirmados com um vendedor. Mostrar estoque não implica reservá-lo.
3. Se a consulta falha
Se a loja não está disponível, o código não coincide ou a resposta não pode ser validada, o WhAIgent não inventa nem substitui o dado por informação de outra fonte: informa que não pôde confirmá-lo e orienta o cliente a um vendedor.
Antes de começar
- Um negócio ativo no WhAIgent, com acesso de proprietário ou manager.
- Uma loja ativa na VendasxAtacado com acesso de administrador.
- Um token próprio dessa loja, gerado em Configuração → ERP do painel.
- A moeda real que a loja usa para os preços, confirmada.
- A decisão sobre se o WhAIgent fica autorizado a mostrar preços de tabela gerais.
⚠️ Nunca envie o token por WhatsApp, email, tickets nem documentação. Ele é copiado diretamente do painel da sua loja para o formulário protegido do WhAIgent.
Passo a passo: conectar o WhAIgent
Passo 1 — Obter o token da loja
- Entre no painel de administração da sua loja com um usuário administrador. Os tokens e o console vivem no painel, não na loja pública.
- Abra Configuração → ERP e gere o token Bearer do negócio. É um token por negócio: confira que seja o da loja que vai conectar.
- O token não vence por tempo: é invalidado quando você gera um novo. Se suspeitar que vazou, gire-o e o anterior para de funcionar. Cada token leva seu próprio limite de frequência.
- Nessa mesma tela há um console de API para testar chamadas reais antes de conectar qualquer coisa.
Passo 2 — Abrir a integração no WhAIgent
Entre no WhAIgent, selecione o negócio correto e abra Funções → Integrações → Ventas x Mayor. A conexão se aplica apenas ao negócio selecionado: confira o nome antes de salvar.
Passo 3 — Configurar a conexão
- Cole o token próprio da loja.
- Selecione a moeda correspondente e confirme-a expressamente.
- Se quiser que o assistente consulte o catálogo, ative a permissão de catálogo e preços gerais.
- Aperte Validar e salvar.
Ao salvar, o WhAIgent faz uma consulta restrita para comprovar que a credencial é válida. A nova credencial só é salva depois de validada: se falhar, não substitui uma configuração válida que já existia.
Passo 4 — Testar a conexão salva
Aperte Testar conexão salva, verifique que a integração aparece como conectada e revise a data da última validação. Se você mudou o token, a moeda ou a permissão de catálogo, salve antes de iniciar uma sincronização.
Passo 5 — Sincronizar o catálogo
- Aperte Sincronizar catálogo e mantenha a aba aberta enquanto a operação avança.
- Se você parar o processo, use Retomar sincronização para continuar do lote pendente.
- Use Descartar carga pendente e reiniciar apenas quando precisar eliminar o progresso e começar de novo.
- Ao finalizar, revise a data da última sincronização e a quantidade de produtos incorporados.
O WhAIgent processa o catálogo em lotes. A versão anterior segue ativa até a nova sincronização terminar, para que uma carga interrompida não deixe um catálogo parcial disponível ao assistente. Convém sincronizar quando o catálogo estiver estável: a sincronização é manual e não é um espelho instantâneo de cada mudança.
Passo 6 — Importar clientes
- Aperte Importar clientes e espere os lotes terminarem.
- Revise os totais de criados, atualizados, ignorados e conflitos.
- Abra o detalhe de conflitos, corrija as identidades duplicadas ou inconsistentes no sistema correspondente e importe novamente. Se não for possível resolver, contate o suporte.
Regras importantes: um cliente já vinculado pelo identificador externo pode ser atualizado; as notas, o vendedor, o status e a etapa administrados no WhAIgent são preservados; uma coincidência ambígua de telefone ou email não é vinculada automaticamente; e importar um cliente não equivale a obter consentimento para campanhas.
Passo 7 — Testar o catálogo pelo WhatsApp
- Pergunte por um produto usando o nome e comprove que o WhAIgent sugere opções e códigos sem confirmar preço nem estoque prematuramente.
- Envie o código exato de um dos produtos e verifique nome, variações, moeda, preço de tabela e estoque contra a loja real.
- Teste um código inexistente: o WhAIgent não deve confirmar valores que não pôde verificar.
- Peça para falar com uma pessoa e verifique que a equipe consegue assumir o controle da conversa.
Passo 8 — Preparar a operação comercial
- Conecte e verifique o número de WhatsApp do negócio.
- Revise o prompt, o tom, o idioma e as regras de encaminhamento.
- Carregue políticas e perguntas frequentes na base de conhecimento.
- Configure campos de prospect, status, etapas e etiquetas, e crie os vendedores com suas permissões.
- Teste o atendimento no sandbox e depois em um chat controlado.
- Defina o processo humano para preços especiais, reservas e fechamento do pedido.
Escopo inicial da integração
✅ Incluído
- Conexão individual por loja, com token criptografado e não visível depois de salvo.
- Validação da conexão e sincronização manual do catálogo.
- Busca de produtos por nome.
- Consulta ao vivo de preço geral e estoque por código exato.
- Importação manual de clientes com revisão de conflitos.
- Desconexão sem apagar os prospects mantidos no WhAIgent.
🚫 Não incluído
- Criar, editar ou cancelar pedidos; adicionar produtos ao carrinho ou concluir o checkout; processar pagamentos.
- Reservar ou modificar estoque.
- Aplicar preços especiais ou listas privadas por cliente.
- Sincronizar o catálogo em tempo real.
- Interpretar visualmente fotos de produtos.
Atribuição comercial: ampliação pendente de validação
O WhAIgent tem implementada uma ampliação para ler periodicamente clientes e pedidos e conectá-los à atribuição comercial. Ainda não faz parte do escopo inicial e será incorporada somente depois de validá-la de ponta a ponta com uma loja e dados reais.
- Ler periodicamente clientes e pedidos, sem escrever na loja.
- Relacionar o contato iniciado a partir de anúncios da Meta com a conversa de WhatsApp.
- Medir o avanço de contato a cadastro e compra quando existe informação vinculável, e marcar como ganho o prospect associado a uma compra.
- Impedir novos acompanhamentos automáticos ou campanhas ao contato depois de uma compra registrada.
- Excluir compras anuladas de faturamento e conversão, sem reativar mensagens comerciais automaticamente.
A consulta periódica é feita em lotes e não é instantânea. Os carrinhos abandonados exigem que a loja ou um adaptador autorizado envie um evento assinado, porque a API administrativa pública não oferece hoje uma listagem de carrinhos abandonados. Para certificar essa etapa são necessárias uma loja de teste, um token real e exemplos reais de clientes e pedidos.
Segurança, permissões e dados
- Cada loja usa seu próprio token: não existe uma credencial global compartilhada entre clientes.
- O token fica criptografado no WhAIgent e não é devolvido ao navegador.
- O token da loja é um token Bearer de negócio, não uma credencial somente leitura: quem se limita a ler é o adaptador do WhAIgent. Trate-o como uma chave completa do negócio e gire-o se vazar.
- A conexão se limita ao negócio selecionado no WhAIgent e só um proprietário ou manager pode configurá-la.
- Os dados de catálogo são tratados como informação, nunca como instruções para a IA.
- Os conflitos de identidade não são resolvidos automaticamente quando há mais de uma coincidência possível, e o consentimento para marketing é administrado separadamente da importação.
Desconectar ou trocar de loja
Antes de desconectar, confirme que selecionou o negócio correto. Ao desconectar a loja: a credencial salva é apagada, o catálogo e o índice próprios da integração são retirados e os vínculos externos que ela usava são eliminados. Os prospects, notas, status, etapas e responsáveis existentes no WhAIgent são preservados, junto com o registro de consentimento ou oposição comercial.
Depois de conectar outra loja, sincronize o catálogo novamente antes de depender das buscas por nome.
Erros frequentes
O token não é autorizado
Gere ou copie um token válido para a loja correta. Se foi girado ou mudou, carregue um novo e valide de novo.
O serviço não está disponível
Espere e tente novamente. Enquanto a consulta não puder ser validada, o WhAIgent não deve confirmar preço nem estoque.
Foi atingido um limite temporário
Cada token tem seu próprio limite de frequência. Pare as novas solicitações e tente depois; não reinicie repetidamente uma sincronização em andamento.
A moeda não está confirmada
Selecione a moeda real, marque a confirmação e salve antes de habilitar o catálogo.
Há mudanças não salvas
Salve token, moeda e permissão de catálogo antes de testar a conexão ou sincronizar.
A sincronização foi interrompida
Use Retomar sincronização para continuar o mesmo processo. Se o catálogo mudou durante a carga ou o sistema informa um conflito, use Descartar carga pendente e reiniciar em um momento estável.
Um cliente ficou em conflito
Verifique se o telefone ou o email coincide com mais de um prospect. Corrija o dado duplicado ou inconsistente e importe novamente; se não for possível resolver, peça ajuda. O WhAIgent não força a vinculação.
Um produto não aparece
Atualize a sincronização e comprove que o produto está visível na sua loja. Depois busque por um nome mais preciso ou envie o código exato.
O preço ou o estoque não pode ser confirmado
Verifique que a mensagem atual inclui o código completo, que o catálogo está habilitado e que a loja responde. Os preços especiais são sempre encaminhados a um vendedor.
Lista de verificação para ativar
- ☐ A loja está identificada e o token pertence a essa loja.
- ☐ O negócio correto está selecionado no WhAIgent.
- ☐ A moeda foi selecionada e confirmada.
- ☐ A permissão de catálogo e preços gerais reflete a decisão do negócio.
- ☐ A conexão salva foi testada e o catálogo terminou de sincronizar.
- ☐ Os conflitos de clientes foram revisados.
- ☐ Foi testada uma busca por nome e um código exato contra dados reais.
- ☐ Foi comprovado que um código inválido não gera informação inventada.
- ☐ A transferência para um vendedor foi verificada.
- ☐ O processo para preços especiais, reservas e pedidos ficou definido.
- ☐ Consentimentos e exclusões de marketing foram revisados.
Perguntas frequentes
O WhAIgent substitui o time comercial?
Não. Automatiza o atendimento e a organização, mas mantém o controle humano e o encaminhamento para os casos que exigem critério, negociação ou fechamento.
Pode responder preço e estoque?
Sim, quando a integração e o catálogo estão habilitados, a moeda está confirmada, o cliente envia o código exato e a loja responde com dados validáveis. Informa preço de tabela geral e o estoque consultado naquele momento.
Pode mostrar o preço especial de um cliente?
Não. Os preços privados e as condições personalizadas são confirmados com um vendedor.
Pode criar um pedido?
Não. A integração inicial é de leitura: o pedido é gerenciado pelo processo comercial ou de compra definido pela loja.
O estoque fica reservado quando o WhAIgent o informa?
Não. A resposta é uma consulta: não reserva nem modifica unidades.
O catálogo é atualizado automaticamente?
A lista usada para buscar por nome é sincronizada manualmente: se mudam produtos, nomes, descrições ou visibilidade, um manager precisa sincronizar de novo. O preço geral e o estoque são consultados ao vivo quando o cliente envia o código exato, então esses valores não dependem de reindexar o catálogo.
O que acontece com os prospects ao desconectar?
São preservados no WhAIgent junto com suas notas, status, etapas e responsáveis. São retirados a credencial, o catálogo e os vínculos específicos da integração.
Importar clientes permite enviar campanhas a eles?
Não por si só. A importação não demonstra consentimento para marketing.
O WhAIgent entende fotos de produtos?
Recebe a imagem e sua legenda, mas não analisa visualmente os pixels. Se falta contexto, pede uma descrição por texto.
Funciona em espanhol, português e inglês?
A interface do WhAIgent inclui espanhol e inglês, e o assistente responde conforme o idioma configurado ou detectado. Convém testar o conteúdo próprio do negócio em cada idioma antes de ativá-lo.
Quem aprova os templates e define os custos do WhatsApp?
A Meta controla a elegibilidade, a aprovação de templates, a entrega e o faturamento. O WhAIgent mostra o status e os dados disponíveis, mas não pode garantir a aprovação nem a entrega.
A integração já está certificada com uma loja real?
A implementação conta com validações e testes técnicos. A certificação de ponta a ponta exige completar o checklist com um token e dados reais de uma loja.
Ativar o WhAIgent
A disponibilidade, as condições comerciais e o acompanhamento para ativar o WhAIgent são coordenados com a equipe do WhAIgent. Do lado da sua loja, nós ajudamos com o token e com a API.