Integração WhatsApp - Conectando seu número ao HAP
Passo a passo para conectar o seu próprio número de WhatsApp ao ERP, entender o que cada botão da tela faz e configurar os envios com segurança para evitar bloqueios.
Quando usar
Use quando precisar executar a rotina de Integrações no ERP.
Antes de começar
- Usuário com acesso a Configurações > Integrações > WhatsApp
- Celular com o WhatsApp instalado e com internet, para ler o QR Code
Visão geral
Agora você conecta o seu próprio número de WhatsApp direto no ERP e passa a controlar os envios de notificações e mensagens automáticas. Dá para gerenciar mais de um número, acompanhar cada mensagem enviada e ajustar regras de segurança para o WhatsApp não bloquear o seu número.
A tela fica em Configurações > Integrações > WhatsApp e tem três abas: Conexões (seus números), Envios (regras de segurança) e Logs (saúde do número e histórico).
Criando a instância
Uma instância é uma conexão de WhatsApp, ou seja, um número ligado ao ERP.
- 1
Abra Configurações > Integrações > WhatsApp. Na aba Conexões, em Criar nova instância, digite um nome que ajude a identificar o número, como Comercial Matriz.
Tela inicial da integração, com o campo Nome da instância e o botão Criar instância - 2
Clique em Criar instância. O sistema mostra o aviso "Instância criada. Conecte via QR Code." e a instância aparece na lista com o status Desconectada.
Instância recém-criada na lista, ainda com o status Desconectada
Conectando o seu número
Funciona como o WhatsApp Web que você já usa no dia a dia.
- 1
Na linha da instância, clique no botão azul Conectar (QR). Abre uma janela com um QR Code.
Janela Conectar instância com o QR Code e o botão Gerar novo QR Code - 2
No celular, abra o WhatsApp e vá em Aparelhos conectados (ou Dispositivos conectados), toque em conectar um aparelho e aponte a câmera para a tela do computador.
- 3
Se estiver com dificuldade para ler o QR Code, use a opção de conectar por código, que mostra um código para digitar no celular.
- 4
Quando a leitura terminar, o status da instância muda para Conectada.
Entendendo a lista de instâncias
No topo da página, as etiquetas mostram o resumo da integração: situação (Ativa ou Pendente), quantas instâncias existem e quantas estão conectadas.
| Coluna | O que mostra |
|---|---|
| Nome | O nome que você deu à instância. Em alguns casos o número conectado aparece junto do nome. |
| ID | Identificação da instância. |
| Status | Conectada (pronta para enviar) ou Desconectada (precisa conectar). |
| Assinatura | Se a cobrança da instância está Ativa. |
| Vencimento | Data de vencimento da assinatura, quando houver. |
| Ações | Os botões de cada instância, explicados a seguir. |
O que cada botão faz
Todos os botões ficam na coluna Ações, na linha de cada instância. O que você fizer vale só para aquela linha.
| Botão | O que faz |
|---|---|
| Conectar (QR) | Abre a janela com o QR Code para ligar o número do celular à instância. Use na primeira conexão ou para reconectar. |
| Status | Consulta e mostra a situação atual da conexão (se está conectada ou não). |
| Celular | Mostra os dados técnicos da conexão do celular. É útil para passar ao suporte quando precisar de ajuda. |
| Renomear | Troca o nome da instância, por exemplo de Suporte para Atendimento. O número conectado continua o mesmo. |
| Reiniciar | Reinicia a conexão. Use quando der uma travadinha ou os envios pararem de sair. |
| Desconectar | Desliga o número da instância. A instância continua existindo e você pode conectar de novo depois. |
| Restaurar sessão | Tenta recuperar a conexão anterior sem precisar ler um novo QR Code. |
| Fila | Mostra as mensagens que estão aguardando para serem enviadas por essa instância. |
| Mensagens | Abre o histórico das mensagens enviadas e recebidas pela instância. |
| Configurar envios | Define quais tipos de mensagem automática do ERP saem por este número. |
| Cancelar assinatura | Encerra a assinatura da instância, ou seja, a cobrança mensal dela. |
| Excluir | Remove a instância da lista. |
Celular
Abre uma janela com os dados técnicos da conexão daquela instância: o tipo de conexão, a situação (CONNECTED quando está tudo certo) e o número de identificação da instância.
Mensagens
Abre a lista das últimas mensagens da instância. Cada linha mostra:
- Data: dia e hora do envio.
- Status: em que ponto a mensagem está. SENDED é enviada pelo sistema, DELIVERED é entregue no celular do destinatário e READ é lida.
- Número: telefone do destinatário.
- Direção: se a mensagem foi enviada por você ou recebida.
- Tipo e Arquivo: se foi texto ou se tinha anexo.
- Mensagem: o texto enviado.
No topo da janela, Total mostra quantas mensagens estão na lista, Atualizar mensagens recarrega com o que acabou de sair e Fechar mensagens volta para a tela de conexões.
Configurar envios
Cada número pode ser dedicado a um tipo de mensagem. Marque os tipos que devem sair por este número:
- Notificação
- Fiscal
- Gestão de Ciclo de Vida do Produto
- Financeiro
- CRM
- LavinIA: contas a pagar pelo WhatsApp. Quem vincular o próprio WhatsApp em Segurança do acesso manda foto, áudio ou texto da conta; os outros contatos seguem no Atendimento.
Clique em Salvar configurações para gravar. Fechar sai sem salvar.
Testando o envio
No fim da aba Conexões, a área Testar envio permite mandar uma mensagem de teste antes de usar com clientes.
- 1
Em Número do destinatário, digite o seu próprio celular com DDD.
- 2
Em Mensagem, escreva o texto de teste.
- 3
Clique em Enviar teste. O sistema mostra o aviso de mensagem enviada com o status dela.
Regras de segurança na aba Envios
O WhatsApp é rigoroso com mensagens automáticas. Para proteger o seu número de bloqueios, a aba Envios traz as Configurações de compliance do seu número. Quando está tudo certo, aparece o aviso verde "Os envios deste usuário estão liberados no momento".
O sistema já vem com valores seguros. Você pode ajustar conforme a sua operação.
| Campo | Para que serve |
|---|---|
| Atraso mínimo e máximo entre mensagens (s) | Pausa, em segundos, entre uma mensagem e outra. O sistema sorteia um valor entre o mínimo e o máximo, para o envio parecer humano. |
| Atraso mínimo e máximo de digitação (s) | Tempo que o sistema simula "digitando" antes de enviar cada mensagem. |
| Limite por hora | Máximo de mensagens enviadas em uma hora. |
| Limite mensal | Máximo de mensagens enviadas no mês. |
| Percentual de falha para pausa automática | Se a porcentagem de mensagens com falha chegar a esse valor, o sistema pausa os envios sozinho. |
| Janela de falha (minutos) | Período usado para calcular o percentual de falha acima. |
| Respeitar palavras de opt-out automaticamente | Quando marcado, o cliente que pedir para parar de receber (por exemplo respondendo PARAR) deixa de receber mensagens. |
Os dois botões da aba:
- Salvar compliance: grava os valores que você alterou.
- Destravar envios: libera os envios depois de uma pausa automática, quando você já corrigiu o problema.
Saúde do número e boas práticas
A aba Logs funciona como um termômetro em tempo real do seu número. Ela mostra:
- Alertas importantes: avisos recentes de envio, como mensagens que falharam.
- Status do número: quanto você já enviou no mês, se os envios estão normais e se houve tentativas para números sem WhatsApp.
- Recomendações importantes: envie só para quem autorizou o contato, ofereça a opção de parar de receber (como "Responda PARAR para cancelar"), explique o motivo da mensagem e inclua o nome do cliente ou dados do pedido.
- Boas práticas: o sistema confere se o número tem WhatsApp antes do envio, acompanha os status de enviada, entregue e lida, e recomenda começar com poucas mensagens e aumentar aos poucos.
- Logs e auditoria: os botões Ver logs de compliance e Ver auditoria de consentimento abrem o histórico detalhado.
Problemas comuns
- O QR Code não conecta: ele expira em cerca de 20 segundos. Clique em Gerar novo QR Code e leia de novo, ou use a opção de conexão por código.
- A instância apareceu como Desconectada depois de funcionar: clique em Reiniciar. Se continuar, use Restaurar sessão. Se ainda assim não voltar, conecte de novo com Conectar (QR).
- Os envios pararam e aparece um aviso de pausa na aba Envios: o sistema pausou sozinho para proteger o número (muitas mensagens falharam em pouco tempo). Corrija os contatos e clique em Destravar envios.
- Aparece o alerta de tentativas com número sem WhatsApp: o telefone cadastrado do cliente não tem WhatsApp. Corrija o cadastro antes de enviar de novo.
- A mensagem fica como SENDED e não vira DELIVERED: o celular do destinatário pode estar desligado ou sem internet. Ela passa para entregue assim que ele voltar a ficar online.
- O celular conectado ficou sem internet ou foi desligado por muito tempo: o WhatsApp pode derrubar a conexão. Use Reiniciar ou Conectar (QR) para reconectar.