Aviso Importante: Responsabilidade sobre a Instalação e Suporte
A Evoluiton API é uma solução de software de código aberto.
Isso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante.
A equipe de suporte do Konvoo não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Konvoo não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.
1. Prepare o Ambiente
Antes de tudo, precisamos de duas ferramentas essenciais no seu computador. Se você já não as tiver, baixe e instale:
- Git: Essencial para executar nosso script. Faça o download aqui.
- Docker Desktop: A plataforma que vai rodar nossa aplicação. Faça o download aqui.
Após instalar o Docker, lembre-se de abrir o programa e deixá-lo rodando. Ele precisa estar ativo para que a mágica aconteça.
2. Baixe o Script de Instalação
Para facilitar sua vida, preparamos um pacote com tudo que você precisa.
- Baixe aqui o arquivo evolution.rar.
- Descompacte o arquivo em uma pasta de fácil acesso no seu computador (por exemplo:
C:\Evolution).
3. Execute os Comandos no Terminal
Agora vem a parte mais fácil. Vamos rodar os comandos que farão todo o trabalho pesado.
Navegue até a pasta onde você descompactou os arquivos.
Clique com o botão direito do mouse dentro da pasta e selecione a opção "Abrir no Terminal" ou "Open in Terminal".
O terminal do Windows (PowerShell) será aberto. Primeiro, vamos ativar o interpretador Bash do Git com o seguinte comando. Copie, cole e pressione Enter:
& "C:\Program Files\Git\bin\bash.exe"Com o Bash ativo, execute o script de instalação. Digite o comando abaixo e pressione Enter:
./evolution.sh
Pronto! O script fará o download e a configuração de todos os componentes da Evolution API. Na primeira vez, pode demorar alguns minutos.
4. Acessando e Conectando sua API
Com tudo instalado, é hora de acessar o painel de controle.
- Abra seu navegador e acesse: http://localhost:8081
- Clique em "Manager". O sistema pedirá uma Chave Global (Global API Key).
- Para encontrá-la, abra o arquivo
evolution.shcom um editor de texto (Bloco de Notas). No final do arquivo, você encontrará a chave. Copie e cole no painel. - Dentro do painel, crie uma nova instância, dê um nome e clique nela para gerar o QR Code.
- Leia o QR Code com o WhatsApp do seu celular e aguarde a conexão ser estabelecida.
5. Integração com Konvoo
O último passo é conectar sua nova instância da Evolution API ao painel do Konvoo.
- No painel Admin, navegue até Configurações > Integrações > Evolution.
- Preencha a URL da API com o endereço do seu servidor (ex: http://SEU\\_IP\\_DE\\_SERVIDOR:5555).
- Preencha a Chave Global com o APP_ADMIN_TOKEN definido no seu arquivo .env.
- Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção "Evoluiton".
- Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.