aideskCentral de ajuda Entrar no aidesk

Como conectar o WhatsApp

Quem pode fazer: Proprietário, Administrador · Atualizado em 9 de outubro de 2026

Ao conectar um número de WhatsApp, as mensagens dos seus clientes passam a chegar na Inbox da aidesk, e o seu time responde por lá. A conexão é feita pelo cadastro oficial da Meta, numa janela segura do Facebook.

Qual opção escolher

A aidesk oferece duas formas de conectar, e as duas usam a API oficial da Meta:

  • WhatsApp Cloud API: para um número dedicado ao atendimento pela aidesk. É a opção mais comum para quem está começando ou vai usar um número novo.
  • WhatsApp Business API: para continuar usando o app WhatsApp Business no celular com o mesmo número (coexistência). A aidesk também traz seus contatos e o histórico de conversas do app.

Não existe conexão por QR code ou por API não oficial.

Antes de começar

  • Você precisa ser Proprietário ou Administrador com permissão para conectar canais.
  • Tenha em mãos o login do Facebook com acesso ao gerenciador de negócios da empresa (Meta Business).
  • Para a opção WhatsApp Business API, o número já precisa estar ativo no app WhatsApp Business do celular.
  • Libere pop-ups para o site da aidesk no navegador.

Passo a passo

  1. Abra Configurações › Relacionamento › Canais.
  2. Clique em Conectar canal.
  3. Escolha WhatsApp Cloud API ou WhatsApp Business API.
  4. A janela da Meta abre sozinha. Se não abrir, clique em Continuar com Meta.
  5. Na janela da Meta, entre com seu Facebook, escolha a empresa, a conta do WhatsApp Business e o número, e conclua o cadastro.
  6. Ao terminar, a janela fecha e aparece o aviso "WhatsApp conectado. Ativação do número em andamento…".

Enquanto a janela da Meta estiver aberta, a aidesk mostra "Aguardando conclusão do cadastro na janela da Meta…". Se você fechou a janela sem querer, use Abrir novamente.

Depois de conectar

O número aparece na lista de canais com o status Pendente enquanto a Meta conclui a ativação. A tela se atualiza sozinha. Quando terminar:

  • o status muda para Ativo;
  • Proprietários e Administradores recebem a notificação "Canal WhatsApp ativado".

Para testar, mande uma mensagem de outro celular para o número. Ela deve aparecer na Inbox.

Na engrenagem Configurações do canal você encontra o nome do canal, os modelos de mensagem, os Flows e os avisos da conta. Modelos, Flows e avisos só ficam disponíveis com o canal Ativo.

Status do canal

  • Pendente: a Meta ainda está ativando o número. Normalmente leva poucos minutos.
  • Ativo: pronto para receber e enviar mensagens.
  • Falha na ativação: a Meta não concluiu a ativação. Exclua o canal e conecte de novo; se persistir, fale com o suporte da aidesk.
  • Pausado ou Desconectado: o canal não está enviando nem recebendo mensagens.

Problemas comuns

  • "Não foi possível carregar o SDK da Meta.": o navegador bloqueou o script do Facebook. Desative bloqueadores de anúncio para o site da aidesk e tente de novo.
  • "Cadastro cancelado ou não autorizado na Meta.": a janela da Meta foi fechada ou a permissão foi negada. Comece de novo e conclua todas as etapas.
  • "Cadastro interrompido pela Meta.": a Meta encerrou o cadastro com erro. Confira se você tem acesso de administrador à empresa no Meta Business e tente de novo.
  • "Este número WhatsApp já está conectado nesta organização.": o número já está na lista de canais. Não é preciso conectar de novo.
  • O botão Conectar canal não aparece: seu usuário não tem permissão para conectar canais. Peça a um Proprietário ou Administrador.

Desconectar um número

Na lista de canais, clique na lixeira Excluir canal. O canal para de receber e enviar mensagens, mas o histórico das conversas continua salvo, e o número pode ser conectado de novo depois.