Sincronizar contatos do WhatsApp

O que é

Um botão em Contatos que puxa os contatos do celular conectado ao Teha via WhatsApp (número uazapi) pra dentro do CRM. Ao clicar em Sincronizar do WhatsApp, você escolhe o que trazer:

• Contatos salvos no telefone: só quem está salvo na agenda do celular, com o nome salvo.
• Contatos salvos no telefone + conversas: os salvos e também quem já conversou com o número e não está salvo na agenda.

Participantes de grupos não entram na sincronização (num número comum são milhares de desconhecidos sem nome). Pra montar lista com participantes de grupos, use o ICR Builder → Extrair contatos.

Como usar

Em Contatos, clique em Sincronizar do WhatsApp e escolha uma das duas opções. 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 em Contatos, sem criar negócio no 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. Quando o mesmo número aparece na agenda e numa conversa, vale o nome salvo na agenda.

Requisitos

Só precisa de um número WhatsApp conectado (Configurações → Integrações) pela conexão via QR Code (uazapi). Número da API oficial da Meta não dá acesso à agenda do celular. Não depende do módulo de IA. Se não houver número conectado, o botão avisa.

Diferença pro extrator do ICR Builder

O ICR Builder → Extrair contatos faz uma coleta parecida (podendo incluir participantes de grupos), 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.