Cadastro integrado do WhatsApp
Use o cadastro integrado para conectar a Braze a uma conta do WhatsApp Business (WABA) por meio do fluxo de cadastro hospedado pela Meta.
O fluxo de cadastro integrado do WhatsApp é aberto quando você integra o WhatsApp ao seu espaço de trabalho da Braze pela primeira vez e quando você adiciona uma conta do WhatsApp Business ou um número de telefone a uma integração existente.
Você pode adicionar várias contas do WhatsApp Business a um espaço de trabalho da Braze. No entanto, cada conta específica do WhatsApp Business só pode ser adicionada a um único espaço de trabalho da Braze.
Acessar o fluxo de trabalho
- Acesse Integrações com parceiros > Parceiros de tecnologia.
- Pesquise e selecione WhatsApp.
- Selecione a opção que corresponde ao seu caso de uso:
- Primeira integração: Selecione Iniciar integração.
- Conta ou número adicional: Na página Integração de envio de mensagens do WhatsApp, selecione Adicionar conta ou número ou Adicionar conta do WhatsApp Business.
O fluxo de inscrição incorporado da Meta é o mesmo, seja qual for o ponto de entrada usado para iniciá-lo. Dependendo da sua configuração, seu espaço de trabalho também pode mostrar guias de integração, como Integração nativa ou BYO Connector - Infobip. Antes de começar, selecione a guia que corresponde à sua configuração.
Prepare-se para a inscrição
Quando você seleciona Begin Integration, a Braze abre uma janela de integração. Revise cada slide e selecione Begin Integration novamente para iniciar a inscrição incorporada da Meta.
Antes de começar, prepare o seguinte:
- Acesso ao Meta Business Manager: A maioria das empresas usa o Meta Business Manager para gerenciar páginas do Facebook, anúncios e ativos comerciais relacionados. Se você não tiver acesso, peça a um administrador para conceder as permissões ou crie uma conta do Business Manager durante a inscrição.
- Número de telefone: Use um número que atenda aos requisitos de número de telefone do WhatsApp da Meta. Você receberá um código de verificação único por mensagem de texto ou ligação durante a inscrição.
Você só concluirá a inscrição incorporada inicial uma vez por jornada de integração. Por isso, insira os dados da sua empresa com a maior precisão possível.
Fluxo de cadastro integrado do WhatsApp
Depois que a Braze iniciar o cadastro integrado da Meta, faça login com uma conta Meta que tenha acesso ao Business Manager da sua empresa. A Meta hospeda as telas de cadastro; a Braze não controla o layout nem os rótulos dessas telas.
A Meta pode alterar as telas do cadastro integrado sem aviso prévio. Se o fluxo for diferente do descrito neste artigo, siga as instruções da Meta e consulte a documentação de cadastro integrado da Meta.
De modo geral, a Meta orienta você nas seguintes etapas:
- Fazer login e conceder permissões. Autentique-se com a Meta e permita que a Braze se conecte à sua conta do WhatsApp Business.
- Selecionar seu portfólio de negócios. Conecte o portfólio do Business Manager que será proprietário da conta do WhatsApp Business. Se você não encontrar o portfólio esperado, verifique suas permissões na Meta.
- Conectar ou criar uma conta do WhatsApp. Crie uma nova conta ou selecione a conta do WhatsApp que já contém seu número de telefone. Se o número já estiver em uso com outro provedor, você pode compartilhar essa conta do WhatsApp com a Braze em vez de transferir o número.
- Fornecer detalhes do negócio e de exibição. Insira o nome da conta, o nome de exibição e a categoria que a Meta solicita para a sua conta do WhatsApp Business.
- Verificar seu número de telefone. Adicione o número que você deseja usar para o envio de mensagens pelo WhatsApp e conclua a verificação por mensagem de texto ou chamada telefônica.
Quando a Meta finalizar o cadastro integrado, o controle retorna para a Braze.
Concluir a integração com a Braze
Depois do cadastro incorporado, a Braze executa as etapas de configuração automaticamente. Na página WhatsApp Messaging Integration, você pode ver mensagens de progresso como Sign-up flow completed, integration with WhatsApp in progress enquanto a Braze faz o seguinte:
- Recupera o ID da sua conta do WhatsApp Business e os números de telefone na Meta
- Adiciona o usuário do sistema da Braze à sua conta do WhatsApp Business
- Registra os números de telefone e se inscreve nos eventos de webhook
- Cria um grupo de inscrições da Braze para cada número conectado
Aguarde a conclusão da integração antes de enviar mensagens. Se a configuração falhar, confira o erro na página de integração e consulte Configuração do WhatsApp para orientações gerais.
Solução de problemas
Seleção de número de telefone inelegível
Durante o cadastro incorporado da Meta, um número de telefone pode aparecer como Inelegível. A Meta bloqueia a seleção do número até que ele esteja livre para se conectar à Braze. A tabela a seguir descreve os motivos pelos quais um número pode estar bloqueado e como desbloqueá-lo.
| Causa | Correção |
|---|---|
| O número ainda está registrado em outro app de desenvolvedor da Meta | No dashboard do Meta for Developers, abra o app em que a API do WhatsApp foi configurada anteriormente. Acesse WhatsApp > Configuração da API (ou Primeiros passos), encontre o número de telefone e remova-o desse app. Se o número estiver ativo em outra conta do WhatsApp Business (WABA), talvez você também precise removê-lo dessa conta no WhatsApp Manager antes que ele fique disponível. |
| Conta do WhatsApp compartilhada com outro provedor de soluções | O compartilhamento de uma conta do WhatsApp com outro provedor é compatível com o modelo de conta mais recente da Meta. Confirme que a Braze tem acesso à conta de envio de mensagens da sua conexão e tente selecionar o número de telefone novamente. Consulte Usar um número de telefone do WhatsApp existente. |
| Falta o acesso de parceiro da Braze | Se a conta do WhatsApp ainda não estiver compartilhada com a Braze, atribua a Braze como parceira quando a Meta solicitar durante o cadastro e tente selecionar o número de telefone novamente. |
Depois de remover o registro conflitante ou ajustar o compartilhamento com o parceiro, reinicie o cadastro incorporado pela Braze e selecione o número novamente.