Pular para o conteúdo principal

[Extensão] Como integrar o Braze com o Blip

  • Atualizado

  1. Introdução

  2. Funcionalidades

  3. Pré-requisitos

  4. Instalação e configuração

  5. Criar a automação de WhatsApp

  6. Configurar o webhook em uma campanha do Braze
  7. Configurar o webhook em um Canvas do Braze
  8. Testar o envio
  9. Suporte

 

Descrição breve: Envie mensagens ativas de WhatsApp a partir de campanhas e jornadas do Braze, conectando os contatos da sua conta Braze aos disparos de template do seu bot na Blip.

 

Introdução

A extensão Braze integra a plataforma Braze ao Blip para enviar mensagens ativas de WhatsApp a partir de campanhas e jornadas do Canvas. O Braze aciona um webhook que dispara um modelo de WhatsApp aprovado na Blip, e as variáveis do modelo são preenchidas com os atributos do contato no Braze.

Por exemplo, quando um contato entra em uma jornada de carrinho abandonado no Canvas do Braze, o Braze chama o webhook da extensão, que envia um template de WhatsApp aprovado e, se você quiser, posiciona o contato direto em um fluxo do seu bot para continuar o atendimento.

 

Funcionalidades

  • Envio de mensagens ativas de WhatsApp a partir de campanhas do Braze.

  • Envio de mensagens ativas de WhatsApp a partir de jornadas do Canvas do Braze.

  • Acionamento do disparo pelo webhook do Braze.

  • Preenchimento das variáveis do modelo com atributos do contato no Braze (nome, sobrenome, e-mail, celular, data de nascimento e atributos customizados).

  • Suporte a modelos com variável de mídia e variável de botão.

  • Posicionamento do contato em um bot e fluxo específico após o disparo.

Suportada nos seguintes canais: WhatsApp.

 

Pré-requisitos

  • Uma conta ativa no Braze com permissão para criar chaves de API, campanhas, Canvas e webhooks.

  • Um bot na Blip com um Roteador que tenha o WhatsApp conectado.

  • Ao menos um modelo de mensagem ativa de WhatsApp aprovado na Blip.

 

Instalação e configuração

Instalar a extensão

  1. Acesse a Braze na Blip Store e instale a extensão no bot que fará os disparos.

Extensão Braze na Blip Store pronta para instalação

  1. Após a instalação, abra a extensão. A tela de Configurações é exibida.

Tela de Configurações da extensão Braze na Blip

Gerar o token de API no Braze

Nota: os menus do Braze podem variar conforme a versão ou as permissões da sua conta.

  1. Acesse o Braze e faça login na sua conta.

Tela de login do Braze

  1. No menu lateral, abra Settings (ícone de engrenagem) e selecione APIs and Identifiers.

Menu Settings do Braze com a opção APIs and Identifiers selecionada

  1. Clique em Create API Key.

Botão Create API Key em destaque na tela APIs and Identifiers do Braze

  1. Em API key name, defina um nome para a chave, por exemplo Blip.

Campo API key name preenchido com o nome Blip no Braze

  1. Ative as permissões usadas pela integração: Catalogs, User Data, Purchases, Subscription e Custom Attributes. Em seguida, clique em Create API key.

Lista de permissões da API Key do Braze com Catalogs, User Data, Purchases, Subscription e Custom Attributes marcadas

  1. Copie o token pelo ícone de copiar na coluna Identifier.

Coluna Identifier da API Key do Braze com o ícone de copiar o token

Atenção: copie o token da coluna Identifier e não compartilhe essa chave nem a exponha em documentos públicos.

Copiar o REST Endpoint

O REST Endpoint corresponde à instância da sua conta Braze.

  1. Identifique a URL do seu dashboard no topo da página, a mesma que você usa para acessar o Braze, por exemplo https://dashboard-07.braze.com.

  2. Na documentação do Braze, localize o REST Endpoint correspondente à sua instância e copie-o.

Tabela de REST Endpoints na documentação do Braze

Atenção: use o REST Endpoint da instância, por exemplo https://rest.iad-01.braze.com, nunca o endereço do dashboard.

Ativar a extensão na Blip

  1. Volte à extensão na Blip, na aba Configurações.

  2. Preencha os campos REST Endpoint e Token com os dados da sua conta Braze.

Campos REST Endpoint e Token preenchidos na tela de Configurações da extensão Braze

  1. Clique em Salvar. A extensão valida a conexão com o Braze e confirma o salvamento. Se o REST Endpoint ou o token estiverem incorretos, ela exibe uma mensagem de erro.

Mensagem de confirmação após salvar a configuração da extensão Braze

 

Criar a automação de WhatsApp

Na extensão, acesse Automação WhatsApp. O assistente tem três etapas: Configurar bot, Configurar mensagem e Instalar automação.

Configurar o bot

Em Configurar bot, selecione o Bot roteador pai com whatsapp conectado que fará o envio e clique em Salvar e avançar. Os modelos de WhatsApp aprovados são carregados desse Roteador. Se aparecer o aviso "Whatsapp não reconhecido nesse bot", o Roteador selecionado não tem o WhatsApp conectado.

Selecionar o modelo de mensagem

Em Configurar mensagem, clique em Selecionar modelo e escolha o modelo de mensagem ativa aprovado que será usado no disparo.

Campo Selecionar modelo com a lista de modelos de mensagem aprovados na extensão Braze

Se o modelo tiver mídia, preencha o campo Link da mídia. Se o modelo tiver botão, preencha o campo Variável do botão. As variáveis do modelo são preenchidas com os atributos do contato no Braze, como [first_name], [phone_number] e [custom.field] para atributos customizados.

Posicionar o usuário no bot

Para apenas notificar o contato, mantenha Posicionar usuário no bot desativado.

Opção Posicionar usuário no bot desativada na configuração da mensagem

Para direcionar o contato a um ponto da jornada após o disparo, ative a opção e selecione o Bot e o Fluxo de destino.

Opção Posicionar usuário no bot ativada com os campos Bot e Fluxo de destino

Clique em Avançar. A extensão gera a URL do webhook que você vai usar no Braze.

Instalar a automação no Braze

Em Instalar automação, escolha como o webhook será usado: Campanha ou Canvas. A extensão exibe o passo a passo e a URL a ser configurada no Braze.

Etapa Instalar automação com as abas Campanha e Canvas e a URL do webhook gerada

 

Configurar o webhook em uma campanha do Braze

  1. Acesse sua conta no Braze.

  2. No menu Messaging, selecione Campaigns e crie uma campanha.

  3. Escolha o canal Webhook.

  4. Role a tela e clique em Blank Template.

  5. Preencha o Webhook URL com o link gerado pela extensão.

  6. Para modelos com variáveis dinâmicas, clique em Add New Body Property e, na primeira Key, informe o número da variável e o valor correspondente. Por exemplo, em um template com uma variável, use o atributo de primeiro nome do contato.

  7. Avance para a próxima etapa e defina o público e o acionamento da campanha.

  8. Ative a campanha.

 

Configurar o webhook em um Canvas do Braze

  1. Acesse sua conta no Braze.

  2. No menu Messaging, selecione Canvas e crie a jornada.

  3. No ponto em que quiser enviar a mensagem por WhatsApp, adicione uma ação do tipo Message, na categoria Basic Components.

  4. Selecione o canal Webhook e clique em Blank Template.

  5. Preencha o Webhook URL com o link gerado pela extensão.

  6. Para modelos com variáveis dinâmicas, clique em Add New Body Property e informe o número da variável e o valor na primeira Key.

  7. Salve o webhook clicando em Done.

  8. Ative o fluxo clicando em Launch Canvas.

 

Testar o envio

Antes de ativar a campanha ou o Canvas, use a opção Test no topo da tela do Braze, selecionando um usuário existente ou criando um de exemplo. Verifique se:

  • o webhook retorna uma resposta de sucesso;

  • o contato tem um telefone válido no atributo usado pela automação;

  • todas as variáveis do modelo estão preenchidas;

  • o modelo está aprovado e ativo na Blip;

  • a mensagem chegou ao contato correto;

  • o posicionamento no bot ocorreu conforme configurado, quando essa opção estiver ativa.

Publique a campanha ou o Canvas somente após validar o envio. Se você alterar o modelo de mensagem, revise a configuração da automação, pois as variáveis podem mudar.

 

Suporte

Em caso de dúvidas ou problemas, fale com o time de suporte da Wiv pelo e-mail support@wiv.com.br.


 

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃

 

Artigos relacionados