Mensagens de usuários
O WhatsApp é um canal de comunicação de mão dupla. Sua marca pode enviar mensagens aos usuários, e eles também podem participar de conversas usando Campaigns e Canvas com modelos. Existem várias maneiras de fazer isso, incluindo respostas rápidas do WhatsApp, mensagens de lista e palavras-gatilho. As chamadas para ação (CTAs) de respostas rápidas e mensagens de lista são uma ótima maneira de incentivar o engajamento dos usuários com suas mensagens do WhatsApp.
Gatilhos baseados em ação
Tanto Campaigns quanto Canvas podem começar, ramificar e ter alterações no meio da jornada a partir de uma mensagem recebida do WhatsApp (quando um usuário envia uma mensagem para o seu WhatsApp), como uma palavra-gatilho.
Confira se a sua palavra-gatilho corresponde ao que você espera receber dos usuários.
Informações importantes:
- A correspondência de palavras-gatilho não diferencia maiúsculas de minúsculas. Então, uma mensagem recebida como
jOin2023ainda corresponde a uma palavra-chave configurada comoJOIN2023oujoin2023. - Se nenhuma palavra-gatilho for especificada no gatilho baseado em ação do agendamento de entrada, a Campaign ou o Canvas será executado para todas as mensagens recebidas do WhatsApp. Isso inclui mensagens com frases correspondentes em Campaigns e Canvas ativos. Nesse caso, o usuário recebe duas mensagens do WhatsApp.


Respostas não reconhecidas
Recomendamos incluir uma opção para respostas não reconhecidas em Canvas interativos. Isso ajuda os usuários a entender quais prompts estão disponíveis e define as expectativas para o canal. Esse gerenciamento de expectativas pode ser especialmente útil se você tiver canais do WhatsApp com chat com atendentes ao vivo.
- Na etapa de ação, depois de criar os grupos de ação para as frases de filtro personalizadas, adicione um grupo de ação adicional para “Enviar mensagem do WhatsApp”, mas não marque Where the message body. Isso captura todas as respostas não reconhecidas dos usuários, de forma semelhante a uma cláusula “else”.
- Recomendamos enviar em seguida uma mensagem do WhatsApp informando ao usuário que este canal não é monitorado por atendentes e direcionando-o a um canal de suporte, se necessário.
Respostas rápidas

As respostas rápidas aparecem como opções de botões clicáveis dentro da conversa, mas funcionam como se o usuário tivesse respondido com texto. A Braze então processa essas respostas como mensagens recebidas e pode enviar respostas definidas com base no botão clicado. Use a etapa “Mensagem recebida do WhatsApp” ao criar e filtrar respostas dos seus usuários.

Configurar a experiência de resposta rápida no Canvas
Etapa 1: Crie os CTAs
Primeiro, crie seus CTAs de resposta rápida em um modelo de mensagem no Gerenciador de Modelos de Mensagem do WhatsApp.

Depois que seu modelo for enviado e aprovado pelo WhatsApp, você poderá usá-lo para criar um Canvas na Braze.

Você pode criar o Canvas antes de receber a aprovação do seu modelo de mensagem.
Etapa 2: Crie seu Canvas
Em seguida, crie um Canvas com uma etapa de mensagem que inclua o modelo que você criou.

Crie uma etapa de ação logo após a etapa de mensagem. Nessa etapa de ação, crie um grupo para cada opção de resposta rápida.

Para cada grupo de opção de resposta rápida, especifique exatamente o mesmo texto do botão correspondente. A correspondência não diferencia maiúsculas de minúsculas. Palavras-chave exatas (não regex) são armazenadas em maiúsculas. Por exemplo, ao configurar Yes, o valor armazenado será YES.

Se quiser uma resposta padrão para usuários que respondem à mensagem com texto em vez de usar as respostas rápidas, crie um grupo adicional sem corpo de mensagem correspondente.
A partir daqui, continue criando o Canvas normalmente.
Respostas
Provavelmente você vai querer uma mensagem de resposta para cada opção. Recomendamos ter uma opção genérica para respostas fora das respostas rápidas (por exemplo, para clientes que respondem com uma mensagem geral em vez de usar uma opção predeterminada). Por exemplo: “Desculpe, não reconhecemos sua resposta. Para questões de suporte, envie uma mensagem para

Você pode usar qualquer ação subsequente que o Canvas da Braze oferece, como mensagens de resposta, atualizações do perfil de usuário ou webhooks de Braze para Braze.
Mensagens de lista
As mensagens de lista aparecem como uma mensagem de corpo com uma lista de opções clicáveis. Cada lista pode ter várias seções e até 10 linhas.

Configure a experiência de mensagem de lista no Canvas
Etapa 1: Crie ou edite um Canvas baseado em ação
Você só pode adicionar mensagens de lista do WhatsApp a Canvas baseados em ação, pois elas precisam ser enviadas em resposta a uma mensagem do usuário.
Etapa 2: Crie uma etapa de Mensagem do WhatsApp
Adicione uma etapa de Mensagem do WhatsApp e selecione o layout de mensagem de resposta Mensagem de lista.

Adicione um nome de Botão da lista que os usuários selecionam para exibir sua lista. Em seguida, use os campos em Conteúdo da lista para criar sua lista:
- Seção: Adicione até 10 seções para agrupar e organizar os itens da lista. Por exemplo, um varejista de roupas pode usar seções para organizar por estilos de estação (como primavera, verão, outono e inverno) ou por peças de roupa (como blusas, calças e sapatos).
- Linha: Adicione até 10 linhas, ou itens da lista, somando todas as seções.
- Descrição da linha (opcional): Adicione uma descrição opcional a todas as linhas (itens da lista).

Para alterar a ordem das seções e linhas, selecione e arraste o ícone ao lado dos nomes.

De volta ao criador do Canvas, adicione uma jornada de ação após a etapa de Mensagem, com um grupo para cada resposta da lista. Em cada grupo:
- Adicione um gatilho para Enviou grupo de inscrições do WhatsApp de entrada e selecione o respectivo grupo de inscrições do WhatsApp.
- Marque a caixa de seleção Onde o corpo da mensagem.
- Especifique o conteúdo de uma linha (ou item da lista).

Continue a construir seu Canvas.
Criação de jornadas de ação para descrições longas
Se você tiver descrições de linha, deverá usar Corresponde a regex para especificar uma linha. Por exemplo, se quiser especificar uma linha com a descrição “Nosso novo estilo que combina com seu par de botas de cano curto favorito”, você pode usar regex com “botas de cano curto”.

Atributos Liquid de entrada
As seções a seguir descrevem os atributos Liquid disponíveis nos eventos de mensagens de entrada do WhatsApp. Para ver a lista completa, consulte Tags de personalização compatíveis.
Armazenamento de mídia de entrada e expiração de URL
Quando um usuário envia uma mensagem do WhatsApp com mídia (como uma imagem, um arquivo de áudio ou um documento), a Braze armazena essa mídia no Amazon S3 por 30 dias a partir do recebimento da mensagem.
No entanto, o campo Liquid {{whats_app.${inbound_media_urls}}}, que faz referência à URL dessa mídia, é válido por sete dias a partir do momento em que a Braze recebe a mensagem de entrada. A URL é gerada uma única vez no recebimento e não é gerada de novo. Por isso, o prazo de sete dias vale independentemente de quando você acessa o campo. Prevalece o menor dos dois limites, então, na prática, considere {{whats_app.${inbound_media_urls}}} válido por até sete dias.

Se você salvar um valor de {{whats_app.${inbound_media_urls}}} em um atributo personalizado do usuário para usar depois, lembre-se dessa expiração de sete dias. Tentar acessar a URL depois que ela expira resulta em um link quebrado.
Nome do perfil de entrada
Quando a Meta inclui um nome de exibição em uma mensagem de entrada do WhatsApp, a Braze o disponibiliza como o atributo Liquid {{whats_app.${inbound_profile_name}}} nesse evento de entrada. Esse valor reflete o nome que o usuário definiu no WhatsApp e pode não corresponder aos dados de perfil do CRM. Valide os dados antes de usá-los em textos para usuários ou use uma etapa de Atualização de usuário do Canvas para salvá-los em um campo do perfil e usar depois.
Nome de usuário de entrada
Quando a Meta inclui um nome de usuário do contato em uma mensagem de entrada do WhatsApp, a Braze o disponibiliza como o atributo Liquid {{whats_app.${inbound_username}}} nesse evento de entrada. Esse valor é diferente de {{whats_app.${inbound_profile_name}}}, que reflete o nome de exibição do usuário no WhatsApp. O nome de usuário pode estar ausente quando o remetente não ativou o recurso de nome de usuário no perfil do WhatsApp, mesmo que haja um nome de exibição. Valide os dados antes de usá-los em textos para usuários ou use uma etapa de Atualização de usuário do Canvas para salvá-los em um campo do perfil e usar depois.
ID do usuário com escopo empresarial (BSUID) de entrada
Quando a Meta inclui um ID do usuário com escopo empresarial em uma mensagem de entrada do WhatsApp, a Braze o disponibiliza como o atributo Liquid {{whats_app.${inbound_bsuid}}} nesse evento de entrada. Use esse valor quando um webhook ou uma integração de envio de mensagens de terceiros precisar do BSUID do remetente, junto com o número de telefone ou no lugar dele. O atributo pode ficar vazio quando a Meta não envia um BSUID no webhook (por exemplo, quando o usuário é identificado apenas pelo número de telefone). Valide os dados antes de usá-los em textos para usuários ou em cargas úteis de webhooks de saída, ou use uma etapa de Atualização de usuário do Canvas para salvá-los em um campo do perfil e usar depois.
Origem do compartilhamento de contato
Quando um usuário responde a uma mensagem do WhatsApp compartilhando informações de contato, a Braze disponibiliza como esse compartilhamento aconteceu no atributo Liquid {{whats_app.${contact_share_origin}}} do evento de entrada.
O valor é contact_request quando o usuário tocou em um botão Share Contact Info enviado pela Braze, e other para qualquer outro compartilhamento de contato (por exemplo, um cartão de contato que o usuário anexou manualmente). O atributo fica vazio nas mensagens de entrada que não são compartilhamentos de contato. Use-o para diferenciar compartilhamentos feitos pelo botão de qualquer outra mensagem de contato antes de agir com base nos dados compartilhados.
Número de telefone do contato compartilhado
Quando um usuário toca em um botão Share Contact Info enviado pela Braze, a Braze disponibiliza o número de telefone compartilhado como o atributo Liquid {{whats_app.${contact_shared_phone_number}}} no evento de entrada, no formato E.164 (por exemplo, +5215512345678). O atributo só é preenchido quando {{whats_app.${contact_share_origin}}} é contact_request.
Em qualquer outro compartilhamento de contato, e nas mensagens de entrada que não são compartilhamentos de contato, {{whats_app.${contact_shared_phone_number}}} fica vazio. Use uma etapa de Atualização de usuário do Canvas para salvá-lo em um campo do perfil e usar depois. Para ver um fluxo completo de identificação por BSUID, consulte Solicitar informações de contato de usuários do WhatsApp identificados apenas por BSUID.

Esse número é compartilhado pelo usuário pelo WhatsApp e não é verificado de forma independente pela Braze. Ou seja, o WhatsApp mantém esse número vinculado à conta do usuário, mas a Braze não confirma se ele está atualizado nem se pertence ao remetente. Verifique esse número antes de usá-lo como identidade confiável ou em um fluxo sensível à segurança, como recuperação de conta, verificações de fraude ou senhas de uso único.
Considerações
Requisitos de tempo para mensagens de resposta
As mensagens de resposta precisam ser enviadas em até 24 horas após o recebimento da mensagem de um usuário. Para ajudar a criar experiências bem-sucedidas, a Braze verifica a lógica da mensagem para confirmar que existe uma mensagem de entrada anterior do usuário que desbloqueia a mensagem de resposta.
Para respostas em menos de um minuto em fluxos de comunicação de mão dupla no Canvas, minimize as etapas entre o gatilho de entrada e o envio da mensagem de resposta. A arquitetura do Canvas, as idas e voltas de webhooks e o processamento em lote da etapa de Atualização de Usuário podem adicionar latência. Consulte Minimizar a latência de resposta em fluxos de mão dupla.
Os seguintes eventos desbloqueiam mensagens de resposta:
- Mensagem de entrada
- Etapa de jornadas de ação ou entrada baseada em ação com o gatilho Send a WhatsApp inbound message.

- Entrada disparada por API
- Mensagem de entrada de produto
- Evento
ecommerce.cart_updated
- Evento

Respostas rápidas e mensagens de entrada fora da janela de 24 horas
Quando um usuário interage com sua empresa no WhatsApp, inclusive tocando em um botão de resposta rápida de uma mensagem de modelo mais antiga, essa ação conta como uma mensagem de entrada. Essa mensagem de entrada abre uma nova janela de atendimento ao cliente de 24 horas, mesmo que o modelo original tenha sido enviado há mais de 24 horas.
Em um Canvas com botões de resposta rápida, os usuários podem tocar em um botão dias depois de receber o modelo de boas-vindas e ainda assim avançar pela jornada correta. A Braze avalia a etapa de jornadas de ação quando a mensagem de entrada chega. Portanto, não é necessário estender a janela de avaliação das jornadas de ação além do padrão para capturar respostas tardias.
O diagrama a seguir mostra um fluxo comum de resposta rápida:
sequenceDiagram
participant Brand
participant User
Brand->>User: Template message (quick reply buttons)
Note over User: More than 24 hours pass
User->>Brand: Taps quick reply (inbound message)
Note over Brand,User: New 24-hour customer service window opens
Brand->>User: Response message (within Action Paths step)
O que você precisa saber
- A etapa da mensagem de resposta ainda precisa ocorrer em até 24 horas após a mensagem de entrada do usuário. Na maioria dos fluxos do Canvas, a resposta é enviada imediatamente após a avaliação da etapa de jornadas de ação, então isso não costuma ser um problema.
- A janela de atendimento ao cliente de 24 horas é diferente dos eventos de conversão do Canvas, que podem usar uma janela de até 30 dias. As janelas de conversão controlam a atribuição; elas não afetam se uma mensagem de resposta pode ser enviada.
- Para informações sobre cobrança, consulte Como as mensagens de resposta do WhatsApp são cobradas?.
Atribuição de mensagens de entrada a Campaigns e Canvas
Quando a Braze recebe uma mensagem de entrada do WhatsApp, ela tenta associar essa mensagem a uma etapa de Campaign ou Canvas. Por padrão, a Braze atribui a mensagem de entrada à mensagem de saída do WhatsApp mais recente que o usuário recebeu nas quatro horas anteriores. Esse intervalo é medido entre o registro de data e hora da mensagem de entrada e o registro de data e hora da última mensagem do WhatsApp recebida pelo usuário naquela etapa de Campaign ou Canvas.
Se uma mensagem de entrada chegar mais de quatro horas depois de o usuário ter recebido a última mensagem de saída do WhatsApp daquela etapa de Campaign ou Canvas, a mensagem de entrada não será associada a um canvas_id ou campaign_id. Isso pode afetar a atribuição da análise de dados e dos dados de eventos quando os usuários respondem fora dessa janela.
Filtrar por um atributo de horário personalizado
Se o público da sua Campaign ou do seu Canvas baseado em ação do WhatsApp depender de um atributo de horário personalizado dentro de uma janela relativa (por exemplo, entre agora e as próximas 24 horas), combine dois filtros conforme descrito em Horário.