Devido a alterações nas políticas oficiais da API da Meta, este artigo "Tutorial de Acesso a Números via API na Nuvem" está temporariamente indisponível. Clique aqui para visualizar o tutorial mais recente.![]() |
Este artigo explica e orienta apenas sobre como conectar o número da API Cloud do WhatsApp ao sistema SaleSmartly. Se você ainda não criou um número da API Cloud do WhatsApp, pode consultar o seguinte link: Tutorial do Facebook sobre como criar um número da API Cloud do WhatsApp – Central de Ajuda do SaleSmartly
1. Criar um aplicativo
Acesse o painel de desenvolvedores do Meta, em https://developers.facebook.com/apps/create/. Selecione o tipo "Negócios" e crie um aplicativo.


Conta da Plataforma de Gestão Empresarial - Selecione o número da Plataforma de Gestão Empresarial a ser vinculado. Um aplicativo pode ser vinculado a um número de Plataforma de Gestão Empresarial. A conta WABA e o número associado ao número da Plataforma de Gestão Empresarial serão sincronizados com o painel do SaleSmartly para integração e gerenciamento de chat.

Após a criação, no painel de controle do aplicativo, selecione o WhatsApp e clique em Configurações.
| Observação: Restrições oficiais limitam o acesso e o uso dos produtos da API em nuvem do WhatsApp apenas a desenvolvedores do Facebook registrados com contas vinculadas a números estrangeiros (restrito na China). |

2. Obtenha informações sobre o aplicativo
Em Configurações > Básico, abra as informações básicas do aplicativo criado anteriormente e obtenha o número do aplicativo, a chave do aplicativo e o ID do BM.

Preencha o número do aplicativo, a chave do aplicativo e o ID do BM acima nas configurações do aplicativo no painel do SaleSmartly, nos campos "AppId", "Secret" e "Bind BM number Id", respectivamente.

3. Adicionar permissões de usuário no BM
Abra o painel de controle da sua empresa no Facebook, https://business.facebook.com/settings/. Na sua conta Business Manager (BM), clique em "Usuário do sistema - Adicionar", selecione a identidade "Administrador" e clique em "Criar usuário do sistema".
Se você não conseguir criar um "Administrador", consulte as instruções abaixo e utilize o método "Criar Funcionário".

Clique no usuário do sistema que você acabou de adicionar, abra o painel de detalhes do usuário e clique em "Adicionar ativo".

Na janela pop-up abaixo, selecione o aplicativo que você criou anteriormente em "Selecionar ativos", habilite a permissão "Gerenciar aplicativos" e clique em "Salvar alterações". Observe que você deve atribuir ativos ao usuário administrador do sistema, ou seja, ao aplicativo de API em nuvem correspondente.

Se o Facebook BM não conseguir criar um usuário administrador do sistema, você pode criar um usuário da equipe.
Se um administrador já tiver sido criado, esta etapa poderá ser ignorada.

Após a criação, você precisa autorizar todas as permissões da conta do WhatsApp para poder usá-la com permissões de equipe.

Nesse momento, clique no botão "Gerar nova senha".

Selecione o aplicativo, marque a opção criada anteriormente e clique em Gerar Token.

Em seguida, verifique as três permissões: business_management, whatsapp_business_messaging e whatsapp_business_management. Após verificar, clique em "Gerar senha" novamente.

Copie o token de acesso da imagem abaixo.

Cole o token de acesso acima no painel do SaleSmartly - Terceiros - Acessar número da API de terceiros - Token.

4. Adicione informações no SaleSmartly para concluir a vinculação.
Quando os campos "Appid", "Secret", "Token" e "Bound BM number id" estiverem preenchidos, clique em "Next" para acessar. Se o acesso for bem-sucedido, os primeiros 50 números do Waba serão importados automaticamente. Os números que excederem 50 não serão importados automaticamente. Você deverá clicar manualmente no botão "Sincronizar número". Após a sincronização ser concluída, o serviço poderá ser usado normalmente. Clique em "Ativar" no número correspondente e você poderá selecionar o número da API Cloud correspondente para importar contatos, transmissões de mensagens e chats.

Por fim, no painel de desenvolvedor do Meta, https://developers.facebook.com/apps/create/, certifique-se de alterar o status do aplicativo que você criou anteriormente para "Online" (lembre-se de iniciar o aplicativo).

Neste ponto, o acesso ao número da API em nuvem foi concluído.
PS: Aprenda como criar um número na API do Cloud.
Perguntas frequentes
(1) Crie um aviso no aplicativo que diga “Você está temporariamente proibido de realizar esta operação”

Motivo: Há um problema com a conta do Gerenciador de Negócios do Facebook (BM). Verifique, por favor.
(2) O conteúdo solicitado não pode ser exibido neste momento.
Possíveis motivos: o conteúdo está temporariamente indisponível, o link expirou ou você não tem permissão para visualizá-lo.
O aplicativo foi excluído ou bloqueado, e o número do WhatsApp associado também foi bloqueado. Tente usar um número do Facebook diferente.

(3) O URL da política de privacidade é inválido.

O cenário é o seguinte: ao ativar o modo de aplicativo, a opção de desenvolvedor online solicita que você forneça um URL de política de privacidade válido para disponibilizar o aplicativo na loja. Acesse as configurações básicas e verifique se o URL é válido.
Solução: Acesse as Configurações básicas , insira o URL da política de privacidade, salve as alterações no canto inferior direito e ative novamente a opção "Desenvolvedor online" no Modo Aplicativo .
| Aviso: Recomenda-se que o endereço do site seja real e válido. É melhor ter seu próprio endereço de site. |
