Principal 3. 📘 Tutoriais Passo a Passo Gerenciador de Conexões do WhatsApp (Evolution API + Mágica Chat)

Gerenciador de Conexões do WhatsApp (Evolution API + Mágica Chat)

Última atualização em Oct 07, 2025

Gerenciador de Conexões do WhatsApp (Evolution API + Mágica Chat)

Para quem é: empreendedores, líderes de atendimento e agências que operam vários números de WhatsApp e querem tudo organizado em um só lugar — com relatórios, equipes e SLAs.

O que é e por que usar

O Gerenciador de Conexões conecta seus números de WhatsApp (via Evolution API) ao Mágica Chat (nossa central de atendimento). Em poucos cliques, você cria uma instância, lê o QR Code e pronto: mensagens, contatos e mídias chegam na sua Caixa de Entrada com distribuição por equipe, horário e prioridade.

Benefícios práticos

  • Tenha muitos números (marcas, filiais, campanhas) sem perder controle.

  • Atendimento mais rápido: filas claras, quem atende, quando e como.

  • Relatórios por número e equipe para decisões de crescimento.

  • Escalável: ligou um novo número? Só repetir o passo a passo.

O que você precisa

  1. Acesso ao painel da Evolution API.

  2. Conta no Mágica Chat (com Account ID e Token de administrador).

  3. Pelo menos uma Caixa de Entrada criada (ou deixe a criação automática ligada).

Dica: guarde seus tokens com segurança e troque periodicamente.

Como configurar (passo a passo)

1) Criar a instância na Evolution API

  • Entre em Evolution API › Instâncias → Nova Instância.

  • Use um nome fácil de identificar (ex.: acme-suporte_71 ou loja-centro_11).

  • Salve.

2) Conectar o WhatsApp por QR Code

  • Abra a instância criada e clique em Conectar.

  • No app WhatsApp, vá em Dispositivos Conectados e leia o QR Code.

  • Aguarde aparecer Conectado.

3) Integrar com o Mágica Chat

Na instância, acesse Integrações › Chatwoot e preencha:

  • Ativo: ligado.

  • URL do Chatwoot: https://magicachat.conexaoazul.com (ou sua URL white‑label).

  • ID da Conta: ex.: 77.

  • Token: seu access token admin do Mágica Chat.

  • Nome da Caixa de Entrada: ex.: ACME – Suporte (ajuda nos relatórios).

  • Assinar mensagens (opcional): acrescenta assinatura do remetente.

  • Reabrir conversa: útil para retomar automaticamente quando chega nova mensagem.

  • Importar contatos e Importar mensagens: ótimo para começar com histórico.

  • Limite de dias: ex.: 7 para importar a última semana.

  • Criação automática: se ligado, cria a Inbox no Mágica Chat se não existir.

Clique em Salvar. A sincronização começa em seguida.

Tela de referência:

4) Repetir para vários números

  • Repita os passos 1 a 3 para cada número da empresa, filial ou cliente.

  • Mantenha padrão de nomes. Ex.: marca-canal_ddd (acme-vendas_71, acme-cobranca_71).

5) Organizar no Mágica Chat

  • Em cada Caixa de Entrada, defina o Time responsável (Suporte, Comercial, Cobrança).

  • Ligue o auto‑assignment (distribuição automática) se quiser.

  • Crie macros e regras (com n8n) para aplicar SLAs e priorizar urgências.

Boas práticas simples

  • Nomeação clara = relatório claro. O nome da instância e da Inbox devem bater.

  • Tags por campanha (ex.: btx-2025, q4-blackfriday).

  • Acessos mínimos: só quem precisa enxerga aquele número.

  • Tokens sob controle: guarde em cofre (ex.: Vault) e troque a cada trimestre.

Métricas que importam

  • Por Inbox: tempo médio de atendimento, atendimento dentro do SLA, satisfação.

  • Por Equipe: produtividade, fila e backlog.

  • Por Número: volume por horário/dia e resultado por campanha.

Decida com dados: veja onde escalar equipe e onde investir mídia.

Dúvidas comuns (FAQ)

O QR Code venceu. E agora?

  • Atualize a tela da instância e gere um novo QR. Confira a internet do aparelho vinculado.

Salvei e deu erro 401/403.

  • Token inválido ou sem permissão. Gere um access token admin novo no Mágica Chat e confirme o ID da Conta.

Criou duas Inboxes por engano.

  • Desligue Criação Automática e selecione a Inbox correta antes de salvar.

Mensagens não estão chegando.

  • Veja se a instância está Conectada.

  • Revise URL, Account ID e Token.

  • No Mágica Chat, confira webhooks da Inbox e veja os logs (Rails/Sidekiq).

Histórico não importou.

  • Ative Importar Mensagens e aumente o Limite de dias. Salve e reconecte.

Checklist rápido de implantação

  • Instância criada e conectada por QR.

  • Integração ativa (URL/ID/Token corretos).

  • Inbox nomeada e Time definido.

  • Regras de distribuição/SLAs configuradas.

  • Importação de contatos/mensagens habilitada.

  • Tokens guardados com segurança.

Quer ir além? (ideias de uso)

  • Números por campanha para medir ROI com precisão.

  • Número de cobrança separado do suporte para evitar ruídos.

  • Filiais com Inboxes próprias, mantendo visão centralizada.

Precisa de ajuda?

Abra um ticket no Helpdesk (categoria Canais e Integrações) com:

  • URL do Mágica Chat, Account ID, nome da Instância.

  • Prints da configuração e horário do erro.

SLA de resposta: até 4 horas úteis (pode variar conforme seu plano).