Etiquetas do WhatsApp Business
Se o seu número usa o WhatsApp Business, a sua equipe provavelmente marca as conversas com etiquetas: Lead, Cliente, Pagamento pendente e as que vocês mesmos criaram no celular. O DevZap leva essas etiquetas para o sistema que você conectou a ele (ERP, CRM, chatbot).
Não há nada para ligar no painel: vale para todo número conectado.
O que o seu sistema passa a fazer
- Ver as etiquetas do número, com quantos contatos cada uma tem.
- Ver quem tem cada etiqueta: a lista de contatos e grupos marcados.
- Pôr e tirar etiqueta de um contato. A mudança aparece no celular da equipe.
- Ficar sabendo na hora quando alguém da equipe cria, renomeia, apaga, põe ou tira uma etiqueta no celular.
As etiquetas que já existiam antes de você conectar o número também entram: logo depois de conectar, o DevZap busca todas no WhatsApp.
Receber os avisos de etiqueta
Os avisos chegam pelo webhook da instância, e só se você pedir:
- Abra Webhooks no menu.
- No webhook da instância, marque os eventos do grupo Etiquetas: Etiqueta criada ou alterada, Etiqueta apagada, Etiqueta aplicada e Etiqueta removida.
- Salve.
Quem já tinha um webhook configurado não passa a receber nada novo sem marcar esses eventos.
Permissão das chaves
As chaves de API criadas no painel já podem usar as etiquetas. Aplicativos conectados por OAuth, como o ERP que pediu acesso à sua conta, também: a permissão de etiquetas foi incluída nos acessos já aprovados, sem precisar conectar de novo.
O que continua no celular
- Criar, renomear e apagar etiquetas. O seu sistema lê as etiquetas e põe ou tira de um contato, mas quem cria e organiza a lista é a equipe, no WhatsApp Business.
- As listas do WhatsApp ("Não lidas", "Favoritos", "Grupos") não aparecem para o seu sistema: elas são filtros do aplicativo, não etiquetas.
- O nome do contato. O DevZap não guarda nomes. O seu sistema recebe o telefone e cruza com o cadastro que já tem.
Etiqueta não é lista de disparo
Etiqueta serve para organizar quem já conversa com você. Mandar a mesma mensagem para todos de uma etiqueta de uma vez é o tipo de uso que faz o WhatsApp restringir o número. Se o seu sistema mandar mensagens para os contatos de uma etiqueta, que seja aos poucos, com texto pensado para cada pessoa. O guia Mensagem recusada (erro 463) explica o que acontece quando o WhatsApp barra primeiros contatos.
Para quem integra, o passo a passo técnico está no guia Etiquetas da documentação de integração.