> ## 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.

<AccordionGroup>
  <Accordion title="Quais ERPs são suportados?" icon="database">
    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.
    </Note>
  </Accordion>

  <Accordion title="O Plug4ia acessa diretamente o banco do cliente?" icon="shield-check">
    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>

  <Accordion title="O integrador precisa ficar no mesmo servidor do ERP?" icon="server">
    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.
  </Accordion>

  <Accordion title="Como conecto o WhatsApp da Software House?" icon="qr-code">
    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>

  <Accordion title="Quantos usuários posso cadastrar?" icon="users">
    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>

  <Accordion title="Um usuário pode acessar mais de uma empresa?" icon="building-2">
    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>

  <Accordion title="Como crio consultas personalizadas?" icon="wrench">
    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](/admin/tools) para exemplos de SQL e parâmetros.
  </Accordion>

  <Accordion title="Quais parâmetros posso usar nas SQLs das Tools?" icon="brackets-curly">
    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.
    </Tip>
  </Accordion>

  <Accordion title="Posso receber respostas em áudio?" icon="microphone">
    Á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](/features/audio) e [Agendamentos](/features/schedules).
  </Accordion>

  <Accordion title="Como configuro relatórios automáticos?" icon="calendar-clock">
    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>

  <Accordion title="O que acontece se o integrador estiver desconectado?" icon="plug">
    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.
  </Accordion>

  <Accordion title="Como a segurança é aplicada?" icon="lock">
    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](/integrador/seguranca).
  </Accordion>

  <Accordion title="O que a Software House deve validar antes de liberar um cliente?" icon="list-check">
    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.
  </Accordion>
</AccordionGroup>