OmnichannelCentral de conhecimento
Canais de atendimento

Conectar uma API oficial do WhatsApp pelos dados da conta

Informe as credenciais autorizadas, valide o número e confira a ativação separadamente.

Onde encontrarConfigurações → Integrações → cartão do número WhatsApp → Conexão manual

Acessos externos

Abra a plataforma oficial em outra aba. Entre com a conta da sua empresa e confira o ativo ou projeto selecionado.

Antes de começar

  • Tenha permissão para administrar o canal e o recurso disponível na sua versão.
  • Obtenha os IDs e o token da conta oficial com o responsável técnico. O token precisa ter acesso ao aplicativo Meta, à conta e ao número indicados.

Passo a passo

  1. Em Integrações, localize o cartão do número que deseja configurar. Confira o nome e o telefone antes de abrir a conexão.
  2. Escolha o método manual e preencha ID da conta WhatsApp Business (WABA), ID do número de telefone e Token de acesso.
  3. Em um cartão de número já identificado, o ID do número pode ficar fixo. Para outro número, use o procedimento de adicionar uma conexão.
  4. Clique em Validar conta existente e aguarde o resultado. A validação confere a autorização; ainda não ativa o atendimento.
  5. Se houver recusa, leia o erro e confira os IDs preservados. O token pode ser limpo após a tentativa e precisar ser informado novamente.
  6. Após validar, confira a empresa e o número retornados. Conclua Ativar atendimento quando a conexão estiver correta e pronta para operar.
  7. Atualize o status e revise o fluxo de entrada. Homologue com uma conta de teste autorizada antes de iniciar a operação.

Resultado esperado

A conta e o número são validados; o atendimento só é ativado após a etapa correspondente.

Observações importantes

  • O formulário editável pertence às versões comerciais a partir de 1.0.55; a versão 1.0.60 separa melhor validação e ativação. Instalações anteriores podem apresentar outro procedimento.
  • Validar credenciais, salvar preferências e ativar o atendimento são ações diferentes.
  • Não cole tokens em conversas, notas, imagens de suporte ou páginas públicas. Use somente os campos protegidos da integração.
  • Se o número está em outro sistema, confirme com o responsável o procedimento de conexão ou migração antes de alterar a operação.
  • Os atalhos externos exigem login na Meta e acesso ao ativo. Confira o portfólio, a Página ou a conta WhatsApp selecionada. Se um atalho abrir a página inicial, use Configurações da empresa ou o WhatsApp Manager para escolher o ativo primeiro.

Se precisar de ajuda

  • Campos ausentes: confira a versão, o cartão selecionado e sua permissão administrativa.
  • Token recusado: confira aplicativo Meta, acesso à WABA e ao número; não utilize a senha de login do Omnichannel nesse campo.
  • Canal desconectado: conclua a validação e a ativação; salvar somente as preferências não conecta o número.