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

# Instalando o Integrador Local

> Veja como instalar o Integrador Local do Plug4ia em Windows e Linux no ambiente do cliente.

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:

| Item                | Onde obter                                                        |
| ------------------- | ----------------------------------------------------------------- |
| Token da empresa    | Portal Administrativo, em **Empresas → Integração → Gerar Token** |
| Tipo de banco       | Banco usado pelo ERP do cliente                                   |
| Host ou IP do banco | Ambiente do cliente                                               |
| Porta do banco      | Ambiente do cliente                                               |
| Usuário e senha     | Administrador do ERP ou do banco                                  |
| Nome do banco       | Ambiente do cliente                                               |

<Warning>
  Use preferencialmente um usuário de banco com permissão somente de leitura nas tabelas necessárias.
</Warning>

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

<Steps>
  <Step title="Baixe o instalador">
    Baixe o instalador em: [ask2data-integrador-setup.exe](https://app.plug4ia.com/ask2data-integrador-setup.exe)
  </Step>

  <Step title="Execute como administrador">
    Clique com o botão direito no instalador e selecione **Executar como administrador**.
  </Step>

  <Step title="Informe o token da empresa">
    Na etapa **Identificação da Empresa**, cole o token gerado no Portal Administrativo.
  </Step>

  <Step title="Escolha o tipo de origem dos dados">
    Selecione o tipo usado pelo ERP do cliente.

    Opções disponíveis no instalador:

    | Opção                | Uso                       |
    | -------------------- | ------------------------- |
    | MySQL / MariaDB      | Banco MySQL ou compatível |
    | PostgreSQL           | Banco PostgreSQL          |
    | Microsoft SQL Server | Banco SQL Server          |
    | Firebird             | Banco Firebird            |
    | Outros               | Banco SQL padrão          |
  </Step>

  <Step title="Informe os dados do banco">
    Informe host, porta, usuário, senha e nome do banco.
  </Step>

  <Step title="Conclua a instalação">
    O instalador cria o arquivo de configuração, registra o serviço **Ask2DataIntegrador** e inicia o integrador automaticamente.
  </Step>

  <Step title="Valide no portal">
    No Portal Administrativo, acesse **Empresas** e confira se o integrador da empresa aparece conectado.
  </Step>
</Steps>

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

<Tip>
  Se precisar reiniciar a integração, reinicie o serviço **Ask2DataIntegrador** pelo painel de Serviços do Windows.
</Tip>

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

<Info>
  O instalador cria por padrão o diretório `/opt/ask2data-integrador`.
</Info>

<Steps>
  <Step title="Copie o instalador para o servidor">
    Transfira o script de instalação Linux para o servidor do cliente.
  </Step>

  <Step title="Execute o instalador">
    Rode o script no terminal.

    ```bash theme={null}
    sudo bash instalador.sh
    ```
  </Step>

  <Step title="Informe o token da empresa">
    Cole o token gerado no Portal Administrativo.
  </Step>

  <Step title="Escolha a origem dos dados">
    O instalador permite escolher:

    | Opção      | Uso                     |
    | ---------- | ----------------------- |
    | MySQL      | Apenas banco MySQL      |
    | SQL Server | Apenas banco SQL Server |
    | PostgreSQL | Apenas banco PostgreSQL |
  </Step>

  <Step title="Informe os dados solicitados">
    Informe host, porta, usuário, senha e nome do banco.
  </Step>

  <Step title="Confirme o diretório de instalação">
    Aceite o diretório padrão ou informe outro caminho.
  </Step>

  <Step title="Aguarde a inicialização">
    O instalador cria o `config.yaml`, gera o `docker-compose.yml`, baixa a imagem do integrador e inicia o container.
  </Step>

  <Step title="Valide no portal">
    Acesse **Empresas** no Portal Administrativo e confirme se o integrador aparece conectado.
  </Step>
</Steps>

## Verificando o integrador no Linux

No diretório de instalação, acompanhe os logs:

```bash theme={null}
docker compose logs -f
```

Se o ambiente usa `docker-compose` clássico:

```bash theme={null}
docker-compose logs -f
```

Para reiniciar:

```bash theme={null}
docker compose restart
```

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

<Warning>
  Se um novo token for gerado no portal, o integrador precisará ser reconfigurado com esse novo token.
</Warning>