Fluxos de aceitação do WhatsApp
Crie um fluxo que coleta aceitações do WhatsApp dos seus usuários, confirma a inscrição deles e atualiza o status de inscrição na Braze.
Requisitos
Antes de configurar os fluxos de aceitação, confirme que os itens a seguir estão prontos:
| Requisito | Descrição |
|---|---|
| Conta do WhatsApp Business | Sua conta do WhatsApp Business está conectada à Braze e seu grupo de inscrições está configurado. |
| Política de aceitação da Meta | Você entende os requisitos de aceitação do WhatsApp da Meta e as orientações de aceitação e cancelamento da Braze. Os usuários devem concordar explicitamente em receber mensagens da sua empresa antes que você possa enviar mensagens a eles. |
| Plano de dados de aceitação | Você tem um plano para definir onde os dados de aceitação são capturados e como são enviados para a Braze (via SDK, API ou seu pipeline de dados). |
Como as aceitações funcionam na Braze
Quando um usuário concorda em receber mensagens do WhatsApp da sua empresa, o status de inscrição dele deve ser atualizado para Subscribed na Braze antes que ele possa receber mensagens do seu grupo de inscrições do WhatsApp. Uma mensagem de entrada do WhatsApp sozinha não inscreve o usuário. Defina o status de inscrição usando um destes métodos, dependendo de como os dados de aceitação são coletados:
| Método | Descrição |
|---|---|
| SDK da Braze | Atualize o status de inscrição de um usuário quando ele concluir uma ação de aceitação no seu app |
| API da Braze | Envie uma atualização de status de inscrição quando os dados de aceitação são capturados fora do app (por exemplo, por meio de um formulário web ou integração de terceiros) |
| Mensagem de entrada do WhatsApp | Quando um usuário envia uma mensagem para sua empresa (por exemplo, após escanear um código QR), configure um Canvas ou uma Campaign com uma etapa de atualização de usuário, webhook ou chamada de API para definir o status de inscrição. Consulte Mensagem de entrada do WhatsApp. |
Confirmação de aceitação com uma mensagem de resposta
Como prática recomendada, sempre confirme a inscrição de um usuário com uma mensagem imediata no WhatsApp. Isso define expectativas, reforça o valor do canal e oferece aos usuários uma maneira fácil de cancelar a inscrição caso tenham se inscrito por engano.
Como o usuário inicia a conversa escaneando um código QR ou enviando uma mensagem diretamente para o seu número, a janela de conversa de 24 horas está aberta. Isso significa que você pode enviar uma mensagem de resposta para confirmação em vez de um modelo pré-aprovado.
Se o usuário fizer a aceitação por meio de um formulário ou caixa de seleção e ainda não tiver enviado uma mensagem para o seu número do WhatsApp, a janela de conversa não está aberta. Use um modelo de mensagem aprovado pela Meta para confirmação.
Configure um Canvas de confirmação
Crie um Canvas que atualize o status de inscrição e envie a confirmação quando a palavra-chave de aceitação chegar.
- Acesse Messaging > Canvas e selecione Create Canvas.
- Dê um nome ao seu Canvas (por exemplo, “WhatsApp — Confirmação de aceitação”).
- Em Entry Schedule, selecione Action-Based.
- Defina o gatilho de entrada como Send a WhatsApp inbound message. Filtre o corpo da mensagem pela sua palavra-chave de aceitação (por exemplo, “JOIN”) para que mensagens de entrada não relacionadas não entrem no Canvas.
- Adicione uma etapa de atualização de usuário para definir o status de inscrição do usuário como Subscribed.
- Adicione uma etapa de Mensagem após a atualização de usuário.
- Selecione WhatsApp > seu grupo de inscrições > Response como o tipo de mensagem.
- Escolha o layout Text e escreva uma mensagem curta de confirmação. Por exemplo: “Agora você está inscrito no [Marca] no WhatsApp. Enviaremos [breve descrição do que receberão]. Responda [sua palavra-chave de cancelamento] a qualquer momento para cancelar a inscrição.”
- (Opcional) Adicione um layout de Quick reply em vez de texto simples para orientar a próxima ação do usuário (por exemplo, “Ver ofertas” ou “Rastrear meu pedido”).
Mantenha a mensagem de confirmação curta para reduzir confusão e ajudar a manter uma taxa saudável de cancelamento. Informe aos usuários exatamente no que eles se inscreveram e como cancelar. Palavras-chave de cancelamento como “STOP” só cancelam a inscrição dos usuários se você configurar esse fluxo de palavra-chave na Braze. Para detalhes sobre palavras-chave de cancelamento, consulte Aceitação e cancelamento.
Atualizando o status de inscrição na Braze
Após a aceitação de um usuário, use um dos métodos de atualização a seguir para definir o status de inscrição do usuário como Subscribed na Braze. Isso permite que ele receba mensagens futuras do seu grupo de inscrições do WhatsApp.
Chame o método de atualização de status do grupo de inscrições quando o usuário concluir a ação de aceitação no seu app (por exemplo, enviar um formulário ou marcar uma caixa de seleção). Para métodos do SDK por plataforma, consulte Definindo grupos de inscrições do WhatsApp dos usuários.
Envie uma requisição POST para o endpoint /subscription/status/set com o número de telefone do usuário, o ID do grupo de inscrições e o status definido como subscribed. Essa abordagem funciona para aceitações coletadas fora do SDK da Braze, como formulários web, sistemas de PDV ou integrações de terceiros. Para parâmetros de requisição, permissões e exemplos, consulte POST: Atualizar status do grupo de inscrições do usuário.
Se o seu fluxo de aceitação direciona os usuários a enviar uma mensagem para o número do WhatsApp da sua empresa, configure um Canvas ou uma Campaign que atualize o status de inscrição quando essa mensagem de entrada for recebida — por exemplo, com uma etapa de atualização de usuário ou webhook. Mensagens de entrada não inscrevem usuários por si só. Para as etapas de configuração, consulte Mensagem de entrada do WhatsApp.
Método de aceitação: código QR
Um código QR do WhatsApp direciona diretamente para uma mensagem pré-preenchida no WhatsApp. Quando um usuário escaneia o código, o WhatsApp abre com o número da sua empresa e um corpo de mensagem pré-preenchido opcional. O usuário envia a mensagem para iniciar a conversa e confirmar a aceitação.
Etapa 1: Gere seu código QR do WhatsApp
- No Meta Business Manager, navegue até sua conta do WhatsApp Business.
- Em WhatsApp Manager > Phone Numbers, selecione o número de telefone da sua empresa.
- Selecione WhatsApp Links (ou QR Code, dependendo da versão da sua interface da Meta).
- Defina uma mensagem pré-preenchida para os usuários enviarem ao escanear o código (por exemplo, “Gostaria de me inscrever” ou uma palavra-chave como “JOIN”). Essa mensagem é o gatilho de entrada que você usa na Braze.
- Baixe ou copie o código QR para usar em seus materiais de marketing.
Etapa 2: Configure a atualização de inscrição e confirmação
Siga Confirmação de aceitação com uma mensagem de resposta para criar um Canvas baseado em ação que:
- Entra em Send a WhatsApp inbound message filtrado pela sua palavra-chave de aceitação (por exemplo, “JOIN”).
- Usa uma etapa de atualização de usuário para definir o status de inscrição como Subscribed.
- Envia uma mensagem de confirmação de Response no WhatsApp.
Você também pode separar a atualização de inscrição e a confirmação em Canvas distintos que compartilham o mesmo gatilho de entrada, mas um Canvas único mantém a entrada e a ordem das mensagens mais fáceis de gerenciar. Para outras abordagens de atualização por entrada, consulte Mensagem de entrada do WhatsApp.
Etapa 3: Posicione o código QR
Distribua seu código QR em qualquer lugar que os usuários possam escaneá-lo: embalagens, sinalização em lojas, anúncios impressos, campanhas de e-mail ou seu website. Para posicionamentos digitais, considere vincular a URL do código QR diretamente para que os usuários em dispositivos móveis possam tocar em vez de escanear.
A Meta exige que os pontos de coleta de aceitação divulguem claramente que o usuário está concordando em receber mensagens do WhatsApp da sua empresa. A superfície de aceitação — seja física ou digital — deve incluir essa divulgação antes que o usuário escaneie ou toque.
Método de aceitação: outras superfícies de coleta
Para usuários que não estão escaneando um código QR, as aceitações são normalmente coletadas por meio de interfaces padrão da web ou do app. Nesses casos, o status de inscrição é atualizado por meio do SDK ou da API da Braze após o usuário concluir a ação.
Como o usuário ainda não enviou uma mensagem para o número do WhatsApp da sua empresa, a janela de conversa de 24 horas não está aberta quando ele faz a aceitação por meio de um formulário ou caixa de seleção. Sua mensagem de confirmação deve ser um modelo de mensagem aprovado pela Meta (não uma mensagem de resposta).
Formulário de captura de número de telefone
Um formulário de captura de número de telefone pede aos usuários que insiram seu número de telefone e consintam com o envio de mensagens no WhatsApp. Normalmente é colocado no website da marca ou em um fluxo pós-compra.
Configuração
- Crie o formulário no seu website ou no seu app. O formulário deve incluir uma divulgação clara de que o usuário está consentindo com mensagens do WhatsApp, junto com seus termos e política de privacidade.
- Ao enviar o formulário, passe o número de telefone e o status de consentimento do usuário para a Braze por meio da API da Braze (endpoint
/subscription/status/set) ou pelo seu pipeline de dados se estiver usando uma CDP. - Se o usuário já estiver identificado na Braze, o perfil dele será atualizado. Se for novo, crie o perfil de usuário primeiro usando o endpoint
/users/tracke depois atualize o status de inscrição. - Envie um modelo de mensagem de confirmação por meio da API após a atualização de status, ou configure um Canvas baseado em ação que entra quando o status do grupo de inscrições do WhatsApp muda para inscrito e envia uma mensagem de Template no WhatsApp.
Se o seu formulário coleta tanto e-mail quanto telefone, considere enviar uma confirmação de aceitação multicanal. Use o WhatsApp para confirmação imediata e o e-mail como fallback caso a entrega pelo WhatsApp falhe.
Caixa de seleção em uma página de cadastro ou checkout
Uma caixa de seleção pode ser incorporada em um fluxo existente — como criação de conta, checkout ou configuração de perfil — e permite que os usuários aceitem receber mensagens no WhatsApp em um momento natural da experiência.
Configuração
- Adicione a caixa de seleção ao seu formulário de cadastro ou checkout. Rotule-a claramente (por exemplo, “Envie-me atualizações de pedidos e ofertas pelo WhatsApp”). Pré-marcar a caixa em nome do usuário não é um consentimento válido; o usuário deve marcar a caixa.
- Após o usuário enviar o formulário com a caixa marcada, atualize o status de inscrição na Braze por meio do SDK ou da API da Braze.
- Confirme com um modelo de mensagem aprovado pela Meta no WhatsApp: envie por meio da API após a atualização de status, ou use um Canvas baseado em ação que entra no status do grupo de inscrições do WhatsApp e envia uma mensagem de Template.
Método de aceitação: código QR na TV (exemplo de serviço de streaming)
Exibir um código QR na tela da TV permite que os espectadores façam a aceitação do WhatsApp com um segundo dispositivo. O fluxo é o mesmo de uma aceitação padrão por código QR, mas o posicionamento e a experiência do usuário requerem considerações adicionais.
Como o fluxo funciona
- Um código QR aparece na tela da TV (em um anúncio, durante um intervalo entre conteúdos ou como um prompt na tela do app de streaming).
- O espectador escaneia o código com o celular.
- O WhatsApp abre no celular com o número da sua empresa e uma mensagem pré-preenchida.
- O espectador envia a mensagem para confirmar a aceitação.
- A Braze recebe a mensagem de entrada. Seu Canvas ou Campaign configurado atualiza o status de inscrição (por exemplo, com uma etapa de atualização de usuário) e envia a mensagem de resposta de confirmação.
Considerações de configuração
Siga as mesmas etapas de Método de aceitação: código QR. As principais diferenças estão em como o código QR é implantado e como a experiência é projetada para o contexto de TV.
- Faça o código QR grande o suficiente para ser escaneado a uma distância típica de visualização (2,5 a 3 metros). Um tamanho mínimo de 400×400 px é recomendado para exibição em tela cheia na TV, mas teste em hardware real antes de lançar.
- Exiba o código por tempo suficiente para que os espectadores peguem o celular e escaneiem — pelo menos 10 a 15 segundos, ou mais se ele aparecer junto com outro conteúdo na tela.
- Inclua um texto curto de orientação próximo ao código (por exemplo, “Escaneie para receber atualizações exclusivas no WhatsApp”).
Use uma palavra-chave curta e simples como corpo da mensagem pré-preenchida (por exemplo, “JOIN” ou “SUBSCRIBE”). Os espectadores podem não ler o texto pré-preenchido com atenção antes de tocar em enviar, então mantenha-o claro.
Identidade do usuário
Se o espectador estiver logado no seu app de streaming na TV e você conseguir associar o número de telefone ao perfil existente na Braze (por meio da API ou de um fluxo de escaneamento com login), a atualização do status de inscrição será vinculada ao perfil existente.
Se o espectador escanear como um usuário anônimo ou novo, a Braze criará um novo perfil ao receber a mensagem de entrada. Pode ser necessária uma etapa de merge ou resolução de identidade para o Gerenciamento de identidade de usuários.
Se o seu app de streaming exibe o código QR durante um anúncio, coordene com seu servidor de anúncios ou sistema de gerenciamento de conteúdo para rastrear quando o código foi exibido junto com os dados de inscrição da Braze. Isso ajuda a medir o aumento de aceitações atribuível a posicionamentos ou criativos específicos.
Medir desempenho
Acompanhe a integridade e o crescimento do seu programa de aceitação usando as métricas a seguir.
| Métrica | O que observar |
|---|---|
| Tamanho do grupo de inscrições | Monitore o crescimento ao longo do tempo em Audience > Subscription Groups para entender o volume de aceitações por método de coleta. |
| Taxa de entrega da mensagem de confirmação | Uma taxa de entrega baixa no seu Canvas de confirmação pode indicar problemas com a qualidade do número de telefone ou que o status de inscrição não foi definido antes da tentativa de envio da mensagem. |
| Taxa de cancelamento | Acompanhe os cancelamentos após a mensagem de confirmação e após os primeiros envios de campanhas. Um pico no início do ciclo de vida pode indicar uma diferença entre o que os usuários esperavam ao fazer a aceitação e o que receberam. |
| Volume de escaneamento do código QR | Se o seu código QR está hospedado em uma landing page ou link rastreado, use parâmetros UTM ou um encurtador de URL com análise de dados para medir a conversão de escaneamento para aceitação por posicionamento. |