Skip to content

Talkable

Talkable ayuda a las marcas de consumo a convertir a los clientes satisfechos en un canal de referidos escalable. Con la integración de Braze, las adhesiones voluntarias de correo electrónico de marketing capturadas en campañas de referidos de Talkable fluyen hacia Braze en tiempo real, proporcionando a tu equipo el consentimiento, el contexto y los datos de campaña que necesitas para dar la bienvenida, segmentar e interactuar con cada nuevo promotor y amigo.

Esta integración es mantenida por Talkable.

Acerca de la integración

Talkable incorpora la adquisición liderada por promotores en el recorrido del cliente que Braze impulsa. La integración traslada cada adhesión voluntaria de referido que Talkable captura al perfil de Braze correspondiente en tiempo real, de modo que los flujos de bienvenida, los recorridos de referidos, la segmentación y la mensajería del ciclo de vida pueden lanzarse a partir de un consentimiento confiable y un contexto de referido, todo sin exportaciones manuales de listas ni sincronizaciones por lotes.

Talkable captura adhesiones voluntarias de marketing en dos escenarios:

  • Registro de promotor: Un promotor se registra en una campaña de referidos de Talkable y consiente recibir correo electrónico de marketing.
  • Acceso por correo electrónico del amigo: Un amigo completa el paso de acceso por correo electrónico de Talkable y acepta recibir correo electrónico de marketing.

En cualquiera de los dos casos, Talkable crea o actualiza el perfil de usuario de Braze correspondiente en tiempo real y establece el estado de suscripción de correo electrónico del usuario como Opted In.

Comportamiento predeterminado

Talkable envía datos a Braze solo ante un evento discreto de adhesión voluntaria de alguien que ha dado su consentimiento explícito en Talkable, ya sea un promotor que se registra en una campaña o un amigo que acepta durante el acceso por correo electrónico. Talkable no ejecuta lotes nocturnos, sincronizaciones completas ni actualizaciones implícitas de perfiles. Talkable nunca envía a Braze perfiles que no hayan aceptado.

Casos de uso

  • Desencadenar un Canvas de bienvenida en Braze en el momento en que un promotor se registra en una campaña de referidos de Talkable.
  • Activar a los amigos referidos con un Canvas específico para amigos y una oferta personalizada de primera compra tan pronto como un amigo acepta.
  • Segmentar por contexto de referido utilizando indicadores de promotor y amigo y metadatos de campaña enviados como atributos personalizados de Braze.
  • Dirigir las adhesiones voluntarias de referidos a un grupo de suscripción designado de Braze para envíos de boletines que cumplan con las normativas.

Requisitos previos

Antes de empezar, necesitas lo siguiente:

Requisito Descripción
Una cuenta de Talkable Se requiere un sitio de Talkable con al menos una campaña configurada para aprovechar esta asociación.
Una clave de API REST de Braze Una clave de API REST de Braze con permisos de users.track. Crea esta clave en el dashboard de Braze desde Configuración > Claves de API. Para más información, consulta Crear claves de API REST.
Un punto de conexión REST de Braze La URL de tu punto de conexión REST de Braze (por ejemplo, https://rest.iad-01.braze.com). Se admiten tanto los clústeres de Braze en EE. UU. (.com) como en la UE (.eu). Para más información, consulta Puntos de conexión de la REST API.

Integración

Paso 1: Instalar la aplicación de Braze en Talkable

  1. Inicia sesión en tu panel de administración de Talkable y abre el menú, luego ve a All Site Settings > App Store.
  2. Localiza Braze y selecciona Install.
  3. Introduce tu punto de conexión REST de Braze y una clave de API REST con permisos de users.track, luego selecciona Save.

Paso 2: Configurar la acción de adhesión voluntaria de correo electrónico

  1. En la aplicación de Braze en Talkable, abre la acción Email opt-in.
  2. (Opcional) Introduce un identificador de grupo de suscripción de Braze, añade atributos personalizados y/o configura un alias de usuario. Para más información, consulta Personalizar Talkable.
  3. Selecciona Save. Deja la acción deshabilitada para que puedas verificar la configuración con una carga útil de prueba antes de que cualquier evento de adhesión voluntaria en vivo comience a sincronizarse.

Paso 3: Probar con una carga útil de ejemplo

  1. En Talkable, selecciona Send sample payload en la acción Email opt-in para enviar una solicitud de prueba a Braze.
  2. En Braze, ve a Audiencia > Búsqueda de usuarios y busca por la dirección de correo electrónico de prueba.
  3. Confirma que el perfil existe con Email Subscribe establecido como Opted In y que cualquier atributo personalizado, inscripción en grupo de suscripción o alias de usuario que hayas configurado aparece como se esperaba.

Paso 4: Habilitar la acción para tráfico en vivo

Cuando el perfil de prueba se vea correcto en Braze, regresa a Talkable y habilita la acción Email opt-in.

A partir de este momento, cada evento de adhesión voluntaria de Talkable sincroniza el perfil correspondiente con Braze en tiempo real.

Atributos de usuario predeterminados enviados a Braze

En cada evento de adhesión voluntaria, Talkable crea o actualiza el perfil de usuario de Braze correspondiente con los siguientes atributos estándar de usuario de Braze. Los valores vacíos se omiten.

Atributo de Braze Tipo Notas
email_subscribe Cadena Se establece como Opted In en cada evento de adhesión voluntaria de Talkable.
email Cadena Identificador principal utilizado para hacer coincidir el perfil de Braze.
phone Cadena Se captura solo como atributo de usuario. Braze espera formato E.164; se envía tal como está almacenado en Talkable.
first_name Cadena El nombre de la persona.
last_name Cadena El apellido de la persona.
Inscripción en grupo de suscripción No aplica Se añade solo cuando se configura un grupo de suscripción. El usuario se inscribe como suscrito.
Alias de usuario No aplica Se añade solo cuando se configura un alias de usuario. Para más información, consulta Personalizar Talkable.

Personalizar Talkable

Las siguientes personalizaciones opcionales están disponibles. Configura cualquier combinación; son independientes.

Inscribir adhesiones voluntarias en un grupo de suscripción de Braze

  1. En Braze, copia un ID de grupo de suscripción desde Audiencia > Administración del grupo de suscripción. Para más información, consulta Administrar suscripciones de usuarios.
  2. En la acción Email opt-in de Talkable, pégalo en el campo Subscription group identifier.

Talkable inscribe cada adhesión voluntaria en ese grupo de suscripción como suscrito, limitando las adhesiones voluntarias de referidos a ese grupo en lugar de una suscripción global. Talkable solo añade suscripciones; nunca las elimina.

Enviar atributos personalizados

Añade cualquier par clave-valor en el editor de carga útil de la acción. La clave que introduzcas se convierte en el nombre del atributo en el perfil de usuario de Braze.

Los valores utilizan plantillas Liquid. Las siguientes variables están disponibles:

Variable Contenido
{{ person }} El promotor o amigo que aceptó (email, first_name, last_name, phone_number, username, is_advocate, custom_properties, y más).
{{ ip }} La dirección IP desde la cual se produjo la adhesión voluntaria.
{{ campaign }} La campaña de Talkable de origen (name, type, tag_names, y más).

Ejemplo: añade talkable_is_advocate = {{ person.is_advocate }} y talkable_campaign_name = {{ campaign.name }} para segmentar por contexto de referido en Braze.

Identificar usuarios con alias de usuario de Braze

En el editor de carga útil, añade user_alias.alias_name (por ejemplo, {{ person.username }}) y user_alias.alias_label (por ejemplo, username). Para más información, consulta Objeto de alias de usuario.

Cuando ambos campos están presentes, el sistema identifica al usuario por el alias además del correo electrónico, y Braze crea un nuevo perfil con alias si no existe una coincidencia.

Buscar y crear usuarios en Braze

  • De forma predeterminada, Braze hace coincidir el perfil por dirección de correo electrónico. Si no existe un perfil coincidente, Braze crea uno nuevo.
  • Cuando se configura un alias de usuario, Braze también hace coincidir por ese alias y crea un nuevo perfil con alias si no existe una coincidencia.
  • Los ID externos no se utilizan en esta integración. Para vincular las adhesiones voluntarias de Talkable a un perfil identificado externamente existente, configura un alias de usuario cuya etiqueta coincida con el alias conocido de ese perfil.

Usar Talkable con Braze

Buscar un usuario sincronizado

Ve a Audiencia > Búsqueda de usuarios y busca por correo electrónico para ver un perfil que Talkable creó o actualizó.

Los campos estándar (correo electrónico, teléfono, nombre o apellido) y cualquier atributo personalizado que hayas configurado aparecen en el perfil; Email Subscribe muestra Opted In.

Crear un segmento de referidos

  1. Crea un segmento filtrado por Email Subscribe es Opted In.
  2. Refina con los atributos personalizados que Talkable envía; por ejemplo, talkable_is_advocate igual a true para dirigirte a promotores, o talkable_campaign_name igual a tu campaña para dirigirte a un programa de referidos específico.

Desencadenar mensajería del ciclo de vida

  1. Crea un Canvas o una campaña con entrega basada en acciones. Los siguientes tipos de desencadenadores de Braze funcionan con esta integración:
    • Update Subscription Status (por ejemplo, la suscripción de correo electrónico cambia a Opted In)
    • Update Subscription Group Status (cuando se configura un grupo de suscripción)
    • Change Custom Attribute Value (para cualquier atributo personalizado de Talkable que envíes).
  2. Personaliza los mensajes con los atributos personalizados de Talkable en el perfil (nombre de campaña, valor de recompensa, referente, etc.).

Consideraciones

  • Solo adhesión voluntaria de correo electrónico: Los números de teléfono se capturan como un atributo estándar de usuario, pero la integración no establece un estado de suscripción de SMS. Talkable no sincroniza adhesiones voluntarias de SMS.
  • Formato de teléfono: Braze espera los números de teléfono en formato internacional (E.164).
  • Sincronización en tiempo real basada en eventos: Talkable envía una solicitud por evento de adhesión voluntaria (un usuario por solicitud). No hay procesamiento por lotes ni sincronización periódica completa; el volumen sigue tu volumen de adhesiones voluntarias de referidos.
  • Entrega confiable: Si Braze devuelve temporalmente un error, Talkable reintenta automáticamente. Los fallos persistentes envían una alerta por correo electrónico al administrador del sitio.

Solución de problemas

Error Causa probable Solución
401 Unauthorized La clave de API REST no tiene los permisos de users.track, o el punto de conexión apunta al clúster incorrecto. Vuelve a emitir la clave con los permisos de users.track y confirma que el punto de conexión REST coincide con tu clúster de Braze.
Punto de conexión REST rechazado durante la instalación La URL no es un punto de conexión REST de Braze. Usa el punto de conexión REST de tu clúster, por ejemplo https://rest.iad-01.braze.com. Una URL del dashboard no funciona.
Perfil creado pero no en un grupo de suscripción No se configuró un ID de grupo de suscripción. Introduce el ID del grupo de suscripción en la acción Email opt-in.
Alias de usuario no aplicado Solo se completó uno de los dos campos de alias (nombre o etiqueta). Introduce ambos campos en la acción: nombre de alias y etiqueta de alias.
El perfil no aparece La solicitud de ejemplo aún no se envió, o la acción está deshabilitada. Selecciona Send sample payload en Talkable y asegúrate de que la acción Email opt-in esté habilitada.
Las solicitudes dejaron de enviarse después de una rotación de clave La clave de API almacenada fue revocada o reemplazada en Braze. En el App Store de Talkable, abre la aplicación de Braze, pega la nueva clave de API REST y selecciona Save; vuelve a probar con Send sample payload.

Para más información sobre la integración de Talkable, consulta la documentación de integración de Talkable con Braze. Para contactar con el soporte de Talkable, envía un correo electrónico a [email protected].
New Stuff!