Sincronizar contatos do WhatsApp

O que é

Um botão em Contatos que puxa, com um clique, todos os contatos do celular conectado ao Rumo CRM via WhatsApp (número uazapi) pra dentro do CRM. Traz três fontes de uma vez:

• Agenda: todos os contatos salvos no número.
• Conversas: quem já trocou mensagem com você.
• Grupos: participantes de todos os grupos do número.

Como usar

Em Contatos, clique em Sincronizar do WhatsApp. A sincronização roda em segundo plano — pode sair da tela. Quando termina, aparece um aviso com quantos contatos entraram e quantos eram novos.

Onde os contatos aparecem

Entram na base como lead frio (não qualificado) — ficam na aba Leads frios e não poluem o pipeline. Todos recebem a tag WhatsApp, então dá pra filtrar por essa tag em Contatos ou montar uma segmentação salva.

É seguro rodar de novo

A sincronização é idempotente: ela não duplica quem você já tem (a base usa telefone único por organização). Rodar de novo só traz os contatos que faltavam e reaplica a tag. Se um contato já existia sem nome e a agenda do celular tem o nome, o Rumo CRM preenche.

Requisitos

Só precisa de um número WhatsApp conectado (Configurações → Integrações). Não depende do módulo de IA. Se não houver número conectado, o botão avisa.

Grupos: limite por rodada

Agendas com muitos grupos são truncadas em 300 grupos por rodada pra não travar o processo (cada grupo é uma consulta ao WhatsApp). Se sobrar grupo, o aviso no fim diz quantos ficaram de fora — é só sincronizar de novo pra pegar o resto.

Diferença pro extrator do ICR Builder

O ICR Builder → Extrair contatos faz o mesmo tipo de coleta, mas o objetivo dele é montar uma lista de disparo pronta pra campanha (cria uma ContactList nova a cada extração). A sincronização em Contatos não cria lista — joga tudo na base com a tag WhatsApp. Use a sincronização pra manter o CRM em dia com a agenda; use o extrator quando quiser uma lista fechada pra uma campanha específica.