Como funciona

A assistência conecta um número de WhatsApp ao AtmusOS. Com o número conectado, os avisos automáticos das OS podem ser enviados por WhatsApp. A caixa de entrada é opcional: só precisa ser usada por quem também quer conversar com o cliente dentro do sistema.

Para que serve

  • Entregar os avisos automáticos das OS pelo canal que o cliente realmente lê.
  • (Opcional) Falar com o cliente sem sair do sistema e sem usar o celular pessoal de alguém.
  • (Opcional) Manter o histórico da conversa junto do cadastro do cliente e das OS dele.
  • (Fallback) Abrir o WhatsApp do celular/computador com mensagem pronta na transição para Pronta para retirada e depois da entrega — funciona mesmo se a sessão conectada aqui estiver fora. Não substitui a caixa de entrada nem os avisos automáticos.

Onde encontrar

Tela Caminho
Conexão Configurações → WhatsApp, ou /whatsapp/settings
Caixa de entrada Menu WhatsApp, ou /whatsapp

Conectar o número

  1. Vá em Configurações → WhatsApp.

  2. Clique em Conectar.

  3. Leia o aviso de risco e marque Entendi o risco e quero continuar:

    “O número conectado aqui fica dedicado à assistência. Usar o mesmo número em outro aplicativo de automação de WhatsApp ao mesmo tempo pode levar ao banimento pelo próprio WhatsApp.”

  4. Escaneie o QR code com o WhatsApp do celular (Aparelhos conectados → Conectar aparelho).

  5. O QR é renovado sozinho a cada ~20 segundos até o pareamento.

Conectado, a tela mostra a etiqueta de situação, o número e desde quando está conectado.

Desconectar encerra a sessão. O histórico das conversas permanece no sistema.

Respostas rápidas

Ainda em Configurações → WhatsApp, o bloco Respostas rápidas — “Uma por linha — atalho na caixa de entrada, se a assistência usar conversas” — guarda até 20 frases de até 300 caracteres. Só entram em cena se alguém usar a caixa de entrada.

A caixa de entrada

Quem só precisa dos avisos automáticos não precisa desta tela.

Lista de conversas (à esquerda): uma linha por cliente, com a última mensagem e a hora. Conversas fixadas vêm primeiro. O botão Arquivadas mostra as que saíram da lista principal.

Conversa (à direita): as mensagens, com o cabeçalho trazendo nome do cliente, telefone, aviso de digitando… e atalhos:

Atalho no cabeçalho O que faz
N OS Abre as ordens de serviço daquele cliente
Ícone de pessoa Abre a ficha do cliente
Lupa Busca dentro da conversa
Alfinete Fixa a conversa no topo
Caixa Arquiva a conversa
… Mais opções

O que dá para enviar

Tipo Como
Texto Campo de mensagem
Imagem, vídeo, áudio e PDF Anexo, arrastar-e-soltar ou colar (Ctrl+V)
Áudio gravado Botão de gravação, com prévia antes de enviar
Resposta a uma mensagem Citar a mensagem
Reação Emoji sobre a mensagem
Encaminhar Menu da mensagem → escolher outra conversa
Apagar Menu da mensagem — vira um marcador, não some da conversa
Contato da assistência Envia o cartão com nome e telefone das configurações
Localização da assistência Envia as coordenadas cadastradas nas configurações

O editor de imagem permite recortar, girar e redimensionar antes de enviar.

Tempo real

Mensagem recebida, confirmação de leitura, reação, foto de perfil e o aviso de “digitando” chegam sozinhos, sem recarregar. O contador de não lidas aparece ao lado de WhatsApp no menu.

Quando um envio demora ou falha

Falhas momentâneas de conexão são tentadas novamente pelo sistema. Se o botão parecer não responder, aguarde alguns segundos e confira a conversa antes de clicar outra vez: a mesma tentativa não cria uma segunda mensagem. Se o limite de envios da assistência for atingido, a tela informa para aguardar — não é necessário reconectar o número.

Mídias muito grandes ou formatos não suportados são recusados antes de entrar no storage. Reduza a foto ou envie como PDF quando fizer sentido.

Quando alguém novo manda mensagem

A conversa é ligada ao cadastro do cliente pelo telefone. Se o número ainda não existe, o AtmusOS cria um cadastro inicial com o nome que veio do WhatsApp (ou o próprio telefone quando o nome não veio). Assim a mensagem não se perde; depois a equipe pode completar os dados na ficha do cliente.

Da mesma forma, para enviar mensagem a um cliente ele precisa ter telefone cadastrado.

Avisos automáticos por WhatsApp

Com o WhatsApp conectado — independente de alguém abrir a caixa de entrada —, os avisos ao cliente tentam o WhatsApp primeiro, quando o cliente tem telefone. Qualquer impedimento — desconectado, sem telefone, falha no envio — faz o aviso cair para e-mail. O cliente nunca fica sem aviso por causa do WhatsApp.

Regras importantes

  • Um número por assistência.
  • Conectar exige consentimento explícito sobre o risco de banimento.
  • Há limite de envios por hora por assistência; ao estourar, o envio é recusado sem gravar nada.
  • Mídia recebida é guardada no próprio sistema, não fica dependendo de link externo que expira.
  • Apagar mensagem é marcação, não remoção: a conversa mostra que ali havia algo.
  • Se a conexão cair de forma inesperada, Proprietário e Administrador recebem uma notificação interna.

Quem pode fazer isso está detalhado em Papéis e permissões.

Problemas comuns

“Conecte o WhatsApp antes de usar a caixa de entrada” / “O WhatsApp está desconectado no momento” Reconecte em Configurações → WhatsApp.

“Este cliente não tem telefone cadastrado” Cadastre o telefone na ficha do cliente.

“Limite de mensagens por hora atingido — aguarde para enviar mais” Proteção contra bloqueio do número. Aguarde e tente de novo.

“Cadastre o nome e o telefone da assistência em Configurações antes de enviar o contato” Preencha os dados da empresa em Configurações.

“Cadastre a latitude e a longitude da assistência em Configurações antes de enviar a localização” Preencha as coordenadas em Configurações — pegue no Google Maps: encontre o endereço, toque em Compartilhar → Copiar coordenadas.

“Não é possível responder a essa mensagem” A mensagem citada nunca chegou a sair de verdade, então não há o que citar.

O QR code não aparece ou expira sem parear O QR é renovado a cada ~20 segundos. Se travar, clique em Reconectar — o sistema recria a instância quando ela fica presa.

Um cliente mandou mensagem e não apareceu Confira se o número recebido está no formato correto e se a conversa não foi arquivada. Números novos recebem um cadastro inicial automaticamente; abra a ficha criada para completar o nome e os demais dados.

A conexão cai sozinha Normalmente é o celular sem bateria, sem internet ou com a sessão encerrada no aparelho. Reconecte pelo QR.

Atalho com mensagem pronta (wa.me)

Além da sessão conectada e da caixa de entrada, o detalhe da OS oferece um atalho que abre o WhatsApp do aparelho/navegador com texto pronto e o link do portal:

  • Ao marcar a OS como Pronta para retirada (se o cliente tiver telefone).
  • Depois de Confirmar entrega (mesmo fluxo opcional da entrega).

Isso não substitui os avisos automáticos nem a caixa de entrada — é fallback quando a sessão Evolution cai ou o atendente quer mandar na hora pelo próprio WhatsApp. O atalho abre o WhatsApp externo e não cria uma mensagem na caixa de entrada do AtmusOS; use a caixa de entrada quando precisar manter o envio no histórico integrado.

Limitações conhecidas

  • Não é a API oficial do WhatsApp Business: o número fica sujeito às regras do WhatsApp comum.
  • Não há atendimento simultâneo com separação por atendente (fila, transferência de conversa).
  • Não há disparo em massa nem campanhas.

Funcionalidades relacionadas