Cómo integrar StopChurn

Aprenda a conectar StopChurn con B2CORE para sincronizar datos de clientes y eventos clave para los procesos de retención y CRM

Utilice la integración con StopChurn para enviar automáticamente los datos de los clientes y los eventos clave desde B2CORE a StopChurn, una plataforma de retención de clientes y CRM. StopChurn puede utilizar estos datos para segmentar a los clientes y ejecutar campañas de retención.

La integración permite transferir datos únicamente de B2CORE a StopChurn. B2CORE es la única fuente de información fiable: StopChurn solo recibe datos y no se recupera ningún dato de StopChurn para incorporarlo a B2CORE.

Antes de continuar, asegúrese de tener acceso al Back Office de StopChurn y de haber recibido una clave de API y un ID de marca de StopChurn. Si tiene alguna pregunta, póngase en contacto con el equipo de StopChurn.

Prepare StopChurn

Complete estos pasos en StopChurn antes de habilitar la conexión en B2CORE.

Compruebe los campos de la tabla de contactos

En el Back Office de StopChurn, vaya a Base de datos > Definiciones de tablas y abra la tabla de usuarios (contactos). B2CORE rellena los siguientes campos para cada contacto de StopChurn:

Identidad: ID, correo electrónico, teléfono, nombre, apellidos, fecha de nacimiento
Ubicación y perfil: país (nombre), código de país, moneda, jurisdicción, idioma, tipo de cliente (particular o empresa), fecha de registro, nivel de verificación
KYC: estado de KYC, fecha de presentación de KYC, fecha de aprobación de KYC
Depósitos: fecha e importe del primer y del último depósito, importe total de los depósitos, depósito neto
Operaciones: fecha de la primera y la última operación, número total de operaciones, fecha de apertura de la cuenta de operaciones
Atribución de marketing: fuente UTM, medio UTM, campaña UTM, ID de afiliado
Preferencias de marketing (correo electrónico y teléfono): desactivadas cuando el cliente se ha dado de baja de las comunicaciones de marketing o no ha dado su consentimiento para recibirlas
Preferencias del sistema (correo electrónico y teléfono): siempre activadas

Las fechas se envían como marcas de tiempo. La moneda del contacto siempre es USD, y todos los importes de depósito del contacto están expresados en USD.

Cree eventos personalizados

B2CORE envía seis eventos personalizados a StopChurn. Cree cada uno en Base de datos > Definiciones de tablas haciendo clic en Nuevo evento personalizado:

Nombre — debe coincidir exactamente con el valor de la tabla siguiente.
Etiqueta — cualquier texto que prefiera.
Tipo de valor — obligatorio; debe coincidir con el valor de la tabla siguiente.

Evento	Nombre	Tipo de valor	Valor
Registro completado	`REGISTRATION_COMPLETED`	`BOOLEAN`	Siempre `true`
Nivel de verificación modificado	`VERIFICATION_LEVEL_CHANGED`	`NUMBER`	El nuevo nivel de verificación del cliente
KYC aprobado	`KYC_APPROVED`	`BOOLEAN`	Siempre `true`
KYC rechazado	`KYC_REJECTED`	`STRING`	El motivo del rechazo (puede estar vacío)
Depósito completado	`DEPOSIT_COMPLETED`	`JSON`	Detalles del depósito (consulte Campos de los eventos de depósito)
Primer depósito	`FIRST_DEPOSIT`	`JSON`	Detalles del depósito (consulte Campos de los eventos de depósito). Se envía únicamente para el primer depósito completado correctamente del cliente

Cree los seis eventos antes de habilitar la conexión. Si falta un evento en StopChurn o tiene un tipo de valor incorrecto, StopChurn lo rechaza y el evento se pierde. Los eventos rechazados no se vuelven a enviar.

Campos de los eventos de depósito

Los eventos Depósito completado y Primer depósito contienen los siguientes campos:

amount — el importe del depósito en la moneda del depósito.
currency — la moneda del depósito, por ejemplo, EUR.
amountInUSD — el importe del depósito convertido a USD según el tipo de cambio vigente en el momento en que se completó el depósito, redondeado a 2 decimales. Queda vacío si B2CORE no disponía de un tipo de cambio a USD para la moneda del depósito en ese momento; el evento se envía de todos modos.
paymentSystem — el nombre del método de depósito que utilizó el cliente, exactamente como se especifica en el campo Nombre del método en Sistema > Sistema de depósitos, por ejemplo, b2binpay_enterprise.

Si utiliza el evento de depósito como objetivo de conversión en StopChurn, establezca amountInUSD como valor del objetivo para que todos los depósitos se midan en una sola moneda.

Asigne a sus métodos de depósito nombres claros y estables. Si cambia el nombre de un método de depósito, StopChurn recibirá el nuevo nombre para todos los depósitos futuros realizados con ese método. Por tanto, los segmentos y recorridos de StopChurn filtrados por el nombre anterior dejarán de incluir esos depósitos.

Configure una conexión con StopChurn en el Back Office de B2CORE

Para configurar una conexión con StopChurn:

Vaya a Sistema > Conexiones externas.

Haga clic en +Crear en la esquina superior derecha de la página.

En la página Crear conexión, rellene los siguientes campos:

En el campo Nombre, introduzca un nombre para la conexión. El nombre debe ser único.
En el campo Título, introduzca un título que se aplicará a la conexión en el Back Office.
En el menú desplegable Proveedor, seleccione StopChurn.

Haga clic en Guardar para crear la conexión.

La conexión StopChurn aparecerá en la lista de conexiones externas.

Haga clic en Editar para introducir los detalles de la conexión y complete los siguientes campos:

Entorno — seleccione el entorno de StopChurn: Staging o Production.
Clave de API — introduzca la clave de API proporcionada por StopChurn.
ID de marca — introduzca el ID de la marca de StopChurn que recibe los datos.
Nombre de la tabla de usuarios — opcional. Déjelo vacío para utilizar la tabla user predeterminada de StopChurn.
Estrategia de ID externo — seleccione el valor que B2CORE utiliza como ID del contacto en StopChurn:
- ID de cliente de B2CORE (predeterminado)
- Correo electrónico del cliente de B2CORE
- UUIDv7 aleatorio
Prefijo del ID externo — texto opcional que se añade delante del ID del contacto. Caracteres permitidos: letras, dígitos y _ . : -; hasta 32 caracteres. Utilice un prefijo cuando varias marcas o instancias de B2CORE compartan una cuenta de StopChurn, para que sus ID de contacto no coincidan.

Haga clic en Probar conexión para comprobar que StopChurn acepta la clave de API. La prueba no crea ni modifica ningún dato en StopChurn.

Compruebe el estado de la conexión.

Si la conexión está inactiva (se muestra No en el campo Habilitada), actívela seleccionando Yes en el menú desplegable Habilitada.

Haga clic en Guardar para aplicar los cambios.

El ID de contacto de un cliente en StopChurn queda fijado la primera vez que se envía el cliente. Si cambia posteriormente la Estrategia de ID externo o el Prefijo del ID externo, el cambio solo se aplicará a los clientes que aún no se hayan enviado. Los contactos existentes conservan sus ID, por lo que StopChurn nunca recibe duplicados.

Puede habilitar varias conexiones de StopChurn a la vez, por ejemplo, una por cada marca de StopChurn. Cada conexión habilitada recibe todos los datos y eventos de los clientes.

Para enviar sus clientes existentes a StopChurn después de habilitar y probar la conexión, solicite una carga inicial.

Datos enviados a StopChurn

B2CORE envía datos a StopChurn automáticamente. Aproximadamente un minuto después de cualquiera de las acciones siguientes, B2CORE envía el registro de contacto completo y actualizado del cliente junto con los eventos relacionados:

Acción en B2CORE	Eventos enviados
El cliente se registra	Registro completado
Cambian el correo electrónico, el estado, el país, el tipo de cliente, el nivel de verificación o la jurisdicción del cliente	—
Cambian el nombre, los apellidos o la fecha de nacimiento del cliente	—
Cambia el número de teléfono del cliente	—
El cliente presenta una solicitud de verificación	Nivel de verificación modificado
Se aprueba una solicitud de verificación	Nivel de verificación modificado, KYC aprobado
Se rechaza una solicitud de verificación	Nivel de verificación modificado, KYC rechazado (con el motivo)
Se completa correctamente un depósito	Depósito completado; también Primer depósito si es el primer depósito completado correctamente del cliente
El cliente se da de baja de las comunicaciones de marketing o vuelve a suscribirse	—

Cada envío actualiza por completo el contacto en StopChurn, por lo que es seguro enviar al mismo cliente más de una vez.

Carga inicial de todos los clientes

Los envíos automáticos solo incluyen a los clientes con actividad nueva. Para enviar todos sus clientes existentes a StopChurn, se requiere una carga inicial. Si necesita una carga inicial, póngase en contacto con el equipo de soporte de B2BROKER para obtener ayuda después de crear y probar la conexión con StopChurn.

Resincronice los contactos actualizados recientemente

Utilice Resincronizar contactos para enviar a StopChurn todos los clientes cuyos perfiles se hayan actualizado durante el último mes. Ejecute esta acción para poner StopChurn al día después de una interrupción breve o una configuración incorrecta.

Resincronizar contactos no sustituye a la carga inicial. No se incluyen los clientes que no se hayan actualizado durante el último mes.

Para resincronizar los contactos actualizados recientemente:

Vaya a Sistema > Conexiones externas y abra la conexión con StopChurn.

Haga clic en Acciones > Resincronizar contactos.

Un mensaje verde confirma que la resincronización ha comenzado. La resincronización se ejecuta en segundo plano.

Tenga en cuenta lo siguiente:

Resincronizar contactos solo está disponible para las conexiones de StopChurn habilitadas y para los usuarios del Back Office que tengan permiso para actualizar conexiones externas.
Puede ejecutar una resincronización una vez por hora y por conexión. Si vuelve a hacer clic en el botón antes de que transcurra una hora, un mensaje le indicará cuántos minutos debe esperar.
B2CORE no ejecuta resincronizaciones completas automáticamente. Entre resincronizaciones, los contactos se mantienen actualizados mediante los envíos automáticos.

Notas y limitaciones

La moneda del contacto siempre es USD, y todos los importes de depósito del contacto están expresados en USD. Los eventos de depósito incluyen tanto el importe y la moneda originales como el importe en USD (amountInUSD).
La documentación de StopChurn no indica dónde se pueden consultar los eventos recibidos. Consúltelo con el equipo de StopChurn.

Cómo integrar StopChurn

En esta página