virgginIA no WhatsApp
A virgginIA é a assistente de dados do idworks. Pelo WhatsApp, você manda uma pergunta sobre os dados da sua empresa — por texto ou por áudio — e ela responde ali mesmo, na conversa.
Ela reconhece você pelo número de celular que você mesmo validou em Meu perfil. Para conversar com ela, o número precisa ser do Brasil e estar validado, e o seu usuário precisa estar ativo e liberado na integração Chat WhatsApp (veja Quem pode conversar com a virgginIA pelo WhatsApp?).
Não confunda com as Conversas de WhatsApp: lá a sua equipe atende os seus clientes. Aqui é você conversando com a virgginIA sobre os dados da sua empresa.
Índice
Conceito
- O que é a virgginIA no WhatsApp?
- O que dá para perguntar?
- O que a versão nova da virgginIA faz a mais?
Acesso
- Quem pode conversar com a virgginIA pelo WhatsApp?
- Como validar meu telefone em Meu perfil?
- Como trocar o número ou remover a validação?
- Como liberar um usuário na integração Chat WhatsApp?
- De quais empresas ela mostra os dados?
- O telefone do cadastro ainda vale?
Conversa
Referência rápida
O que é a virgginIA no WhatsApp?
É um número de WhatsApp da idworks com a virgginIA do outro lado. Você escreve (ou grava um áudio) com a sua pergunta, ela consulta os dados das empresas que você tem liberadas e responde na própria conversa.
Assim que a sua mensagem chega, ela aparece como lida e a virgginIA mostra que está digitando.
O mesmo número validado também é o que recebe os relatórios e alertas do dashboard por WhatsApp (veja Dashboards).
📍 Onde: na conversa com o número da virgginIA no seu WhatsApp. Para validar o telefone: menu do seu avatar → Meu perfil.
O que dá para perguntar?
Perguntas sobre os dados das suas empresas, como vendas e pedidos, itens vendidos, produtos, contas a pagar e a receber, compras e anúncios dos marketplaces. Por exemplo: "quanto faturei este mês?" ou "quais os 10 produtos mais vendidos na semana passada?".
Algumas dicas:
- Dê o período e o filtro. Se faltar informação, ela pode perguntar antes de responder.
- Ela diz os filtros que usou — confira se o período e os filtros são os que você queria.
- Um "oi" é só um cumprimento: ela se apresenta e convida você a perguntar.
- Relatório: na versão padrão, se você pedir explicitamente um relatório, ela pode montar uma planilha do Excel e responder com o link para baixar.
- Respostas longas podem chegar resumidas ou cortadas, por causa do limite de tamanho das mensagens do WhatsApp.
A virgginIA é uma IA e pode errar: confira os números importantes nas telas do idworks.
Há duas versões da virgginIA no WhatsApp, e a idworks define qual delas atende cada usuário. Este artigo descreve a versão padrão; a versão nova responde às mesmas perguntas e faz mais coisas (veja O que a versão nova da virgginIA faz a mais?).
O que a versão nova da virgginIA faz a mais?
Se o seu usuário está na versão nova, além de responder perguntas, a virgginIA:
- Lê o que você manda: foto ou print de tela (até 3,5 MB), PDF (até 5 MB) e arquivos XML, CSV ou TXT (até 200 KB). Ela usa o que está no arquivo — número do pedido, chave da nota, mensagem de erro — para responder ou localizar o registro.
- Fecha pedidos e emite NF-e, e faz outras alterações no idworks, sempre a seu pedido. Antes, ela manda um resumo do que vai fazer, com os botões Confirmar e Cancelar. Ela só executa quando você toca em Confirmar ou responde sim (pode, confirmo e ok também valem). O resumo vale por 10 minutos, e qualquer outra mensagem cancela. Em Cancelar, ela responde Cancelado: nada foi executado. Tocar num botão de um resumo antigo não executa nada: ela avisa que esse resumo não vale mais (ou que a ação já foi feita). Se falta permissão ao seu usuário, ela avisa.
- Deixa registrado no pedido o que fez: cada alteração em pedido que você confirma aparece no histórico do pedido — na aba Timeline (Logs) e na tela Log Pedidos — como Ação pela virgginIA, em seu nome. O comentário diz "Feito pela virgginIA (WhatsApp) a pedido de (seu nome), confirmado às HH:MM:", seguido do resumo do que foi feito (por exemplo, Fechar o pedido ou Emitir NF-e — NF-e 123 autorizada). Em algumas alterações, quando o sistema demora para responder, o registro termina com "(o sistema demorou para responder; pode não ter sido concluído)". Consultas, recusas e erros não geram registro.
- Manda arquivos como anexo na conversa: DANFE, XML da nota, etiqueta de envio, guia GNRE e outros.
- Lembra a conversa por 24 horas (na versão padrão, por 10 minutos), então dá para pedir "manda de novo" ou falar "esses pedidos" horas depois.
- Mostra um menu de exemplos: escreva ajuda ou menu (ou mande um oi para começar a conversa) e ela responde com a lista Ver exemplos: Vendas de hoje, Faturamento do mês, Produtos mais vendidos, Itens para repor, Contas a receber, Frete por transportadora, Pedidos em aberto e, para quem tem permissão, DANFE ou XML de nota, Fechar pedidos e Emitir NF-e. Tocar num exemplo manda a pergunta para ela. O menu só mostra o que o seu usuário pode ver e fazer.
- Ensina o passo a passo das telas: para dúvidas como "como emito uma nota de devolução?" ou "onde fica…?", ela busca na Central de Ajuda e responde em passos curtos, com o link do artigo. Se não achar, ela pede para você descrever com outras palavras ou sugere abrir um chamado em Abrir chamado, no menu do seu avatar.
- Responde sobre alertas e relatórios que você recebeu: quando um alerta ou um relatório agendado do dashboard chega pelo número dela, ele fica na conversa. Dá para perguntar em seguida, por exemplo, "quais são esses pedidos?", ou responder citando a mensagem do alerta.
Se ela responde que ainda não lê fotos e documentos, o seu usuário está na versão padrão.
Quem pode conversar com a virgginIA pelo WhatsApp?
A virgginIA só responde quando tudo isto vale ao mesmo tempo:
- Número do Brasil. Ela só atende celulares brasileiros.
- Telefone validado pela própria pessoa em Meu perfil, digitando o código que a idworks manda para o número. O telefone que está só no cadastro do usuário, sem validação, não serve (veja O telefone do cadastro ainda vale?).
- Usuário ativo no idworks.
- Liberado na integração Chat WhatsApp de uma empresa do grupo e ativo na empresa principal desse grupo (ou, se a integração é da própria empresa em que você está ativo, nessa empresa). Veja De quais empresas ela mostra os dados?.
Estar na integração não basta: sem o telefone validado, a virgginIA não sabe quem está escrevendo. E validar o telefone também não basta: sem a integração, ela reconhece você, mas avisa que o seu usuário ainda não está liberado.
Como validar meu telefone em Meu perfil?
Só você pode validar o seu número — quem administra a conta não consegue fazer isso por você.
- Clique no seu avatar e escolha Meu perfil.
- Na parte Telefone, clique no botão que aparece:
- Validar telefone — quando já há um telefone no seu cadastro, ainda Não validado;
- Cadastrar e validar — quando aparece Nenhum telefone cadastrado.;
- Trocar número — quando você já tem um número validado e quer usar outro.
- Em Celular, confira ou digite o seu celular com DDD. Se o telefone do cadastro for um celular, ele já vem preenchido.
- Em Receber o código por, escolha WhatsApp ou SMS e clique em Enviar código. Na primeira vez, WhatsApp já vem marcado; depois de um envio, a tela traz o número e o canal do último envio.
- Digite o código de 6 números no campo Código. A tela confirma sozinha quando você digita o 6º número; se preferir, clique em Verificar. O código vale por 10 minutos.
- Pronto: aparece a mensagem Telefone validado, e o número passa a mostrar Validado em com a data e a hora.
Ao validar, o número também passa a ser o telefone do seu cadastro.
Dica: quando você escolhe WhatsApp, o código chega do mesmo número da virgginIA. Salve esse contato para conversar com ela depois.
Não chegou o código? O botão Reenviar código fica liberado 60 segundos depois do envio (antes disso, ele mostra Reenviar em … s). Para corrigir o número, use Trocar número — o envio para o número novo também respeita a espera de 60 segundos e o limite de códigos pedidos. Se o envio falhar, a espera é liberada na hora e a tela diz Não foi possível enviar o código por WhatsApp para esse número. Confira o número ou tente por SMS (ou Não foi possível enviar o código por SMS para esse número. Confira o número ou tente por WhatsApp) — tente pelo outro canal.
Avisos que podem aparecer:
| Aviso | O que fazer |
|---|---|
| Informe um celular brasileiro com DDD | Só celular do Brasil, com DDD e o 9. Telefone fixo não serve. |
| Este número já está validado | Esse já é o seu número validado: não precisa fazer nada. |
| Código incorreto. Restam … tentativas ou Código incorreto. Resta 1 tentativa | Confira o código e digite de novo. Cada código aceita 5 erros. |
| Código incorreto. Peça um novo código | Foi o 5º erro: esse código não vale mais. Peça outro. |
| Muitas tentativas erradas. Peça um novo código | Você tentou de novo depois dos 5 erros. O código não vale mais: peça outro. |
| O código expirou ou não foi pedido. Peça um novo código | Passaram os 10 minutos. Peça outro código. |
| Aguarde … segundos para pedir outro código | Espere o tempo indicado para reenviar. Vale também para pedir o código para outro número. |
| Muitos códigos pedidos. Tente novamente em alguns minutos | Você pediu códigos demais em pouco tempo (o limite é 3 a cada 15 minutos). |
| Limite de códigos do dia atingido. Tente novamente amanhã | Você chegou ao limite de códigos do dia. O "dia" conta 24 horas a partir do primeiro código pedido, e não o dia do calendário. |
| Limite de códigos do dia para este número atingido. Tente novamente amanhã | Esse número recebeu códigos demais no dia (24 horas a partir do primeiro envio). |
| Não foi possível enviar o código por WhatsApp para esse número. Confira o número ou tente por SMS | O WhatsApp não entregou o código. Confira o número ou peça por SMS — dá para pedir na hora. |
| Não foi possível enviar o código por SMS para esse número. Confira o número ou tente por WhatsApp | O SMS não foi entregue. Confira o número ou peça por WhatsApp — dá para pedir na hora. |
| Validação de telefone indisponível no momento. Tente novamente em instantes ou Não foi possível validar o telefone agora. Tente novamente | Falha temporária. Tente de novo em instantes. |
Mesmo número em dois usuários. Um número só fica validado em um usuário por vez. Se outra pessoa tinha validado esse número antes (um chip que mudou de dono, por exemplo), ao você validar, a validação passa para o seu usuário e a outra pessoa deixa de ser reconhecida pela virgginIA.
📍 Onde: menu do seu avatar → Meu perfil → Telefone.
Como trocar o número ou remover a validação?
- Trocar de número: em Meu perfil, clique em Trocar número e siga os mesmos passos da validação, com o número novo.
- Remover a validação: em Meu perfil, clique em Remover validação e confirme em Remover. O número continua no seu cadastro, mas a virgginIA deixa de reconhecer você no WhatsApp, e os relatórios e alertas do dashboard deixam de chegar por WhatsApp.
Quando quem administra a conta troca o seu telefone. O seu telefone é um só em todas as contas da idworks em que você está cadastrado. Por isso, quem administra uma conta só consegue trocá-lo na tela Usuários se você não tem acesso a nenhuma outra conta além dessa e das filiais dela. Se você tem, o sistema recusa a troca, nada é salvo, e só você altera o número, em Meu perfil (veja O que muda quando o usuário também tem acesso a outra conta?). Quando a troca é possível e ele muda o telefone para um número diferente do que você validou, ou apaga o telefone, a validação é removida — assim que o número no campo é mudado, abaixo do telefone a tela avisa Ao salvar outro número, a validação feita pelo usuário será removida. Depois disso, a virgginIA para de reconhecer você até que você valide o número de novo em Meu perfil. Salvar o cadastro sem mexer no telefone não remove a validação.
Ao editar um usuário na tela Usuários, abaixo do telefone aparece a situação da validação:
- Validado pelo usuário em DD/MM/AAAA. Alterar o número remove a validação. — o telefone do cadastro é o número que a pessoa validou;
- O usuário validou outro número em DD/MM/AAAA. Alterar este número remove a validação. — a pessoa validou um número diferente do que está no cadastro;
- Não validado. O próprio usuário valida em Meu perfil. — a pessoa tem telefone no cadastro e ainda não validou.
Como liberar um usuário na integração Chat WhatsApp?
Quem administra a empresa escolhe a pessoa na integração Chat WhatsApp, no parâmetro Usuário:
- Acesse Configurações → Integrações.
- Se a integração Chat WhatsApp ainda não está em Minhas Integrações, ative-a pelo catálogo (veja Chat WhatsApp).
- Na linha da integração Chat WhatsApp, clique no ícone de engrenagem (Configuração) — ou dê duplo clique na linha.
- No grupo Credenciais de Acesso, escolha a pessoa no parâmetro Usuário e salve.
O parâmetro Usuário guarda uma pessoa por integração: escolher outra pessoa troca quem está liberado, e quem estava lá perde a virgginIA.
Depois de liberada, a pessoa ainda precisa validar o próprio telefone em Meu perfil — isso quem administra não faz por ela.
Também vale para o Chat IA. A mesma integração libera o Chat IA dentro do idworks (veja Chat WhatsApp). Ao liberar ou tirar a pessoa, o Chat IA dela só muda depois que ela sair e entrar de novo no idworks. No Chat IA, vale só a integração ativa da conta em que ela entrou, e não a do grupo.
📍 Onde: menu lateral → Configurações → Integrações → linha da Chat WhatsApp → ícone de engrenagem (Configuração).
De quais empresas ela mostra os dados?
O grupo entra quando você está ativo na empresa principal dele e a integração Chat WhatsApp (ativa) de alguma empresa desse grupo libera você. Aí a virgginIA responde sobre todas as empresas do grupo — inclusive aquelas em que você não tem acesso no idworks. Quem administra deve levar isso em conta ao liberar alguém.
- Ativo só numa filial: se você está ativo só numa filial, e não na empresa principal, o grupo da principal não entra. Se a integração que libera você é da principal, a virgginIA responde que o seu usuário não está liberado. Se a integração é da própria filial, ela responde só sobre essa filial.
- Mais de um grupo: se você passa nessas regras em grupos diferentes, ela responde sobre todos eles.
- Desativado: quem foi desativado na empresa principal do grupo deixa de ver os dados dele, mesmo que continue liberado na integração. O mesmo vale quando a empresa principal está inativa.
Se nenhum grupo passa nessas regras, a virgginIA responde Seu usuário ainda não está liberado para a virgginIA. Peça a quem administra a sua empresa na idworks para incluir você na integração Chat WhatsApp. — mesmo quando o motivo é você estar inativo na empresa principal, a empresa estar inativa ou a integração estar inativa, e não a falta da liberação.
Você não precisa informar código de empresa: o filtro das suas empresas é aplicado sozinho. Se você perguntar por uma empresa que não está entre as liberadas, ela não traz os dados dela.
O telefone do cadastro ainda vale?
Não. O telefone do cadastro do usuário, sem validação, valeu para a virgginIA só até 14/10/2026, como período de transição. Desde 15/10/2026, ela só responde a números validados pela própria pessoa em Meu perfil.
Se você usava a virgginIA antes e ela passou a responder Não encontramos um usuário da idworks com este número validado…, é só validar o seu telefone.
Que mensagens ela entende?
| Você manda | O que acontece |
|---|---|
| Texto | Ela lê como pergunta. |
| Áudio | Ela transcreve o áudio e responde como se fosse texto. Se não der para entender, ela pede para você escrever. |
| Toque em botão de resposta rápida (de uma mensagem que você recebeu, como um alerta ou um relatório agendado) | O texto do botão vale como pergunta. |
| Foto ou documento | Na versão padrão, ela avisa Ainda não leio fotos e documentos por aqui. Escreva sua pergunta ou mande um áudio. Na versão nova, ela lê foto, PDF, XML, CSV e TXT (veja O que a versão nova da virgginIA faz a mais?). |
| Figurinha, vídeo, localização ou contato | Ela avisa que ainda não lê esse tipo de mensagem. |
| Reação (👍 numa mensagem) | Em geral, nada: ela não responde a reações. Na versão nova, um 👍 (ou ✅, 👌, 🆗, ✔) no resumo que aguarda confirmação recebe A reação não confirma a ação. Para confirmar, toque em Confirmar no resumo ou responda sim. Num resumo vencido ou cancelado, nos 30 minutos depois de ele chegar, ela avisa Esse resumo não vale mais: nada foi executado. Se ainda quiser, peça de novo que eu mando um novo resumo. |
Fora esses casos, reação não tem resposta, nem para quem não pode usar a virgginIA. Para os outros tipos, ela confere o número antes de olhar a mensagem: número fora do Brasil ou não validado recebe o aviso de acesso seja qual for a mensagem.
Já a liberação na integração só é conferida depois. Por isso, quem tem o número validado mas não está liberado recebe o aviso de usuário não liberado só quando manda texto, áudio que ela entendeu, toque em botão, foto ou documento. Uma figurinha, por exemplo, recebe o aviso de tipo de mensagem não lido, e um áudio que ela não entendeu recebe o pedido para escrever.
O que significa cada aviso da virgginIA?
Os avisos mais comuns, nas duas versões:
| Aviso | O que significa | O que fazer |
|---|---|---|
| A virgginIA atende apenas números do Brasil. | O número que escreveu não é brasileiro. | Use um celular do Brasil. |
| Não encontramos um usuário da idworks com este número validado. Para usar a virgginIA, valide seu telefone na idworks em Meu perfil (menu do seu avatar). | Nenhum usuário ativo validou esse número. Também aparece se a validação foi removida, se o telefone foi trocado no cadastro ou se o usuário está inativo. | Valide o telefone em Meu perfil. Se o usuário estiver inativo, peça a quem administra a conta. |
| Seu usuário ainda não está liberado para a virgginIA. Peça a quem administra a sua empresa na idworks para incluir você na integração Chat WhatsApp. | Ela reconheceu você, mas nenhum grupo libera você: você não está na integração Chat WhatsApp, não está ativo na empresa principal do grupo, ou a empresa ou a integração está inativa. | Peça a liberação na integração. Se você já está nela, confira se o seu usuário está ativo na empresa principal do grupo (veja De quais empresas ela mostra os dados?). |
| Não consegui entender o áudio. Pode escrever a pergunta? | O áudio não pôde ser transcrito. | Escreva a pergunta ou grave de novo. |
| Ainda não consigo ler esse tipo de mensagem. Escreva sua pergunta ou mande um áudio. | Você mandou figurinha, vídeo, localização, contato ou outro tipo que ela não lê. | Mande texto ou áudio. |
Só na versão padrão:
| Aviso | O que significa | O que fazer |
|---|---|---|
| Ainda não leio fotos e documentos por aqui. Escreva sua pergunta ou mande um áudio. | Você mandou uma foto ou um documento. | Escreva a pergunta ou mande um áudio. |
| Não consegui montar essa consulta dentro das empresas às quais você tem acesso. Tente reformular a pergunta. | Ela não conseguiu montar uma consulta válida para a pergunta dentro das suas empresas. | Reformule: diga o período, o assunto e o filtro com outras palavras. |
| Não consegui consultar os dados agora. Tente de novo em alguns minutos. | A consulta aos dados falhou. | Tente de novo em alguns minutos. |
| Não consegui responder agora. Tente de novo em alguns minutos. | Ela não conseguiu chegar a uma resposta. | Tente de novo em alguns minutos; se persistir, reformule a pergunta. |
Só na versão nova:
| Aviso | O que significa | O que fazer |
|---|---|---|
| A virgginIA está indisponível no momento. Tente de novo em alguns minutos. | Ela está fora do ar ou não conseguiu responder agora. | Tente de novo em alguns minutos. |
| Não consegui concluir essa análise. Tente perguntar de outro jeito, dizendo o período e o que quer ver. | Ela não chegou a uma resposta para a pergunta. | Reformule, com o período e o que quer ver. |
| Não posso ajudar com esse pedido. Posso analisar vendas, pedidos, faturamento, estoque e financeiro da sua empresa. | O pedido está fora do que ela faz. | Pergunte sobre os dados da sua empresa. |
| Não consegui concluir a ação agora. Confira na tela da idworks o que já foi feito antes de tentar de novo. | Uma ação confirmada (fechar pedido, emitir NF-e…) falhou no meio. | Confira na tela do idworks o que já foi feito antes de pedir de novo. |
| Ainda não consigo ler esse tipo de arquivo. Mande uma foto, um PDF ou um XML, ou escreva sua pergunta. | O arquivo não é foto, PDF, XML, CSV nem TXT. | Mande em um desses formatos ou escreva a pergunta. |
| O arquivo é grande demais para eu ler por aqui (até …). Mande uma parte ou escreva o que precisa. | O arquivo passou do limite (3,5 MB para foto, 5 MB para PDF, 200 KB para XML, CSV ou TXT). | Mande um arquivo menor ou escreva o que precisa. |
| Não consegui baixar o arquivo. Pode mandar de novo? ou Não consegui abrir o arquivo. Pode mandar de novo? | O arquivo não chegou inteiro. | Mande de novo. |
| Não consegui ler esse arquivo (pode estar protegido por senha, corrompido ou grande demais). Mande outro arquivo ou escreva o que precisa. | O arquivo chegou, mas ela não conseguiu ler o conteúdo. | Mande outro arquivo (sem senha) ou escreva o que precisa. |
Privilégios
| O quê | Quem pode |
|---|---|
| Meu perfil (validar, trocar ou remover a validação do próprio telefone) | Qualquer usuário logado, só para o próprio número. Não depende de privilégio. |
| Escolher ou trocar o usuário liberado na integração Chat WhatsApp | Quem tem o privilégio Editar parametrizações empresa (para ativar a integração, Criar parametrizações empresa). Veja Chat WhatsApp. |
| Trocar o telefone do cadastro de outro usuário (o que remove a validação dele) | Quem tem o privilégio Editar usuário, desde que a pessoa não tenha acesso a outra conta além da sua e das filiais dela. Se tiver, só ela mesma troca, em Meu perfil (veja Usuários). |
Configure os perfis de acesso em Configurações → Perfis de Acesso.