> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plug4ia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Perguntas Frequentes

> Respostas para dúvidas comuns de Software Houses sobre configuração, segurança, integrador, WhatsApp, usuários, Tools e agendamentos no Plug4ia.

Esta página responde às dúvidas mais frequentes de Software Houses que configuram e operam o **Plug4ia** para seus clientes.

> [accordion] Quais ERPs são suportados?
>
> 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.
>
> > [!NOTE]
> >
> > A compatibilidade prática depende da estrutura do banco do ERP e das consultas SQL criadas pela Software House.

> [accordion] O Plug4ia acessa diretamente o banco do cliente?
>
> 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.

> [accordion] O integrador precisa ficar no mesmo servidor do ERP?
>
> 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 **Plug4IAIntegrador**. Em Linux, a instalação usa Docker Compose.

> [accordion] Como conecto o WhatsApp da Software House?
>
> 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.

> [accordion] Quantos usuários posso cadastrar?
>
> 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.

> [accordion] Um usuário pode acessar mais de uma empresa?
>
> 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.

> [accordion] Como crio consultas personalizadas?
>
> 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](https://docs.plug4ia.com/admin/tools.md) para exemplos de SQL e parâmetros.

> [accordion] Quais parâmetros posso usar nas SQLs das Tools?
>
> 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`
>
> > [!TIP]
> >
> > Use nomes claros e mantenha o padrão das Tools existentes sempre que possível.

> [accordion] Posso receber respostas em áudio?
>
> Á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](https://docs.plug4ia.com/features/audio.md) e [Agendamentos](https://docs.plug4ia.com/features/schedules.md).

> [accordion] Como configuro relatórios automáticos?
>
> 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.

> [accordion] O que acontece se o integrador estiver desconectado?
>
> 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 **Plug4IAIntegrador** no Windows.
> * Container do integrador no Linux.
> * Token atual da empresa.
> * Acesso de rede do servidor ao banco do ERP.

> [accordion] Como a segurança é aplicada?
>
> 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](https://docs.plug4ia.com/integrador/seguranca.md).

> [accordion] O que a Software House deve validar antes de liberar um cliente?
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.