Conectar via Coexistência

1385 views

Como conectar a API Oficial do WhatsApp

A integração com a API Oficial do WhatsApp (Meta) permite utilizar seu número de WhatsApp diretamente na plataforma da UnderChat com toda a segurança e estabilidade da infraestrutura oficial da Meta.

Durante a integração, você fará login na sua conta do Facebook, selecionará sua empresa (BM/Portfólio Empresarial) e autorizará o compartilhamento da sua conta do WhatsApp Business com a UnderChat.

Acesse o menu Canais

Após fazer login na plataforma:

No menu lateral esquerdo, clique em Canais.
Clique em + Adicionar.

Selecione o tipo de conexão

Na tela de criação do canal:

Selecione WhatsApp Oficial.
Informe um nome para identificar este canal.
Clique em Conecte-se com WhatsApp Business.

Selecionando WhatsApp Oficial — Clique para expandir

Será aberta uma janela oficial da Meta para realizar a integração.

Faça login na Meta

Caso ainda não esteja autenticado, faça login utilizando sua conta do Facebook que possui acesso ao seu Portfólio Empresarial (BM).

Em seguida, clique em Continuar.

Escolha sua conta do WhatsApp Business

Agora selecione o Portfólio Empresarial (BM) onde está o seu número.

Caso seu número já esteja cadastrado em uma conta do WhatsApp Business, escolha a opção:

Conectar um app do WhatsApp Business.

Selecionando conta do WhatsApp Business — Clique para expandir

Se este for o primeiro número da empresa, a Meta poderá solicitar a criação de uma nova Conta do WhatsApp Business antes de continuar.

Informe o número do WhatsApp

Digite o número que deseja conectar, incluindo o DDD correto.

Caso o número ainda não esteja vinculado ao Portfólio Empresarial, a Meta solicitará uma verificação por código SMS ou ligação telefônica.

Autorize o compartilhamento da conta

A Meta exibirá uma tela informando quais permissões serão compartilhadas com a UnderChat.

Leia as informações e clique em Avançar.

Compartilhamento de acesso — Clique para expandir

Esse compartilhamento é necessário para que a UnderChat possa enviar e receber mensagens utilizando a API Oficial da Meta.

Conclua a ativação no WhatsApp

Após clicar em Avançar, a Meta exibirá um QR Code para concluir a ativação da conexão.

Ao mesmo tempo, uma mensagem será enviada para o WhatsApp do número que está sendo conectado, contendo um botão para iniciar a leitura do QR Code.

Abra o WhatsApp no celular.
Toque no botão enviado pela Meta.
A tela de leitura do QR Code será aberta automaticamente.
Aponte a câmera para o QR Code exibido na janela do navegador.

Esse processo utiliza a tecnologia de Coexistência. Isso significa que o WhatsApp continuará funcionando normalmente no seu celular enquanto também ficará conectado à API Oficial da Meta na UnderChat.

Importante

Após realizar a leitura do QR Code, não feche a janela da Meta imediatamente.

Aguarde a conclusão de todas as etapas e, quando for exibido o botão Concluir, clique nele para finalizar corretamente a integração.

⚠️ Atenção: A conexão somente será concluída com sucesso após finalizar todas as etapas na janela aberta pela Meta e clicar em Concluir. Fechar a janela antes disso poderá impedir que a integração seja finalizada corretamente.

Finalize a integração

Após concluir todas as etapas:

A janela da Meta será encerrada automaticamente.
Você retornará para a UnderChat.
O canal será criado e ficará disponível na lista de canais.

Dependendo da configuração da Meta, a ativação poderá levar alguns instantes até que o número fique totalmente disponível para envio e recebimento de mensagens.

Dúvidas frequentes

Preciso ter uma BM (Portfólio Empresarial)?

Sim. Toda integração com a API Oficial utiliza um Portfólio Empresarial da Meta.

Caso ainda não possua um, consulte nosso tutorial de criação da BM antes de realizar esta integração.

Meu número continuará funcionando normalmente?

Sim. Após a migração para a API Oficial, seu número continuará sendo utilizado normalmente, porém passará a operar através da infraestrutura oficial da Meta.

Preciso confirmar meu número?

Se o número ainda não estiver cadastrado no Portfólio Empresarial, a Meta poderá solicitar uma confirmação por SMS ou ligação durante o processo.

🎉 Pronto!

Agora seu canal está conectado à API Oficial do WhatsApp e pronto para ser utilizado na UnderChat.

Caso encontre qualquer dificuldade durante a integração, entre em contato com nossa equipe de suporte.