Sincronizar contatos do WhatsApp

O que é

Um botão em Contatos que puxa, com um clique, todos os contatos do celular conectado ao Teha 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 Teha 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.