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

# Portal Administrativo do Plug4ia

> Conheça o portal web do Plug4ia, onde Software Houses configuram ERPs, empresas, usuários, Tools, WhatsApp e agendamentos.

O **Portal Administrativo do Plug4ia** é o ambiente usado pela Software House para configurar e acompanhar a operação dos clientes integrados.

Por meio do portal, você cadastra ERPs, empresas, usuários, permissões, consultas SQL, canais de WhatsApp e agendamentos. Essas configurações determinam o que os usuários finais poderão consultar pelo WhatsApp.

## Quem usa o portal

O portal é destinado à **Software House** e aos administradores responsáveis pela implantação e manutenção do Plug4ia.

Usuários finais normalmente interagem pelo WhatsApp. Eles só precisam estar cadastrados, ativos e com permissão para consultar as empresas corretas.

## Principais áreas

<CardGroup cols={2}>
  <Card title="Dashboard" icon="chart-bar">
    Mostra indicadores gerais do ambiente, como usuários, ERPs conectados, Tools disponíveis, empresas, agendamentos ativos e status dos conectores.
  </Card>

  <Card title="ERPs" icon="database" href="/admin/erps">
    Permite cadastrar e manter os sistemas ERP atendidos pela Software House, com tipo de banco padrão e status.
  </Card>

  <Card title="Empresas" icon="building" href="/admin/companies">
    Permite cadastrar clientes, vincular cada empresa a um ERP, gerar token do integrador local e acompanhar o status da integração.
  </Card>

  <Card title="Usuários" icon="users" href="/admin/users">
    Permite criar usuários, informar WhatsApp, definir tipo de acesso, ativar ou inativar contas e liberar empresas para consulta.
  </Card>

  <Card title="Tools" icon="wrench" href="/admin/tools">
    Permite configurar as consultas SQL que o Plug4ia usa para responder perguntas pelo WhatsApp.
  </Card>

  <Card title="Configurações" icon="settings">
    Reúne configurações da Software House, incluindo a conexão do canal de WhatsApp por QR Code.
  </Card>
</CardGroup>

## Dashboard

O Dashboard é a primeira tela de acompanhamento do ambiente.

Ele apresenta:

| Informação            | O que indica                                                        |
| --------------------- | ------------------------------------------------------------------- |
| Usuários              | Total de usuários cadastrados                                       |
| ERPs conectados       | Quantidade de ERPs disponíveis no ambiente                          |
| Tools disponíveis     | Quantidade de consultas configuradas                                |
| Empresas              | Total de empresas cadastradas                                       |
| Agendamentos ativos   | Relatórios automáticos configurados e ativos                        |
| Status dos conectores | Situação dos integradores locais das empresas                       |
| Execuções SQL         | Acompanhamento de execuções do dia, quando disponível para o perfil |

<Tip>
  Use o Dashboard como ponto de partida para verificar se empresas, conectores e agendamentos estão funcionando como esperado.
</Tip>

## Fluxo recomendado de configuração

<Steps>
  <Step title="Cadastre o ERP">
    Crie o ERP que será usado pelas empresas clientes e informe o tipo de banco padrão.
  </Step>

  <Step title="Cadastre as empresas">
    Registre os clientes, vincule cada empresa ao ERP correto e gere o token do integrador local.
  </Step>

  <Step title="Configure as Tools">
    Cadastre as consultas SQL que o Plug4ia poderá usar para responder perguntas pelo WhatsApp.
  </Step>

  <Step title="Cadastre os usuários">
    Informe nome, e-mail, WhatsApp, tipo de acesso e status.
  </Step>

  <Step title="Defina empresas permitidas">
    Libere para cada usuário apenas as empresas que ele pode consultar.
  </Step>

  <Step title="Conecte o WhatsApp">
    Em Configurações, conecte o canal de WhatsApp da Software House pelo QR Code.
  </Step>

  <Step title="Valide a primeira consulta">
    Envie uma pergunta pelo WhatsApp usando um usuário autorizado e confirme se a resposta usa os dados esperados.
  </Step>
</Steps>

## Controles de acesso

O Plug4ia usa as informações cadastradas no portal para controlar o uso pelo WhatsApp.

| Controle             | Como afeta o uso                                                  |
| -------------------- | ----------------------------------------------------------------- |
| Usuário ativo        | Apenas usuários ativos devem conseguir utilizar o assistente      |
| WhatsApp cadastrado  | O número identifica quem está enviando a mensagem                 |
| Empresas permitidas  | O usuário só consulta empresas liberadas para ele                 |
| Empresa ativa        | Empresas inativas não devem ser usadas em consultas               |
| Integrador conectado | A empresa precisa estar conectada para responder com dados do ERP |
| Tool ativa           | Apenas consultas ativas devem estar disponíveis para resposta     |

<Warning>
  Antes de liberar um cliente para uso, valide usuário, empresa, integrador, WhatsApp e Tools. A falta de qualquer uma dessas configurações pode impedir a resposta pelo WhatsApp.
</Warning>