Skip to main content
Após a instalação, siga este guia para ativar sua licença, acessar o painel de gerenciamento e criar sua primeira instância WhatsApp no Evolution Go.

​
Passo 1: Ativar a licença Evolution

Antes de usar o Evolution Go, é necessário ativar sua licença. Ao acessar o sistema pela primeira vez, você será redirecionado para a tela de ativação. Tela de ativação da licença Evolution Go

​
Como ativar

  1. Acesse a URL do seu Evolution Go no navegador (ex: http://localhost:8080 ou o domínio do seu servidor)
  2. Na tela de ativação, você verá o formulário “Ative sua licença Evolution”
  3. Preencha os campos:
    • Nome Completo — Seu nome completo para registro
    • Email — Seu email para receber o Magic Link de ativação
  4. Clique em “Enviar Magic Link”
  5. Verifique sua caixa de entrada e clique no link recebido para ativar
Você também pode ativar usando uma conta social: Continuar com Google ou Continuar com GitHub. Isso agiliza o processo e vincula sua licença automaticamente.
A licença é vinculada ao seu email. Guarde esse email, pois será necessário para futuras ativações ou migrações de servidor.

​
Passo 2: Login no painel

Após ativar a licença, você será direcionado para a tela de login do Evolution Go. Tela de login do Evolution Go

​
Como fazer login

  1. No campo “URL da API Evolution GO”, insira a URL da sua instância:
    • Para instalação local: http://localhost:8080
    • Para servidor remoto: https://seu-dominio.com (ou o IP do servidor com a porta)
  2. No campo “API Key (GLOBAL_API_KEY)”, insira a chave de API que você configurou no arquivo .env durante a instalação
A API Key é o valor da variável GLOBAL_API_KEY configurada no arquivo .env do Evolution Go. Se você não alterou, ela é a chave padrão definida no .env.example — nunca use a chave padrão em produção.

​
Onde encontrar a API Key

A API Key está no arquivo .env na raiz do seu projeto Evolution Go:
Se estiver usando Docker Compose, ela está no docker-compose.yml:
Após preencher os campos, clique em “Entrar” para acessar o painel.

​
Passo 3: Dashboard

Após o login, você será direcionado para o Dashboard do Evolution Go. Dashboard principal do Evolution Go O painel possui uma barra lateral com duas seções principais:
  • Dashboard — Visão geral do sistema (métricas e status serão implementados aqui)
  • Instâncias — Gerenciamento das suas instâncias WhatsApp
No canto superior direito você encontra:
  • Alternador de tema (claro/escuro)
  • Botão “Sair” para fazer logout

​
Passo 4: Criar sua primeira instância

Navegue até a seção Instâncias na barra lateral para gerenciar suas conexões WhatsApp. Tela de instâncias sem nenhuma instância criada Na tela de instâncias você verá:
  • Um campo de busca para filtrar instâncias
  • O botão ”+ Nova Instância” no canto superior direito
  • Uma mensagem indicando que nenhuma instância foi encontrada

​
Criando a instância

Clique em ”+ Nova Instância” para abrir o formulário de criação: Modal de criação de nova instância WhatsApp Preencha os campos: Clique em ”+ Criar Instância” para finalizar.

​
Passo 5: Conectar ao WhatsApp

Após criar a instância, ela aparecerá na lista com o status “Desconectado” (em vermelho). Instância criada com status Desconectado Cada instância exibe:
  • Nome e identificador da instância
  • Status atual (close = desconectado)
  • Botões de ação:
    • Conectar (ícone de power, verde) — Inicia a conexão com o WhatsApp
    • Configurações (ícone de engrenagem) — Abre as configurações da instância
    • Excluir (ícone de lixeira, vermelho) — Remove a instância

​
Configurar conexão

Clique no botão “Conectar” ou no ícone de engrenagem para abrir o modal de configuração da conexão: Modal de configuração de conexão e webhook Neste modal você pode configurar:

​
Webhook URL (opcional)

Insira a URL que receberá os eventos da instância. Exemplo:
Use o webhook.site para testes rápidos. Em produção, aponte para o endpoint do seu servidor que processará os eventos.

​
Eventos para Webhook

Selecione quais eventos serão enviados para a URL do webhook:
  • ALL — Seleciona todos os eventos (recomendado para começar)
  • Ou escolha eventos individuais:

​
Telefone para Pairing Code (opcional)

Se preferir conectar via código de pareamento ao invés de QR Code, insira o número de telefone no formato:
(código do país + DDD + número, sem espaços ou caracteres especiais)

​
Configurações Avançadas

Expanda para ver opções adicionais de configuração da instância.

​
Finalizar conexão

Após configurar, clique em “Conectar” para iniciar a conexão. Dependendo do método escolhido:
  • QR Code: Um QR Code será exibido na tela. Abra o WhatsApp no seu celular, vá em Configurações > Dispositivos conectados > Conectar dispositivo e escaneie o código.
  • Pairing Code: Um código de 8 dígitos será gerado. No WhatsApp do celular, vá em Configurações > Dispositivos conectados > Conectar dispositivo > Conectar com número de telefone e insira o código.
Após a conexão bem-sucedida, o status da instância mudará de “Desconectado” para “Conectado” (em verde) e os eventos começarão a ser enviados para o webhook configurado.

​
Próximos passos

Hospedagem HostGator

Precisa de um servidor? Confira os planos VPS otimizados para Evolution Go