Saltar al contenido principal

[Extensión] Cómo integrar Braze con Blip

  • Actualización

  1. Introducción

  2. Funcionalidades

  3. Requisitos previos

  4. Instalación y configuración

  5. Crear la automatización de WhatsApp

  6. Configurar el webhook en una campaña de Braze
  7. Configurar el webhook en un Canvas de Braze
  8. Probar el envío
  9. Soporte

 

Descripción breve: Envía mensajes activos de WhatsApp desde campañas y journeys de Braze, conectando los contactos de tu cuenta de Braze con los envíos de plantillas de tu bot en Blip.

 

Introducción

La extensión de Braze integra la plataforma de Braze con Blip para enviar mensajes activos de WhatsApp desde campañas y journeys de Canvas. Braze activa un webhook que dispara una plantilla de WhatsApp aprobada en Blip, y las variables de la plantilla se completan con los atributos del contacto en Braze.

Por ejemplo, cuando un contacto entra en un journey de carrito abandonado en Canvas de Braze, Braze llama al webhook de la extensión, que envía una plantilla de WhatsApp aprobada y, si quieres, coloca al contacto directamente en un flujo de tu bot para continuar la atención.

 

Funcionalidades

  • Envío de mensajes activos de WhatsApp desde campañas de Braze.

  • Envío de mensajes activos de WhatsApp desde journeys de Canvas de Braze.

  • Activación del envío mediante el webhook de Braze.

  • Completar las variables de la plantilla con atributos del contacto en Braze (nombre, apellido, correo electrónico, celular, fecha de nacimiento y atributos personalizados).

  • Compatibilidad con plantillas con variable de medios y variable de botón.

  • Colocar al contacto en un bot y flujo específicos después del envío.

Compatible con el siguiente canal: WhatsApp.

 

Requisitos previos

  • Una cuenta activa de Braze con permiso para crear claves de API, campañas, Canvas y webhooks.

  • Un bot en Blip con un Router que tenga WhatsApp conectado.

  • Al menos una plantilla de mensaje activo de WhatsApp aprobada en Blip.

 

Instalación y configuración

Instalar la extensión

  1. Accede a Braze en Blip Store e instala la extensión en el bot que realizará los envíos.

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

  1. Después de la instalación, abre la extensión. Se mostrará la pantalla de Configuración.

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

Generar el token de API en Braze

Nota: los menús de Braze pueden variar según la versión o los permisos de tu cuenta.

  1. Accede a Braze e inicia sesión en tu cuenta.

Tela de login do Braze

  1. En el menú lateral, abre Settings (ícono de engrane) y selecciona APIs and Identifiers.

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

  1. Haz clic en Create API Key.

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

  1. En API key name, define un nombre para la clave, por ejemplo Blip.

Campo API key name preenchido com o nome Blip no Braze

  1. Activa los permisos utilizados por la integración: Catalogs, User Data, Purchases, Subscription y Custom Attributes. Después, haz clic en Create API key.

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

  1. Copia el token mediante el ícono de copiar en la columna Identifier.

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

Atención: copia el token de la columna Identifier y no compartas esta clave ni la expongas en documentos públicos.

Copiar el REST Endpoint

El REST Endpoint corresponde a la instancia de tu cuenta de Braze.

  1. Identifica la URL de tu dashboard en la parte superior de la página, la misma que usas para acceder a Braze, por ejemplo https://dashboard-07.braze.com.

  2. En la documentación de Braze, localiza el REST Endpoint correspondiente a tu instancia y cópialo.

Tabela de REST Endpoints na documentação do Braze

Atención: usa el REST Endpoint de la instancia, por ejemplo https://rest.iad-01.braze.com, nunca la dirección del dashboard.

Activar la extensión en Blip

  1. Regresa a la extensión en Blip, en la pestaña Configuración.

  2. Completa los campos REST Endpoint y Token con los datos de tu cuenta de Braze.

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

  1. Haz clic en Guardar. La extensión valida la conexión con Braze y confirma el guardado. Si el REST Endpoint o el token son incorrectos, muestra un mensaje de error.

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

 

Crear la automatización de WhatsApp

En la extensión, accede a Automatización de WhatsApp. El asistente tiene tres etapas: Configurar bot, Configurar mensaje e Instalar automatización.

Configurar el bot

En Configurar bot, selecciona el Bot router principal con WhatsApp conectado que realizará el envío y haz clic en Guardar y continuar. Las plantillas de WhatsApp aprobadas se cargan desde este Router. Si aparece el aviso "Whatsapp no reconocido en este bot", el Router seleccionado no tiene WhatsApp conectado.

Seleccionar la plantilla de mensaje

En Configurar mensaje, haz clic en Seleccionar plantilla y elige la plantilla de mensaje activo aprobada que se utilizará en el envío.

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

Si la plantilla tiene medios, completa el campo Enlace de medios. Si la plantilla tiene un botón, completa el campo Variable del botón. Las variables de la plantilla se completan con los atributos del contacto en Braze, como [first_name], [phone_number] y [custom.field] para atributos personalizados.

Colocar al usuario en el bot

Para solo notificar al contacto, mantén desactivada la opción Colocar usuario en el bot.

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

Para dirigir al contacto a un punto del journey después del envío, activa la opción y selecciona el Bot y el Flujo de destino.

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

Haz clic en Continuar. La extensión genera la URL del webhook que usarás en Braze.

Instalar la automatización en Braze

En Instalar automatización, elige cómo se usará el webhook: Campaña o Canvas. La extensión muestra los pasos y la URL que se configurará en Braze.

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

 

Configurar el webhook en una campaña de Braze

  1. Accede a tu cuenta en Braze.

  2. En el menú Messaging, selecciona Campaigns y crea una campaña.

  3. Elige el canal Webhook.

  4. Desplázate hacia abajo y haz clic en Blank Template.

  5. Completa Webhook URL con el enlace generado por la extensión.

  6. Para plantillas con variables dinámicas, haz clic en Add New Body Property y, en la primera Key, indica el número de la variable y el valor correspondiente. Por ejemplo, en una plantilla con una variable, usa el atributo del nombre del contacto.

  7. Continúa a la siguiente etapa y define la audiencia y la activación de la campaña.

  8. Activa la campaña.

 

Configurar el webhook en un Canvas de Braze

  1. Accede a tu cuenta en Braze.

  2. En el menú Messaging, selecciona Canvas y crea el journey.

  3. En el punto en el que quieras enviar el mensaje por WhatsApp, agrega una acción de tipo Message, en la categoría Basic Components.

  4. Selecciona el canal Webhook y haz clic en Blank Template.

  5. Completa Webhook URL con el enlace generado por la extensión.

  6. Para plantillas con variables dinámicas, haz clic en Add New Body Property e indica el número de la variable y el valor en la primera Key.

  7. Guarda el webhook haciendo clic en Done.

  8. Activa el flujo haciendo clic en Launch Canvas.

 

Probar el envío

Antes de activar la campaña o el Canvas, usa la opción Test en la parte superior de la pantalla de Braze, seleccionando un usuario existente o creando uno de ejemplo. Verifica que:

  • el webhook devuelva una respuesta exitosa;

  • el contacto tenga un teléfono válido en el atributo utilizado por la automatización;

  • todas las variables de la plantilla estén completas;

  • la plantilla esté aprobada y activa en Blip;

  • el mensaje haya llegado al contacto correcto;

  • la colocación en el bot haya ocurrido según lo configurado, cuando esta opción esté activa.

Publica la campaña o el Canvas solo después de validar el envío. Si cambias la plantilla de mensaje, revisa la configuración de la automatización, ya que las variables pueden cambiar.

 

Soporte

Si tienes dudas o problemas, contacta al equipo de soporte de Wiv por correo electrónico en support@wiv.com.br.


 

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃

 

Artículos relacionados