Skip to main content
Esta página responde às dúvidas mais frequentes de Software Houses que configuram e operam o Plug4ia para seus clientes.
O Plug4ia pode ser configurado para ERPs que tenham dados acessíveis pelo Integrador Local e consultas SQL configuradas em Tools.No portal, a Software House cadastra o ERP, define o tipo de banco padrão e cria as Tools que o assistente poderá usar para responder pelo WhatsApp.
A compatibilidade prática depende da estrutura do banco do ERP e das consultas SQL criadas pela Software House.
Não. O acesso ao banco é feito pelo Integrador Local, instalado no ambiente do cliente.As credenciais do banco ficam no arquivo de configuração do integrador, no servidor do cliente. O Portal Administrativo não armazena essas credenciais.O Plug4ia recebe apenas o resultado necessário para responder à consulta.
Não necessariamente.Ele pode ficar no servidor do ERP ou em outro servidor interno, desde que tenha acesso de rede ao banco do ERP e consiga se comunicar com o Plug4ia.Em Windows, o integrador é instalado como serviço Ask2DataIntegrador. Em Linux, a instalação usa Docker Compose.
No Portal Administrativo, acesse Configurações → WhatsApp e clique em Conectar WhatsApp.O portal exibirá um QR Code. No celular do canal:
  1. Abra o WhatsApp.
  2. Acesse Aparelhos conectados.
  3. Toque em Conectar um aparelho.
  4. Escaneie o QR Code do portal.
Depois da conexão, o canal aparecerá na lista com telefone e status.
A documentação não define um limite operacional para cadastro de usuários.Cada usuário precisa ter:
  • Nome.
  • E-mail.
  • WhatsApp.
  • Tipo de acesso.
  • Status ativo.
  • Empresas liberadas.
O ponto mais importante é garantir que cada usuário tenha acesso apenas às empresas que pode consultar.
Sim. Na tela Usuários, use a ação Definir empresas para ativar ou desativar o acesso do usuário a cada empresa disponível.O Plug4ia usa essa configuração para controlar quais dados o usuário pode consultar pelo WhatsApp.
As consultas são criadas na seção Tools.Para criar uma Tool, informe:
  • ERP.
  • Nome da Tool.
  • Agente.
  • Descrição.
  • Consulta SQL.
  • Status ativo ou inativo.
A descrição deve explicar claramente o que a consulta responde, pois ela ajuda o Plug4ia a escolher a Tool correta.Consulte Tools para exemplos de SQL e parâmetros.
As Tools podem usar parâmetros com @, preenchidos conforme a pergunta do usuário e o contexto da empresa.Parâmetros comuns no catálogo atual:
  • @erp_empresa_id
  • @data_ini
  • @data_fim
  • @top_n
  • @nome
  • @produto_id
  • @codigo_ean
  • @fornecedor_id
  • @documento
Use nomes claros e mantenha o padrão das Tools existentes sempre que possível.
Áudio como saída funciona em agendamentos.O usuário pode enviar uma pergunta por voz no WhatsApp, mas a resposta imediata é enviada em texto. Para receber áudio narrado, crie um agendamento e marque Enviar em áudio.Consulte Áudio e Agendamentos.
Os relatórios automáticos são configurados em Usuários → Gerenciar agendamentos.Em um agendamento, defina:
  • Empresa / ERP.
  • Agente.
  • Horário.
  • Frequência.
  • Dia da semana, quando aplicável.
  • Ação agendada.
  • Enviar em áudio, quando desejar áudio narrado.
  • Status ativo.
Se o integrador da empresa estiver desconectado, o Plug4ia pode não conseguir consultar os dados do ERP daquela empresa.A Software House deve verificar:
  • Status do integrador na tela Empresas.
  • Serviço Ask2DataIntegrador no Windows.
  • Container do integrador no Linux.
  • Token atual da empresa.
  • Acesso de rede do servidor ao banco do ERP.
A segurança combina controles de portal, integrador e permissões.Principais pontos:
  • Usuários precisam estar cadastrados e ativos.
  • WhatsApp do usuário identifica quem está consultando.
  • Usuário só consulta empresas liberadas.
  • Credenciais do banco ficam no integrador local.
  • Tools controlam quais consultas podem ser feitas.
  • O integrador executa consultas dentro do ambiente do cliente.
Consulte Segurança do Integrador.
Antes de liberar o uso, valide:
  • ERP cadastrado e ativo.
  • Empresa cadastrada, ativa e com integrador conectado.
  • Token correto configurado no integrador.
  • WhatsApp da Software House conectado.
  • Usuários ativos com WhatsApp correto.
  • Empresas liberadas para cada usuário.
  • Tools ativas e SQLs validadas.
  • Consulta de teste funcionando pelo WhatsApp.
  • Agendamentos testados, quando existirem.