Columba · Docs

Tema

Conectar WhatsApp via QR Code ​

Esta é a forma mais simples de conectar um número de WhatsApp ao Columba: você lê um QR Code com o próprio aplicativo do WhatsApp, do mesmo jeito que conecta o WhatsApp Web.

Criar a instância ​

  1. Acesse Configurações → Conectores.
  2. Na seção WhatsApp, clique em Nova instância.
  3. Preencha o Nome da instância (para identificar este número no painel).
  4. Em Tipo de conexão, selecione QR Code.
  5. Se quiser, abra Configurações avançadas para ajustar o comportamento da instância (veja abaixo).
  6. Clique em Criar instância.

Depois de criada, o Columba abre automaticamente a janela com o QR Code.

Ler o QR Code ​

  1. Com a janela Conectar WhatsApp aberta, pegue o celular com o número que você quer conectar.
  2. Abra o WhatsApp.
  3. Toque em Mais opções ou Configurações.
  4. Selecione Dispositivos conectados.
  5. Escaneie o QR Code exibido na tela do Columba.

Quando a leitura for concluída, a janela mostra "Conectado com sucesso!" e fecha automaticamente.

Se a instância já existir e estiver desconectada, use o botão Ver QR Code (ou Conectar) no card da instância, na página de Conectores, para abrir a mesma janela.

Dica

Se você já usa o WhatsApp Web em outro navegador, use o mesmo caminho: WhatsApp → Aparelhos conectados. O Columba aparece como mais um aparelho conectado.

Expiração do QR Code e reconexão ​

O WhatsApp troca o QR Code a cada 45 segundos. A janela do Columba acompanha essa troca em tempo real: o contador Expira em mostra quanto tempo o QR atual ainda vale e a imagem é substituída automaticamente quando o WhatsApp gera outra. Por isso, escaneie assim que o QR aparecer — não espere o contador chegar perto do zero.

Se o QR ficar cerca de 20 minutos sem nenhuma leitura, o WhatsApp desiste da sessão e a janela mostra O QR Code expirou. Isso não é um problema da sua conta: clique em Gerar novo QR Code e leia o novo.

O celular disse "Não foi possível conectar o dispositivo"

Essa mensagem aparece no WhatsApp quando o QR lido já tinha sido trocado ou quando a leitura demorou demais. Gere um novo QR Code no Columba e escaneie logo que ele aparecer. Se continuar, use a conexão por código.

Conectar com código (sem câmera) ​

Se não der para escanear (câmera com problema, celular sem acesso à tela do Columba, ou o QR falhando repetidamente), conecte digitando um código no próprio WhatsApp:

  1. Na janela Conectar WhatsApp, clique em Não consegue escanear? Conectar com código.
  2. Informe o número do WhatsApp que você quer conectar, com DDD (ex.: (41) 99999-8888). Para números de outro país, digite com o sinal de + e o código do país.
  3. Clique em Gerar código. O Columba mostra um código de 8 caracteres, no formato XXXX-XXXX.
  4. No celular com esse número, abra o WhatsApp → Dispositivos conectados → Conectar dispositivo.
  5. Toque em Conectar com número de telefone e digite o código.

Quando o WhatsApp confirmar, a janela mostra "Conectado com sucesso!" e fecha automaticamente. Se o código expirar, clique em Gerar novo código; para voltar ao QR, use Usar QR Code.

Atenção

Se o número for desconectado do WhatsApp (por exemplo, você removeu o "aparelho" pelo celular, ou o WhatsApp encerrou a sessão), a instância volta ao status Desconectado ou Bloqueado na página de Conectores. Para reconectar, gere um novo QR Code e leia novamente pelo celular.

Configurações avançadas ​

Ao criar a instância (ou depois, pelo botão Configurações no card), você pode ajustar:

OpçãoO que faz
Rejeitar chamadasRejeita automaticamente chamadas de voz e vídeo recebidas neste número. Ao ativar, você pode definir uma mensagem ao rejeitar chamada, enviada para quem ligou.
Ignorar gruposNão processa mensagens vindas de grupos do WhatsApp.
Sempre onlineMantém o status deste número sempre como "online".
Marcar como lidoMarca automaticamente as mensagens recebidas como lidas.
Enviar confirmação de leituraEnvia os tiques azuis de confirmação de leitura para quem enviou a mensagem.
Assinar com o nome do atendenteDesligado por padrão. Ao ativar, toda mensagem enviada pelo chat por este número sai com o nome de quem atendeu em negrito na primeira linha (o nome cadastrado em Equipe). Vale para texto e legendas de mídia; áudios e figurinhas saem sem assinatura, e respostas automáticas dos fluxos não são assinadas. Veja Enviar mensagens.

Leia também ​