Sincronize grupos do WhatsApp no seu CRM

Resumo

Grupos do WhatsApp são a matéria escura do WhatsApp Business. A maioria dos CRMs ignora ou empilha tudo num "contato desconhecido" genérico. O Wazzap modela cada grupo como conversa de primeira classe, indexada pelo ID do grupo, com avatar e nome puxados direto do WhatsApp.

Cada mensagem de entrada e saída que o seu número envia dentro de qualquer grupo do qual ele faz parte aparece na aba de Conversations do CRM. Os agentes veem quem disse o quê (com o número do participante), podem responder para o grupo inteiro, mencionar contatos e disparar workflows do mesmo jeito que um chat 1 a 1.

Como funciona

1. Seu número conectado ao Wazzap entra (ou já está) em um grupo do WhatsApp.
2. O Wazzap detecta o grupo automaticamente e mostra no CRM como uma conversa nova.
3. As mensagens de entrada do grupo aparecem na conversa conforme chegam.
4. Para enviar para o grupo, responda pelo mesmo compositor e o Wazzap cuida do roteamento.

Receber mensagens de grupo

Sem setup. Assim que seu número está no grupo, as mensagens começam a chegar no CRM. Cada mensagem traz metadados úteis:

• Telefone do remetente. O número real do WhatsApp de quem escreveu.
• Nome do remetente. O display name que ele usa no WhatsApp.
• ID do grupo. Usado para endereçar respostas. Parece com 120363025xxxxxxxx@g.us.
• Nome e avatar do grupo. Puxados direto do WhatsApp.

Enviar para grupos

Para mandar uma mensagem para o grupo a partir do CRM, mire no ID do grupo em vez de um número individual:

to: 120363025XXXXXXXX@g.us
body: Pessoal, o resumo da semana já saiu 👇

Pela integração com o HighLevel, responder pela aba da conversa já cuida do endereçamento. Pela REST API, você passa o endereço @g.us como destinatário no seu POST /messages de sempre.

Onde encontrar o ID do grupo

O jeito mais fácil: abra o grupo no seu CRM e veja o cabeçalho da conversa. O Wazzap mostra o ID ali.

Para descobrir via API:

curl https://api.wazzap.mx/v4/groups \
  -H "Authorization: Bearer $WAZZAP_KEY"

A resposta lista cada grupo em que o seu número está, com ID, nome e contagem de participantes.

Limites do beta

• Confirmação de leitura por participante não sincroniza. O WhatsApp não expõe isso por usuário em grupos.
• Eventos só-admin (membro adicionado, removido, grupo renomeado) sincronizam como mensagens do sistema, não como triggers.
• Enquetes chegam como descrição em texto, não como widget interativo.
• Menções com @ entrantes sincronizam como texto puro, mas as menções de saída funcionam nativas.
• O grupo precisa ter o seu número como membro. O Wazzap não consegue ler grupos em que você não está.

Solução de problemas

As mensagens do grupo não aparecem no meu CRM

Confirme que o seu número do Wazzap é membro do grupo (abra o WhatsApp no celular e cheque). Se está, atualize com força o CRM e olhe na aba de Conversations. A primeira mensagem que chega depois do número entrar é o que dispara a criação da conversa.

Minha resposta de saída vai para o lugar errado

Cheque duas vezes se o ID do destinatário termina com @g.us. Um número comum termina em @s.whatsapp.net internamente. São espaços de endereço diferentes, e um typo manda silenciosamente para o chat 1 a 1 em vez do grupo.

Estou levando rate limit dentro de um grupo movimentado

Pisa no freio nos envios. O WhatsApp limita bots que inundam grupos ainda mais agressivamente do que spam 1 a 1. Coloque um delay de 3 a 5 segundos entre envios consecutivos, ou use o comando delay message para drips agendados.