ReferralCandy es una plataforma de marketing de referencias diseñada para marcas de comercio electrónico. Te permite ejecutar programas de "referir-a-un-amigo" donde los clientes ganan recompensas por atraer nuevos compradores.
Al conectar ReferralCandy con Omnisend, puedes convertir la actividad del programa de referidos en eventos de contacto – para que puedas activar correos electrónicos o SMS automatizados y construir segmentos basados en lo que sucede dentro de tu programa de referidos.
En este artículo, aprenderás cómo conectar ReferralCandy a Omnisend, habilitar las tres automatizaciones disponibles y usar los datos que envían.
Antes de empezar
Necesitas una cuenta de Omnisend activa.
Necesitas una cuenta de ReferralCandy activa con una campaña de referidos en marcha.
Sus credenciales de API de ReferralCandy (ID de acceso a la API y secreto de la API) son necesarias para autenticar la conexión.Puedes encontrarlos en tu panel de control de ReferralCandy bajo Cuenta Tokens de API.
Beneficios
Automatiza las comunicaciones de tu programa de referidos: Envía correos electrónicos o SMS en el momento en que un defensor se inscribe, se confirma una compra de referido o se gana una recompensa.
Entregar recompensas al instante: La carga útil del evento Recompensa Ganada incluye el código de cupón, la descripción y la fecha de caducidad para que puedas enviar la recompensa directamente desde un Flujo de Automatización.
Construir segmentos específicos: Identifica a los defensores que han ganado recompensas, contactos que refirieron al menos a un amigo, o defensores que aún no han generado compras.
Cómo funciona
La integración consulta ReferralCandy cada 12 horas (desde el momento en que habilitas cada automatización) y envía nueva actividad a Omnisend como eventos personalizados.Cada evento está vinculado al contacto relevante (el defensor) en Omnisend.
Los siguientes eventos se sincronizan a Omnisend desde ReferralCandy:
Nombre del evento en Omnisend | Se activa cuando |
| La compra de un amigo referido se atribuye a un defensor |
| Un nuevo defensor se une al programa de referencias |
| Un defensor gana una recompensa |
Los eventos aparecen en Omnisend dentro de hasta 12 horas de que la actividad ocurra en ReferralCandy.La única actividad que ocurre después de que habilites una automatización fluye; el historial de referencias pasadas no se rellena.
Proceso de Configuración
Paso 1. Obtenga sus credenciales de API de ReferralCandy
Inicia sesión en tu cuenta de ReferralCandy.
Ve a Cuenta → Tokens de API.
Copie tanto su ID de acceso a la API como su secreto de la API.
Paso 2. Conectar ReferralCandy a Omnisend
Inicia sesión en tu cuenta de Omnisend y ve a Apps.
Busca ReferralCandy y abre la aplicación.
Ingrese su ID de acceso a la API y secreto de la API en los campos correspondientes y haga clic en Conectar.
Omnisend validará tus credenciales contra ReferralCandy.Una vez confirmado, verás una insignia de Conectado junto al nombre de la aplicación.
Paso 3. Habilitar las automatizaciones
Después de conectar, verás una sección de Automatizaciones con tres interruptores.Activa los que deseas usar:
ReferralCandy - Referencia completada Omnisend
ReferralCandy - Defensor inscrito Omnisend
ReferralCandy - Recompensa ganada Omnisend
Cada automatización es independiente – habilita solo las que sean relevantes para tu configuración.Una vez activada, la automatización comienza a consultar ReferralCandy cada 12 horas.
¡Eso es! ReferralCandy ahora enviará automáticamente nuevos eventos de referencia a Omnisend.
Qué datos se envían
Cada automatización envía un evento personalizado a Omnisend con un conjunto de propiedades.Esto es lo que incluye cada evento:
ReferralCandy - Defensor inscrito
Se activa cuando un nuevo defensor se une a tu programa de referencias.El evento está vinculado al contacto del defensor en Omnisend.
Propiedad | Descripción |
| ID de ReferralCandy del defensor |
| Correo electrónico del abogado |
| Nombre del defensor |
| Apellido del defensor |
| Si el defensor ha realizado una compra ( |
| Array de las compras del defensor |
| La propia bandera de cancelación de suscripción de ReferralCandy para este contacto ( |
Ejemplo de carga útil:
{ "id": 430711176, "first_name": "first", "last_name": "last", "email": "[email protected]", "purchase_made": false, "purchases": [], "unsubscribed": false }
ReferralCandy - Referencia completada
Se activa cuando la compra de un amigo referido se atribuye a un defensor.El evento está vinculado al contacto del defensor así que puedes enviarles un mensaje cuando un contacto que refirieron haga una compra.
Propiedad | Descripción |
| Correo electrónico del defensor |
| La dirección de correo electrónico del amigo referido |
| Cuando ocurrió la referencia (marca de tiempo Unix) |
| ID de campaña de referencia |
| Si el período de revisión de ReferralCandy para esta referencia ha terminado ( |
| El ID de pedido de la tienda para la compra referida |
Ejemplo de carga útil:
{ "campaignId": 125143, "external_reference_id": "1480", "referral_email": "[email protected]", "referral_timestamp": 1781607304, "referring_email": "[email protected]", "review_period_over": true }
ReferralCandy - Recompensa Ganada
Se activa cuando un defensor gana una recompensa, después de que finaliza el período de revisión de ReferralCandy.El evento está vinculado al contacto del defensor.
Propiedad | Descripción |
| Correo electrónico del abogado |
| Nombre del defensor |
| Tipo de recompensa (por ejemplo, |
| Descripción de la recompensa legible por humanos (por ejemplo, "un descuento de €50") |
| El código del cupón de recompensa |
| Fecha de expiración del cupón (timestamp Unix) |
| Si el cupón ha sido canjeado ( |
| Estado de la recompensa (por ejemplo, |
| Cuando se ganó la recompensa (timestamp Unix) |
| ID de recompensa |
| Enlace al descuento subyacente de Shopify |
Ejemplo de carga útil:
{ "advocate_email": "[email protected]", "advocate_name": "Advocate Name", "coupon_code": "THANKS-XXXXXX", "coupon_code_data": { "shopify_graphql_discount_code_id": "gid://shopify/DiscountCodeNode/0000000000" }, "coupon_code_expiry_timestamp": 1786792518, "coupon_used": false, "created_at": 1781608518, "description": "a €50 discount", "id": 7427724, "status": "delivered", "type": "coupon" }Nota: Cada evento utiliza un nombre de campo diferente para la dirección de correo electrónico del defensor. Al crear segmentos o flujos de trabajo que abarcan múltiples eventos, utiliza el campo correcto para cada evento.
Evento | Campo de correo electrónico del defensor |
Defensor Inscrito |
|
Referencia Completada |
|
Recompensa Ganada |
|
El correo electrónico del amigo referido (referral_email) está disponible solo en el evento Referencia Completada.
Construir flujos de trabajo de automatización
Una vez que la integración esté activa, utiliza los eventos personalizados como disparadores en los flujos de trabajo de Automatización de Omnisend:
Defensor Inscrito → Enviar un correo electrónico de bienvenida explicando cómo funciona el programa de referidos y compartiendo el enlace de referido del defensor.
Referencia completada Notifica al defensor que el contacto que refirieron acaba de hacer una compra, reforzando el comportamiento.
Recompensa Ganada → Correo electrónico al defensor su recompensa. La carga útil del evento incluye el código de cupón (
codigo_cupon), la descripción (descripción), y la fecha de expiración (timestamp_expiracion_codigo_cupon).
También puedes usar los eventos para segmentación de contactos – por ejemplo, "defensores que han ganado al menos una recompensa" o "defensores sin referencias completadas aún" para una campaña de reenganche.
Cosas a Saber
Los eventos no son instantáneos. La integración consulta ReferralCandy cada 12 horas. Espera que los eventos aparezcan en Omnisend dentro de hasta 12 horas después de que ocurra la actividad en ReferralCandy.
No hay relleno histórico. Habilitar una automatización no reproduce la actividad de referencia pasada. Solo los eventos que ocurren después de habilitar fluyen hacia Omnisend.
No hay eventos duplicados. Cada referencia, recompensa y inscripción de defensor se envía a Omnisend una vez. La integración rastrea lo que ya ha sido sincronizado.
No hay consentimiento de marketing. Los contactos creados a través de esta integración están configurados parano suscrito por defecto. No recibirán correos electrónicos de marketing ni SMS hasta que se inscriban a través de un Formulario de suscripción de Omnisend.
Tiempo de recompensa. El evento Recompensa Ganada solo se activa después de que finaliza el período de revisión de ReferralCandy para la referencia vinculada. Esto significa que Recompensa Ganada siempre llegará después de Referencia Completada para la misma referencia.
Solo lectura. La integración lee datos de ReferralCandy. No escribe nada de vuelta a ReferralCandy.
Solución de Problemas
Un evento no aparece en Omnisend
Revisa en este pedido:
¿Lo registró ReferralCandy? Ve aCompras y Referencias en tu cuenta de ReferralCandy y confirma que la referencia esté atribuida o que la recompensa exista. Si no está allí, el problema está del lado de ReferralCandy.
¿Se ha ejecutado una encuesta ya? Los eventos aparecen después de la próxima encuesta de 12 horas. Espera el intervalo completo antes de asumir un problema.
¿Está habilitada la automatización? Confirma que la automatización relevante esté activada en Omnisend.
¿Son las credenciales aún válidas? Si su ID de acceso a la API o secreto de la API fue rotado en ReferralCandy, actualice la conexión en Omnisend con las nuevas credenciales.
La recompensa no ha llegado, pero la referencia sí
Esto es lo esperado. Recompensa Ganada solo se activa después de que finaliza el período de revisión de ReferralCandy para esa referencia.El Delay entre la Referencia Completada y la Recompensa Ganada es normal.
FAQ
¿Qué estado de suscripción obtienen los nuevos contactos?
Los contactos creados a través de esta integración se establecen como no suscritos por defecto.No recibirán correos electrónicos de marketing ni SMS hasta que se inscriban a través de un Formulario de suscripción de Omnisend.
¿Puedo ejecutar solo algunas de las tres automatizaciones?
Sí. Cada automatización es independiente.Activa solo las que necesitas y deja las otras desactivadas.
¿Puedo usar el correo electrónico del amigo referido en una automatización?
El correo electrónico del amigo referido (referral_email) está incluido en la carga útil del evento de Referencia Completa.Sin embargo, ese evento está vinculado al contacto del defensor no al del amigo.Para enviar un mensaje directamente al amigo, necesitarías crear un contacto para ellos por separado.
¿La integración sincroniza datos históricos de referencias?
No. La única actividad que ocurre después de que habilites una automatización se envía a Omnisend.Las referencias y recompensas pasadas no se rellenan.
Ocurrió una referencia en mi tienda, pero no llegó ningún evento a Omnisend. ¿Qué debo verificar?
Primero, verifica si ReferralCandy atribuyó la referencia a un defensor.Si la detección de fraude de ReferralCandy bloqueó la atribución (por ejemplo, una auto-referencia), no se enviará ningún evento a Omnisend – ese resultado se decide completamente dentro de ReferralCandy.
¿Puedo usar estos eventos en campañas de Correo electrónico?
Estos eventos están diseñados como disparadores para flujos de trabajo de automatización.Para enviar una campaña única, crea un segmento basado en el evento personalizado (por ejemplo, contactos que tienen el evento ReferralCandy - Recompensa Ganada) y envía una campaña a ese segmento.
¿Atascado o inseguro de qué hacer a continuación? Comunícate con nuestro equipo de soporte en cualquier momento a través del chat en la aplicación o en[email protected]. Para preguntas específicas de ReferralCandy, contactasoporte de ReferralCandy