Este tutorial tem uma ordem diferente do habitual, e é de propósito. A parte técnica vem no meio, não no começo, porque não é ela que faz implantação de CRM falhar.
Passo 0: decidir o desenho do atendimento
Antes de instalar qualquer coisa, responda três perguntas no papel. Quem tenta responder isso com a ferramenta aberta acaba configurando o que a tela sugere, e não o que a operação precisa.
Quais são as filas? Divida por área, não por pessoa. “Vendas”, “Suporte”, “Financeiro” funciona. “Fila da Ana” cria dependência que quebra no primeiro dia de folga dela.
Quem responde primeiro? Distribuição automática por disponibilidade, rodízio, ou alguém triando e encaminhando. Não existe resposta certa, existe resposta explícita. Sem ela, a conversa fica sem dono e o cliente espera.
O que o robô responde e onde ele para? Este é o mais importante e o mais ignorado. Agente de IA que tenta resolver tudo gera cliente irritado. Defina o escopo estreito e o gatilho de transferência para humano antes de ligar.
Passo 1: o WhatsApp oficial, que é o caminho crítico
Comece por aqui, não pela instalação, porque esta é a etapa que depende de terceiro.
O Evolution CRM opera na API oficial, então você precisa de conta no WhatsApp Business Platform, verificação do negócio junto ao Meta e o número habilitado. O número não pode estar ativo no aplicativo comum ao mesmo tempo, o que na prática significa escolher entre usar aquele número no celular ou na plataforma.
Isso leva dias e não depende de você. Se a implantação tem prazo, é daqui que a contagem começa.
Uma decisão que evita dor: não use o número que já está no celular da equipe se ele for crítico. Habilite um número novo, migre a divulgação com calma, e mantenha o antigo funcionando enquanto isso.
Passo 2: subir a plataforma
O Evo CRM roda em container. Sendo uma stack completa, com painel, banco e processamento, ele pede mais máquina que a Evolution API. Dimensionamento em hospedagem.
Três definições que você faz na subida e que são chatas de mudar depois:
O banco. Use PostgreSQL de verdade, com volume persistido. Não é o tipo de aplicação em que banco embutido resolve.
O domínio. O painel e os webhooks precisam de subdomínio com certificado válido. Instalações pré-provisionadas normalmente já entregam isso resolvido.
O armazenamento de mídia. Atendimento por WhatsApp acumula áudio, foto e documento numa velocidade que surpreende. Aponte para armazenamento externo se você espera volume, porque disco cheio derruba a plataforma inteira e o sintoma não é óbvio.
Passo 3: conectar o canal e testar de ponta a ponta
Com o número aprovado e a plataforma no ar, você conecta as credenciais do WhatsApp Business Platform.
O teste que vale é o de ponta a ponta, feito por alguém de fora: mande mensagem do seu celular pessoal para o número da empresa e confirme que ela aparece na fila certa, com o contato identificado. Testar mandando mensagem de dentro da plataforma não exercita o caminho que importa, que é o de entrada.
Repita esse teste depois de qualquer mudança de configuração de fila. É trinta segundos e evita descobrir pelo cliente.
Passo 4: importar contatos com o número no formato certo
Se você tem base de contatos, importe antes de abrir para a equipe, para que o histórico já apareça atrelado à pessoa.
O erro que aparece em praticamente toda importação: telefone sem código do país. Número
brasileiro salvo como 11987654321 não casa com a conversa que chega identificada como
5511987654321, e o resultado é contato duplicado. Normalize a planilha antes, não depois.
Passo 5: configurar o agente de IA com escopo estreito
A tentação é ligar o agente para responder tudo. Não faça isso na primeira semana.
Comece com ele cobrindo apenas as dúvidas repetitivas que você já sabe de cor: horário de funcionamento, prazo de entrega, formas de pagamento. Tudo fora disso, transfere para humano.
Depois de uma semana, leia as conversas reais. Você vai descobrir dois tipos de coisa: perguntas frequentes que não estavam na sua lista, e casos em que o agente respondeu com confiança algo errado. O primeiro tipo você adiciona ao escopo. O segundo você usa para estreitar o escopo, não para ajustar o prompt e seguir esperando.
Lembre que o custo do modelo é uma linha separada na sua conta, como trato em preços. Agente que responde tudo custa mais que agente que responde o que importa.
Passo 6: treinar a equipe, que é onde a implantação morre
A parte técnica está pronta e o projeto ainda pode falhar aqui.
Duas coisas que fazem diferença: mostrar o ganho para quem vai usar, não o recurso, e definir o que acontece com o WhatsApp pessoal. Se o atendente puder continuar respondendo cliente pelo celular dele, ele vai, e metade das conversas não vai entrar no sistema. Essa regra precisa ser explícita e combinada, não implícita.
Os erros que consomem a primeira semana
Diferente de uma ferramenta de automação, aqui os problemas raramente são técnicos. Vale a lista, porque são sempre os mesmos.
“A conversa ficou sem ninguém.” Regra de distribuição não configurada, ou configurada para “todos veem”. Quando todos são responsáveis, ninguém é. Defina atribuição automática desde o primeiro dia, mesmo que imperfeita.
“O cliente aparece duas vezes.” Telefone importado sem código do país. A conversa que chega
como 5511... não casa com o contato salvo como 11.... Normalize a base antes de importar, não
depois de duplicar.
“O robô respondeu uma bobagem para o cliente.” Escopo do agente amplo demais na largada. A correção não é melhorar o prompt e seguir esperando: é estreitar o escopo e transferir mais cedo para humano.
“A equipe não está usando.” Quase sempre porque o WhatsApp pessoal continua funcionando. Se o atendente pode responder pelo celular, ele responde. Isso precisa ser combinado explicitamente, com o número antigo saindo de circulação de forma planejada.
“Ficou lento depois de um mês.” Banco sem política de retenção, ou mídia enchendo o disco. Nenhum dos dois avisa antes; os dois aparecem como lentidão genérica.
“Perdemos as conversas de ontem.” Volume não persistido, ou backup que nunca foi testado. É a falha mais grave da lista, porque o que se perde é histórico comercial e dado de cliente.
Passo 7: fechar a porta
Sua instalação guarda o histórico de conversa dos seus clientes, o que faz dela um repositório de dado pessoal sob sua responsabilidade.
Painel atrás de autenticação forte, acesso restrito, versão atualizada e backup testado. Não é higiene opcional: é uma base de dados de terceiros na sua mão.
Onde ir depois
O dimensionamento de servidor e o caminho curto para subir estão em hospedagem. A conta com o ponto de virada por atendente, em preços. O julgamento sobre a plataforma servir ao seu caso, no review. E se a conclusão for que você não quer administrar isso, as alternativas comparam com as plataformas na nuvem.