Adicionando verificações de registro no WhatsApp a um fluxo de trabalho de CRM
Crie um fluxo de trabalho de CRM que verifica o registro no WhatsApp de novos contatos, armazena o resultado e direciona o acompanhamento com foco no consentimento.

Um fluxo de trabalho de CRM para verificação de WhatsApp passo a passo: quando acionar a verificação, como normalizar números, quais propriedades e tags armazenar e como direcionar o acompanhamento.
Um fluxo de trabalho de CRM para verificação de WhatsApp executa uma verificação de registro quando um contato é criado ou seu número de telefone é alterado, grava o resultado e a data da verificação no registro e usa essa tag para decidir em qual sequência de acompanhamento o contato pode entrar. A verificação informa o planejamento do canal; o status de opt-in ainda decide se o contato pode receber mensagens. Construído dessa forma, o CRM mantém um sinal atual de presença na conta sem precisar verificar novamente todo o banco de dados todas as noites.
Onde a verificação se encaixa no ciclo de vida do contato
Os guias dos fornecedores sobre este tópico geralmente mostram uma ferramenta de verificação e um CRM lado a lado, mas ignoram as questões de design: quando disparar a verificação, o que armazenar e o que fazer com resultados que não podem ser decididos. Comece pelos gatilhos.
- Contato criado a partir de um formulário, uma importação ou um representante de vendas inserindo um lead.
- Número de telefone alterado em um registro existente, pois o resultado antigo não se aplica mais.
- Antes da inscrição em uma sequência de WhatsApp, quando o resultado armazenado é mais antigo do que a janela de re-verificação escolhida pela sua equipe.
Evite verificações agendadas de todo o banco de dados. Cada verificação concluída é cobrada, independentemente de o número estar registrado ou não, portanto, verificar registros inalterados repetidamente consome saldo sem adicionar informações.
Projetando o fluxo de trabalho de CRM para verificação de WhatsApp passo a passo
- Normalize o número. Converta o valor do telefone armazenado para E.164 usando o campo de país do registro: código do país, número nacional, sem o zero inicial. Registros que não podem ser normalizados recebem uma tag de "precisa de revisão" em vez de uma verificação.
- Desduplique. Se dois registros compartilharem o mesmo número normalizado, verifique-o uma vez e grave o resultado em ambos.
- Chame a verificação em tempo real. Uma automação de CRM ou etapa de middleware envia
POST /api/v1/checkcom o cabeçalhoX-API-Key, o número em E.164 e oservice_typeselecionado para a Verificação de registro no WhatsApp. O resultado retorna na mesma resposta, para que o fluxo de trabalho possa continuar sem polling. - Trate importações em grupos. Para uma importação CSV de algumas centenas de leads,
POST /api/v1/batch-checkaceita até 100 números por solicitação. Uma limpeza única de uma base histórica muito grande se ajusta melhor a uma tarefa de arquivo em lote: faça o upload, aguarde, baixe o arquivo de resultado e, em seguida, mapeie as linhas de volta pelo número de telefone. - Grave e marque. Armazene o resultado e a data da verificação no registro e, em seguida, deixe que as regras de fluxo de trabalho do CRM apliquem tags e inscrevam o contato.
Armazene a chave de API nos segredos ou configurações de integração do CRM, nunca em um campo de contato ou em uma planilha compartilhada.
Propriedades e tags que vale a pena armazenar
Mantenha o esquema pequeno e legível para os usuários de vendas. Um conjunto típico de propriedades personalizadas, definido pela sua equipe:
| Propriedade | Valores sugeridos | Objetivo |
|---|---|---|
| Resultado da verificação de WhatsApp | Registrado / Não registrado / Indeterminado / Não verificado | Define a elegibilidade da sequência |
| Última verificação de WhatsApp | Data | Suporta regras de re-verificação |
| Tipo de verificação de WhatsApp | Registro, Foto de perfil, Conta comercial | Registra qual verificação produziu o resultado |
| Conta WhatsApp Business | Sim / Não / Não verificado | Preenchido apenas quando a Verificação de conta WhatsApp Business foi executada |
"Indeterminado" é importante. Uma verificação que não pode ser decidida retorna um código de negócio diferente de zero e nunca deve ser armazenada como "Não registrado". Da mesma forma, um "Não" na propriedade de conta comercial significa apenas que o sinal de conta comercial estava ausente; isso não mostra que o contato é pessoal ou não afiliado a uma empresa.
Regras de acompanhamento que respeitam os limites do sinal
Uma vez que os resultados são armazenados, as regras de fluxo de trabalho podem se ramificar com base neles:
- Registrado e com opt-in: elegível para a sequência de WhatsApp, sujeito às regras do seu próprio provedor de mensagens.
- Registrado sem opt-in: mantenha o contato via e-mail ou telefone até que o consentimento seja coletado. A WhatsApp Business Messaging Policy exige opt-in antes que uma empresa entre em contato com alguém e exige o cumprimento de solicitações de opt-out, incluindo a remoção de listas de contatos.
- Não registrado: envie acompanhamentos por e-mail, SMS ou chamadas em vez de um modelo de WhatsApp.
- Indeterminado: aguarde uma nova tentativa posterior e mantenha o contato fora das etapas exclusivas de WhatsApp até que um resultado concluído exista.
Um resultado registrado é um sinal de presença de conta específico da plataforma no momento da verificação. Números podem ser reatribuídos, portanto, uma janela de re-verificação (por exemplo, antes de cada nova campanha) evita que as tags fiquem obsoletas.
Operando a integração
- Monitore o saldo. O painel mostra saldo, chaves de API, histórico de validação e status de tarefas em lote; as integrações podem ler o saldo através de
GET /api/v1/balanceantes de uma grande importação. - Respeite os controles de uso. A API documenta controles de simultaneidade e tempo limite por usuário. Dimensione os trabalhadores paralelos de acordo com esses controles e consulte a documentação atual da API em vez de assumir uma taxa de solicitação fixa.
- Registre falhas separadamente. Erros de rede e verificações indeterminadas pertencem a um log de erros com um tempo de nova tentativa, não à propriedade de resultado do contato.
- Mantenha o formato consistente. A orientação da Meta sobre formato de número de telefone mostra que números sem o sinal de mais e o código do país podem ser resolvidos para o destinatário errado, portanto, o número normalizado usado para a verificação também deve ser o usado para o envio.
Perguntas frequentes
Como as equipes podem evitar pagar por verificações repetidas no mesmo contato?
Acione a verificação apenas na criação do contato, em alterações de número de telefone ou na inscrição após o término da janela de re-verificação, e desduplique os números normalizados antes de chamar a API. Armazene a data da última verificação para que a automação possa pular registros com um resultado concluído recente.
O que um CRM deve armazenar quando uma verificação não pode ser decidida?
Armazene um valor separado, como Indeterminado, registre a tentativa e agende uma nova tentativa. Uma verificação indeterminada não é um resultado concluído de não registrado, portanto, não deve mover o contato para o acompanhamento fora do WhatsApp permanentemente.
Qual chamada de API se ajusta a uma importação de CRM de algumas centenas de leads?
O endpoint síncrono múltiplo, POST /api/v1/batch-check, aceita até 100 números por solicitação e retorna resultados na mesma resposta, portanto, algumas centenas de leads podem ser processados em várias solicitações. Limpezas históricas muito grandes se ajustam melhor a uma tarefa de arquivo em lote.
O resultado de conta comercial pode ser usado para segmentação B2B?
Pode ser um dos insumos. Quando a Verificação de conta WhatsApp Business é selecionada, o resultado mostra se a conta é uma conta WhatsApp Business. Ele identifica apenas o tipo de conta e não confirma uma empresa registrada ou permissão para entrar em contato.
Saiba mais
Escolha as informações do produto que se ajustam à próxima etapa do seu fluxo de trabalho.