Passar para o conteúdo principal

Como criar uma instância no Evolution API (Channel Baileys)

Este artigo explica, passo a passo, como acessar o Manager do Evolution API e criar uma instância utilizando o channel Baileys para conexão com WhatsApp.

Atualizado há mais de um mês

Pré-requisitos

Antes de iniciar, você precisa logar no console da Cloudfy, para logar clique aqui

  • URL do Manager do Evolution

  • Chave de autenticação (API Key do Evolution)
    Essas informações ficam disponíveis no painel da sua infraestrutura na aba Evolution:


1. Acessar o Manager do Evolution

  1. No painel da sua infraestrutura, vá até:
    Aplicações → Evolution API → Admin

  2. Abra a URL do Manager no navegador

Você verá a tela do Evolution API com a área de Instances.


2. Autenticar no Manager

Ao acessar o Manager:

  1. Será solicitada a chave de autenticação.

  2. Cole a Chave do Evolution exatamente como aparece no painel.

  3. Confirme o acesso.

Após isso, você estará dentro do painel administrativo do Evolution.


3. Criar uma nova instância

  1. Clique no botão Instance +.

  2. Será aberta a tela New instance.

  3. Preencha os campos da seguinte forma:

📌 Campos da instância

  • Name
    Defina um nome para sua instância
    Exemplo: whatsapp01-agenciadeia

  • Channel
    Selecione: Baileys

  • Token
    O sistema gera automaticamente 👉 Não altere esse campo.

  • Number (opcional) Pode deixar em branco na maioria dos casos.


4. Instância criada

Após salvar:

  • A instância aparecerá listada na tela.

  • Ela estará pronta para ser conectada via QR Code no próximo passo (caso necessário).

  • A partir daqui, você poderá integrar essa instância aos seus fluxos (n8n, Chatwoot, etc).


⚠️ Boas práticas (como sempre foi feito)

  • Crie uma instância por número de WhatsApp.

  • Use nomes claros (ex: suporte01, vendas02) e sem espaços

  • Evite apagar instâncias em produção.

  • Não gere múltiplas instâncias sem necessidade, isso evita conflitos e retrabalho.


📎 Observação importante

A criação da instância não conecta o WhatsApp automaticamente.
Após criar, é necessário:

  • Gerar o QR Code

  • Escanear com o WhatsApp do aparelho

  • Ter o Webhook no n8n configurado e etc.

Esse procedimento depende do uso final (n8n, Chatwoot ou API direta).


Caso precise consultar algum procedimento, nossa central de ajuda está aqui: https://ajuda.cloudfy.cloud/pt-BR/

Respondeu à sua pergunta?