Skip to main content
O Integrador Local é o componente instalado no ambiente do cliente para permitir que o Plug4ia consulte os dados do ERP. Ele fica em uma máquina com acesso ao banco de dados do ERP, recebe as solicitações de consulta, executa localmente e devolve apenas o resultado necessário para a resposta no WhatsApp.

​
Por que o integrador é necessário

Muitos ERPs ficam em redes internas, servidores locais ou ambientes que não devem ser expostos diretamente na internet. O Integrador Local permite que a consulta aconteça dentro do ambiente do cliente, sem abrir acesso direto ao banco para o Plug4ia.
As credenciais do banco ficam no ambiente do cliente, no arquivo de configuração do integrador. Elas não são cadastradas no Portal Administrativo do Plug4ia.

​
O que a Software House configura

Para colocar uma empresa em operação, a Software House precisa:
1

Cadastrar a empresa no portal

No Portal Administrativo, cadastre a empresa e vincule ao ERP correto.
2

Gerar o token da empresa

Na aba de integração da empresa, gere o token de acesso do integrador.
3

Instalar o integrador no cliente

Instale o integrador em Windows ou Linux, conforme o servidor disponível no cliente.
4

Informar os dados de conexão

Configure o token da empresa e os dados de acesso ao banco do ERP.
5

Validar o status

Volte ao portal e confira se o integrador aparece como conectado.

​
Onde instalar

O integrador deve ser instalado em uma máquina que tenha acesso aos dados do ERP.

Servidor do ERP

Opção comum quando o banco do ERP já está disponível no próprio servidor.

Servidor interno

Opção indicada quando a Software House prefere separar o integrador do servidor principal, mantendo acesso de rede ao banco.

​
Sistemas operacionais suportados

Windows

Instalação por assistente. O instalador coleta token, tipo de banco, credenciais e registra o integrador como serviço do Windows.

Linux

Instalação por script com Docker Compose. O script cria o diretório, gera o arquivo de configuração e inicia o serviço em container.

​
Origens de dados suportadas

O integrador pode ser configurado para acessar diferentes origens, conforme o ERP do cliente.
No Linux, o instalador atual permite escolher MySQL, SQL Server ou PostgreSQL.

​
Segurança

O arquivo de configuração contém credenciais sensíveis. Ele deve ficar protegido no servidor do cliente e não deve ser compartilhado em canais inseguros.

​
Status no portal

Depois de instalado, o integrador aparece na tela Empresas e no Dashboard. Use esse status para confirmar se o cliente está pronto para responder consultas pelo WhatsApp. Se o integrador estiver desconectado, as perguntas que dependem daquela empresa podem não retornar dados.

​
Próximos passos

Instalação

Veja como instalar o integrador em Windows e Linux.

Configuração

Entenda os campos do arquivo de configuração local.