Integrar WhatsApp com seu CRM e sua loja: o que dá para automatizar

Integração WhatsApp CRM tem três níveis, e eles custam esforços bem diferentes. O primeiro é notificação de mão única: seu sistema manda uma mensagem quando algo acontece e acabou. O segundo é consulta: o cliente pergunta, a IA lê o dado no seu sistema e responde. O terceiro é escrita: a conversa vira registro do outro lado — um chamado aberto, um lead criado. Quase todo mundo instala o primeiro achando que comprou o segundo.

No FireZAP os três existem, por caminhos diferentes: módulos prontos de PerfexCRM e WooCommerce, baixáveis em Integrações › Downloads; integração de leitura configurada dentro da própria conexão; e a API pública v1 para todo o resto. Este texto separa o que cada nível resolve e o que perguntar antes de ligar qualquer um deles.

Os três níveis, lado a lado

Nível 1: notificação de mão única

É o mais simples e o que corta mais mensagem repetida. Pedido mudou de status, fatura foi emitida, chamado foi respondido: sai uma mensagem no WhatsApp do cliente. Não é conversa — mas se ele responder, cai no inbox como qualquer outro atendimento, e daí a IA ou o humano assume.

O módulo do WooCommerce cobre os sete status do pedido: aguardando, processando, em espera, concluído, cancelado, reembolsado e falho. Cada um tem seu texto e seu liga/desliga, com variáveis para número do pedido, itens, total, link de pagamento, código de rastreio e endereço. A cada envio o plugin grava uma nota no pedido, no sucesso e na falha, e não repete a mensagem do mesmo status.

O módulo do PerfexCRM entra por outro lugar, e é mais esperto do que parece: ele se registra como gateway de SMS do CRM. Todo gatilho de SMS que o Perfex já tem — fatura enviada, lembrete de vencimento, ticket, orçamento, contrato, lembrete de tarefa — passa a sair pelo WhatsApp. Você não mexe em uma linha do CRM, só troca o gateway.

Nível 2: a IA responde “cadê meu pedido” com dado real

Essa é a pergunta mais repetida de qualquer loja, e ela não precisa de humano. Precisa de acesso de leitura.

Na conexão, em Integração › WooCommerce, você informa a URL da loja e uma chave REST com permissão de leitura (Consumer Key e Consumer Secret). A partir daí a IA responde catálogo, preço, estoque e status dos pedidos daquele contato — o pedido dele, com o número dele, não um link genérico de rastreio.

Com o PerfexCRM o princípio é o mesmo e as fontes são outras: faturas, contratos, projetos e chamados do cliente entram na conversa sem ninguém abrir o CRM. Com o GLPI, a IA identifica o cliente pelo telefone e lista os chamados dele.

Nível 3: escrita, quando a conversa vira registro

Aqui a conversa deixa de só consultar e passa a criar coisa. É o nível que mais poupa digitação e o que mais estraga base quando entra sem planejamento.

• •Abrir chamado: no GLPI, a IA abre um chamado novo na categoria certa a partir do que o cliente contou, sem ninguém transcrever nada.
• •Criar lead: a integração com o PerfexCRM grava o lead no CRM — é a única escrita que ela faz, de propósito.
• •Cadastrar contato: pelo recurso de contatos da API pública v1, o seu sistema cria ou atualiza um contato no FireZAP com nome, telefone, etiquetas, valor e etapa do funil.

Regra que vale para os três: defina no papel quem é o dono do cadastro antes de ligar a chave. Se o CRM e o FireZAP podem os dois criar o mesmo cliente, você vai ter duplicata — e ninguém nunca arruma tempo para limpar duplicata.

O que perguntar antes de integrar

1. 1Qual o escopo do token? No FireZAP o token da API já carrega a empresa dele; gerado dentro de uma conexão, ele também prende o número de saída. Token que abre tudo é token que você não deveria colar na configuração de um plugin.
2. 2Dá para revogar um sem derrubar os outros? Use um token por integração. Quando um vazar — e um vai vazar —, você revoga aquele, não a operação inteira.
3. 3Qual o limite de requisição do outro lado, e o que ele devolve quando estoura? Isso muda a arquitetura. A API do PerfexCRM, por exemplo, não filtra do lado do servidor: devolve a lista inteira a cada consulta. A integração por isso baixa uma vez, indexa por cliente e guarda em cache — fresco por 10 minutos, utilizável por 12 horas, revalidando em segundo plano. Sem isso, cada “cadê minha fatura” arrastaria megabytes.
4. 4Em que formato chega o telefone? Sistema brasileiro costuma guardar o número sem o código do país. Os dois módulos têm campo de DDI padrão para completar o 55 quando falta. Confira, porque número mal formado raramente dá erro — só não chega.
5. 5O que fica registrado na conversa? Mensagem enviada pela API aparece no inbox marcada como vinda da API, separada de humano e de IA. Integração que não deixa rastro na conversa é integração que ninguém consegue explicar ao cliente depois.

E quando a API do outro lado cai?

Cai. A pergunta certa não é se, é o que acontece com o atendimento naquele minuto — e essa resposta você precisa ter antes, não durante.

O comportamento que você quer é degradação, não queda. Se o PerfexCRM do cliente sai do ar, a IA perde o contexto de faturas e chamados e responde sem esses dados; a conversa continua e o atendimento não trava. Exija isso de qualquer integração de leitura: sem o dado, ela responde sem o dado e chama um humano. O que não pode é emudecer no meio da frase.

No caminho contrário, o cuidado é seu. O módulo do WooCommerce grava a nota no pedido no sucesso e na falha, então dá para auditar qual notificação não saiu — se alguém olhar. Ninguém percebe notificação que deixou de sair. Só o cliente percebe, e ele percebe ligando.

Módulo pronto ou API pública direta?

A API v1 é um contrato estável — o próprio módulo do PerfexCRM consome ela em produção. A autenticação é um Bearer com o token da empresa, e o recurso vai na query string:

POST /api/public/v1/?resource=messages
Authorization: Bearer azp_seutoken
Content-Type: application/json

{ "numero": "5511999998888", "texto": "Sua fatura está disponível." }

Além de enviar texto, ela envia mídia, cria contato, lista as suas conexões e lê o histórico de mensagens de um número. A referência completa dos recursos fica dentro do painel, em Integrações — é ela que vale, porque acompanha o código.

Por onde começar

1. 1Escolha um evento só. O que costuma pagar sozinho é “pedido confirmado” ou “fatura vencendo”: volume alto, texto curto, zero ambiguidade.
2. 2Gere o token dentro da conexão que vai disparar, para o número de saída já vir definido — e guarde-o como senha, porque é o que ele é.
3. 3Instale o módulo (Integrações › Downloads) ou faça a primeira chamada da API v1 apontando para o seu próprio número. Teste com você antes de testar com cliente.
4. 4Só ligue a leitura depois que a notificação estiver estável por alguns dias. Consulta erra de um jeito bem mais visível: ela erra respondendo ao cliente.
5. 5Deixe a escrita por último, e só com a regra de dono do cadastro já decidida.

Feito nessa ordem, cada nível estreia com o anterior já funcionando — e quando algo quebra, você sabe exatamente o que mexeu por último.