Saltar para o conteúdo principal
Use seu aplicativo da Meta e solução de parceiro para integrar clientes ao WhatsApp por meio do seu software. Conclua o Onboarding de parceiro de desenvolvimento técnico antes de seguir estas etapas. Para a opção de integração TP Lite, consulte Partner Direct Link.

Etapa 1: Adicionar domínios permitidos

Faça login no Painel de aplicativos do Meta for Developers e acesse Login do Facebook para Empresas > Configurações > Configurações do OAuth do cliente:
Captura de tela do produto YCloud
Defina as seguintes opções como Sim:
  • Login do OAuth do cliente
  • Login do OAuth da Web
  • Impor HTTPS
  • Login do OAuth do navegador integrado
  • Usar modo estrito para URIs de redirecionamento
  • Fazer login com o SDK do JavaScript
⚠️ Observações:
  • O Embedded Signup depende do SDK do JavaScript.
  • Quando os clientes corporativos concluem o fluxo do Embedded Signup, o respectivo WABA ID, o ID do número de telefone comercial e um código de token trocável são retornados para a janela que iniciou o fluxo, mas somente se o domínio dessa página tiver sido adicionado a ambos: Domínios permitidos e URIs de redirecionamento do OAuth válidos.
  • Adicione todos os domínios nos quais você planeja implantar o Embedded Signup (incluindo domínios de teste em ambientes de desenvolvimento).
  • Apenas domínios com suporte a HTTPS são compatíveis.

Etapa 2: Criar um ID de configuração do Login do Facebook para Empresas

Uma configuração do Login do Facebook para Empresas define quais permissões solicitar e quais informações adicionais coletar quando os clientes corporativos usam o Embedded Signup. No console, navegue até Login do Facebook para Empresas > Configurações.
Captura de tela do produto YCloud
Clique em Criar a partir de modelo e selecione Configuração do WhatsApp Embedded Signup com token de expiração de 60 dias para criar uma configuração. Este modelo gera uma configuração com as permissões e os níveis de acesso mais comumente utilizados.
Captura de tela do produto YCloud
Após a conclusão da configuração, registre o ID de configuração — ele será necessário na próxima etapa.

Etapa 3: Integrar o Embedded Signup ao seu site

Adicione o seguinte código HTML e JavaScript ao seu site. Este é o código completo necessário para implementar o Embedded Signup. Recomendamos criar fluxos de Embedded Signup diferentes dependendo da sua solução ou das necessidades do cliente:

Embedded Signup – Criação de uma conta da API do WhatsApp

1. Criar o botão do Embedded Signup

⚠️ Observações:
  • Substitua appId, config_id e solutionID pelos valores reais.
  • O front-end deve passar waba_id e phone_number_id para o seu back-end para recuperar a WABA e registrar o número (veja abaixo).
Mais detalhes: https://developers.facebook.com/docs/whatsapp/embedded-signup/implementation 2. Vincular a WABA e o número registrado Depois que o cliente concluir o Embedded Signup, o seu front-end obterá o waba_id e o phone_number_id, passando-os para o seu back-end para chamadas de API subsequentes. Vincular WABA Chame a API de vinculação de WABA da YCloud e associe-a à conta de cliente correspondente no seu sistema. Exemplo de solicitação:
Exemplo de resposta bem-sucedida:
Observação: se o campo de resposta paymentMethodAttached for true, isso indica que a YCloud vinculou com sucesso um método de pagamento a esta WABA. Caso contrário, entre em contato com a equipe da YCloud para resolver o problema. Registrar número de telefone
Exemplo de resposta

Embedded Signup – Coexistência com o aplicativo WhatsApp Business

1. Criar o botão do Embedded Signup


2. Recuperar a WABA e vincular à YCloud

Depois que os clientes concluírem o Embedded Signup, o seu front-end receberá waba_id. Passe-o para o seu back-end para chamadas adicionais de API. Chame a API de vinculação de SMB da YCloud. Depois de concluído com êxito, associe a WABA à conta do seu cliente no seu sistema.
Exemplo de resposta

Perguntas frequentes

Se você configurou o solutionID corretamente, os clientes verão o nome real do Parceiro de Soluções durante a autorização do Facebook.
Se eles não virem, a configuração não entrou em vigor.
Certifique-se de que a Análise do aplicativo foi concluída.
Captura de tela do produto YCloud
Isso pode acontecer se o usuário selecionar uma WABA existente em vez de criar uma nova.
A WABA existente pode já ter um método de pagamento que não foi removido.
Ao abrir a página do Embedded Signup, a seguinte mensagem pode aparecer:App not active
This app is not currently accessible and the app developer is aware of the issue. You will be able to log in when the app is reactivated.
Isso acontece quando o aplicativo está no modo de Desenvolvimento , onde apenas usuários de teste têm permissão (consulte Painel de aplicativos > Funções do app > Funções / Usuários de teste).Solução:
Alterne o modo do app para Ao vivo por meio de Meta Apps abrindo o aplicativo correspondente no Painel.
Como alternativa, autorize o usuário atual. Consulte: Atribuir ativos de negócios a pessoas no seu portfólio empresarial.
Ao abrir a página do Embedded Signup, a seguinte mensagem pode aparecer:Feature unavailable
Facebook Login is currently unavailable for this app as we are updating additional details for this app. Please try again later.
Solução:
Acesse Painel de aplicativos > Análise do app > Permissões e recursos e solicite o acesso avançado a public_profile .