Conectar WhatsApp (Evolution) ao Mágica Chat via QR Code
  • Entrar
    • 😪

    Conectar WhatsApp (Evolution) ao Mágica Chat via QR Code

    0) Pré-requisitos

    • 📱 Um número de WhatsApp (Business ou comum) ativo no celular.
    • 🔌 Celular com internet estável, sem economia de bateria agressiva.
    • 🔐 Acesso ao Gerenciador Evolution: https://api2.conexaoazul.com/manager/
    • 💬 Acesso ao Mágica Chat (Chatwoot): https://magicachat.conexaoazul.com/
    • 👤 Permissões: perfil com acesso para criar sessão no Manager e criar canal no Mágica Chat.

    1) Criar a Sessão no Manager (Evolution)

    1. Acesse https://api2.conexaoazul.com/manager/ e faça login.
    2. Vá em Sessões → Nova Sessão (ou Criar Conexão).
    3. Preencha:
      • Nome da sessão: algo curto e identificável (ex.: loja_centro).
      • Modo: Default/WEB (quando for conexão via QR).
    4. Salve. A sessão aparecerá na lista com Status: Parada/Offline.

    Dica: anote Nome da Sessão e Token/API Key (se mostrado na tela de detalhes). Vamos usar no Mágica Chat.

    2) Ler o QR Code e vincular o WhatsApp

    1. Ainda no Manager, abra a sessão criada e clique em Iniciar.
    2. Aguarde carregar o QR Code.
    3. No celular do número que será usado:
      • Abra WhatsApp → Aparelhos conectados → Conectar um aparelho → Escanear QR.
    4. Aponte a câmera para o QR do Manager.
    5. Em segundos, a sessão deve mudar para Status: Online/Conectado.
    6. Faça um teste rápido: no Manager, use “Enviar mensagem de teste” (se disponível) OU siga para o passo 4 (teste pelo Mágica Chat).

    Se o QR expirar, clique em Gerar novo QR e repita.

    3) Configurar o canal no Mágica Chat (Chatwoot)

    1. Acesse https://magicachat.conexaoazul.com/ com seu usuário.
    2. Vá em Configurações (ícone de engrenagem) → Caixas de entrada / Inboxes → Adicionar caixa de entrada.
    3. Selecione WhatsApp (Evolution API / Web).
    4. Preencha os campos (nomes podem variar de acordo com a versão):
      • Base URL / Servidor: https://api2.conexaoazul.com
      • Session / Sessão: o Nome da Sessão criado no Manager (ex.: loja_centro)
      • Token / API Key: o token exibido na sessão (se o conector exigir)
      • Nome da Inbox: como aparecerá para sua equipe (ex.: WhatsApp Loja Centro)
      • Agentes / Roteamento: selecione os atendentes/filas
    5. Salve a caixa de entrada. O Mágica Chat exibirá um Webhook URL (geralmente algo como /webhook/inboxes/...).

    4) (Importante) Configurar o Webhook no Manager

    1. Volte ao Manager → abra a Sessão.
    2. Procure Webhooks ou URL de callback (na aba da sessão).
    3. Cole o Webhook URL do Mágica Chat e salve.
    4. Se houver opção de Eventos do webhook, marque messages, statuses, presence (no mínimo messages).
    5. Reinicie a sessão (parar → iniciar) para garantir que o webhook está ativo.

    Sem Webhook, o Mágica Chat não recebe mensagens entrantes.

    5) Teste de ponta-a-ponta

    1. De um segundo celular, envie uma mensagem para o número conectado.
    2. No Mágica Chat, vá na Inbox criada e verifique se a conversa aparece.
    3. Responda pelo Mágica Chat e confirme que a resposta chega ao WhatsApp do cliente.

    Se os dois sentidos funcionarem, pronto: canal ativo!

    6) Boas práticas operacionais

    • Mantenha o celular ligado e com internet estável (Wi-Fi preferencial).
    • Desative no aparelho:
      • Otimização agressiva de bateria para o WhatsApp.
      • Bloqueios que desliguem dados em segundo plano.
    • Um número por sessão. Evite usar o mesmo número em múltiplas sessões.
    • Sempre que trocar de aparelho ou WhatsApp, reescaneie o QR no Manager.

    7) Problemas comuns & soluções rápidas

    QR não aparece / fica carregando

    • Atualize a página da sessão e clique em Gerar novo QR.
    • Verifique se o servidor api2.conexaoazul.com está acessível.

    Sessão cai para Offline

    • Celular sem internet / sem energia. Reabra o WhatsApp, mantenha-o em primeiro plano por 1 minuto.
    • Reinicie a sessão no Manager (Parar → Iniciar).
    • Verifique se outro WhatsApp Web foi conectado no mesmo número (isso pode invalidar a sessão).

    Mensagens saem, mas não entram no Mágica Chat

    • Webhook faltando: confira e recoloque o Webhook URL do Mágica Chat na sessão.
    • Teste enviando para o número e olhando os logs do Manager.
    • Confirme a Inbox correta no Mágica Chat e se há agentes atribuídos.

    Mensagens entram, mas não saem

    • Token/API Key incorreto no Mágica Chat.
    • Número bloqueado pelo destinatário.
    • Tente responder texto simples (sem anexos) como teste.

    Erro de “sessão duplicada”

    • Desconecte aparelhos antigos no WhatsApp (Aparelhos conectados → Sair de todos) e reconecte via QR pelo Manager.

    8) Segurança e conformidade

    • O número conectado via Evolution utiliza sessão do WhatsApp Web. É essencial manter o aparelho seguro e ativo.
    • Para operações em alto volume e políticas Meta (mensagens template, verificação de empresa), avalie posteriormente WhatsApp Cloud API oficial.

    9) Checklist de ativação (cole no ticket interno)

    • Sessão criada no Manager (nome_sessao: _______)
    • QR lido e Status Online
    • Inbox criada no Mágica Chat (nome: _______)
    • Webhook do Mágica Chat configurado no Manager
    • Teste entrante OK
    • Teste de resposta OK
    • Aparelho com internet + sem economia de bateria agressiva

    10) Modelo de dados (anote e compartilhe)

    • Base URL (Evolution): https://api2.conexaoazul.com
    • Session: nome_da_sessao
    • Token/API Key: xxxxxxxx (se aplicável)
    • Webhook (Mágica Chat): https://magicachat.conexaoazul.com/... (copie da Inbox criada)

    FAQ rápida

    • Posso usar o mesmo número em duas sessões? Não recomendado. Use 1 sessão = 1 número.
    • Perdi o aparelho. Desconecte aparelhos no WhatsApp Web (via outro dispositivo) e refaça a conexão no Manager com o novo aparelho.
    • Quero pausar o canal. No Manager, Parar sessão. Para retomar, Iniciar e, se pedir, reler o QR.

    WhatsApp