Skip to main content
Esta página orienta a Software House na instalação do Integrador Local no ambiente do cliente. O integrador deve ser instalado em uma máquina com acesso aos dados do ERP e acesso à internet para se comunicar com o Plug4ia.

​
Antes de começar

Tenha em mãos:
Use preferencialmente um usuário de banco com permissão somente de leitura nas tabelas necessárias.

​
Instalação em Windows

No Windows, a instalação é feita por um assistente. Ao final, o integrador é registrado como serviço do Windows com o nome Ask2DataIntegrador.
1

Baixe o instalador

Baixe o instalador em: ask2data-integrador-setup.exe
2

Execute como administrador

Clique com o botão direito no instalador e selecione Executar como administrador.
3

Informe o token da empresa

Na etapa Identificação da Empresa, cole o token gerado no Portal Administrativo.
4

Escolha o tipo de origem dos dados

Selecione o tipo usado pelo ERP do cliente.Opções disponíveis no instalador:
5

Informe os dados do banco

Informe host, porta, usuário, senha e nome do banco.
6

Conclua a instalação

O instalador cria o arquivo de configuração, registra o serviço Ask2DataIntegrador e inicia o integrador automaticamente.
7

Valide no portal

No Portal Administrativo, acesse Empresas e confira se o integrador da empresa aparece conectado.

​
Verificando o serviço no Windows

Depois da instalação:
  1. Abra Serviços no Windows.
  2. Procure por Ask2DataIntegrador.
  3. Confirme se o status está como Em execução.
Se precisar reiniciar a integração, reinicie o serviço Ask2DataIntegrador pelo painel de Serviços do Windows.

​
Instalação em Linux

No Linux, a instalação atual usa Docker e Docker Compose. O script de instalação pergunta os dados necessários, cria a configuração e inicia o container do integrador.

​
Pré-requisitos Linux

Antes de executar o instalador, confirme:
  • Docker instalado.
  • Docker Compose disponível.
  • Permissão de sudo.
  • Acesso de rede ao banco do ERP.
  • Token da empresa gerado no portal.
O instalador cria por padrão o diretório /opt/ask2data-integrador.
1

Copie o instalador para o servidor

Transfira o script de instalação Linux para o servidor do cliente.
2

Execute o instalador

Rode o script no terminal.
3

Informe o token da empresa

Cole o token gerado no Portal Administrativo.
4

Escolha a origem dos dados

O instalador permite escolher:
5

Informe os dados solicitados

Informe host, porta, usuário, senha e nome do banco.
6

Confirme o diretório de instalação

Aceite o diretório padrão ou informe outro caminho.
7

Aguarde a inicialização

O instalador cria o config.yaml, gera o docker-compose.yml, baixa a imagem do integrador e inicia o container.
8

Valide no portal

Acesse Empresas no Portal Administrativo e confirme se o integrador aparece conectado.

​
Verificando o integrador no Linux

No diretório de instalação, acompanhe os logs:
Se o ambiente usa docker-compose clássico:
Para reiniciar:

​
Depois da instalação

Depois que o integrador estiver conectado:
  1. Confirme se a empresa está ativa no portal.
  2. Confirme se existem Tools ativas para o ERP.
  3. Confirme se o usuário tem acesso à empresa.
  4. Faça uma pergunta de teste pelo WhatsApp.
Se um novo token for gerado no portal, o integrador precisará ser reconfigurado com esse novo token.