Utilice la integración de OneSignal con ActiveCampaign para enviar notificaciones push a la web, dispositivos móviles y apps, y recibir eventos de OneSignal en ActiveCampaign cada vez que se produzca un evento. Esto le permite enviar comunicaciones directas e inmediatas a clientes actuales y potenciales, aumentar las tasas de interacción, volver a captar usuarios inactivos, personalizar las experiencias de los clientes y es un complemento rentable de su estrategia de marketing.
Este artículo explica cómo conectar OneSignal a ActiveCampaign para enviar notificaciones push y sincronizar eventos de OneSignal con ActiveCampaign.
Toma nota
- Para configurar la integración es necesario lo siguiente:
- Cuenta ActiveCampaign con permisos de automatización
- Cuenta OneSignal configurada para enviar notificaciones push
- Instalación y configuración de la app web en OneSignal
- Plantillas de notificaciones push (si se utilizan) en OneSignal. Entre las plataformas compatibles se incluyen:
- Apple iOS (APNs)
- Google Android (FCM)
- Web
- Clave de autenticación de usuario de OneSignal
- Clave API Rest de OneSignal para cada app web
- Campo ID externo de OneSignal para cada registro de suscripción rellenado con el identificador único de ActiveCampaign (dirección de correo electrónico)
- Las direcciones de correo electrónico capturadas a través de un formulario de ActiveCampaign rellenarán automáticamente el campo ID externo de OneSignal
- Nota: Póngase en contacto con su desarrollador web o de apps móviles para configurar una ruta para enviar la dirección de correo electrónico de un contacto de ActiveCampaign al ID externo de OneSignal
- Nota: OneSignal no envía la dirección de correo electrónico capturada desde la indicación del correo electrónico o del teléfono dentro de la configuración de la solicitud de permiso de la indicación
- En el caso de las notificaciones web push, OneSignal ha dejado de admitir nuevas apps de Blogger, Bubble, Squarespace, Webflow, Weebly, Wix, sitios HTTP y creadores de sitios web que no admiten la carga de Service Workers en un servidor (necesarios para las notificaciones web push). Obtén más información aquí.
Ver un vídeo
Cómo funciona la integración de Square
Esta integración ofrece dos opciones de sincronización separadas. Uno sincroniza los datos con tu cuenta de ActiveCampaign y el otro envía notificaciones push mediante automatización. Puede optar por utilizar una o ambas opciones con esta integración. Sin embargo, funcionan por separado.
Sincronización de flujos de eventos de OneSignal con ActiveCampaign
Una vez configurado, Event Streams se sincronizará con ActiveCampaign cada vez que se produzca un evento. Se envía a través de un webhook.
Notificaciones push
Para enviar notificaciones push, puede configurar la integración mediante una de las dos acciones de automatización: Puede utilizar cualquiera de las acciones de automatización, o ambas, para enviar notificaciones push:
- acción "OneSignal - Asignar una etiqueta" - esta acción le permite enviar notificaciones push móviles dentro de la app
- acción "OneSignal - Enviar notificación push" - esta acción le permite enviar notificaciones push web y web móvil
Informes
Puede encontrar informes para esta integración en su cuenta OneSignal. También puede utilizar ActiveCampaign para crear una búsqueda avanzada de todos los contactos que entraron y completaron su automatización OneSignal.
Sincronizar flujos de eventos de OneSignal con ActiveCampaign
Esta sincronización envía eventos de OneSignal a ActiveCampaign cada vez que se produce un evento.
Qué esperar
La configuración de la integración tiene lugar tanto en su cuenta de ActiveCampaign como en la de OneSignal. Le proporcionaremos un código JSON para que lo implemente en su cuenta OneSignal. Una vez completada, esta integración creará nuevos registros de contactos y actualizará los existentes en ActiveCampaign, además de sincronizar los datos de eventos correspondientes.
Tenga en cuenta que nuestro equipo de Experiencia del cliente no puede ayudarle a solucionar problemas ni a implementar códigos en su nombre.
Eventos subvencionados
Se admiten los siguientes eventos:
- Impresión en la app
- Clic en la app
- Página de la app
- Empuje Enviado
- Empuje recibido
- Empuje pulsado
- Empuje fallido
- No suscripto
Datos de OneSignal en los registros de contactos
Se crea un registro de objeto personalizado para cada contacto. Este objeto personalizado contiene los siguientes datos:
- externos,
- Marca de tiempo
- ID del evento
- Tipo de evento
- ID Mensaje
- Nombre de mensaje
- Título del mensaje
- Contenido del mensaje
- Tipo de dispositivo de suscripción
Instrucciones paso a paso
Configuración de ActiveCampaign:
- En tu cuenta de ActiveCampaign, haz clic en Apps en el menú de la izquierda.
Vista ampliada:
Vista contraída:
- Utilice la barra de búsqueda para localizar la integración OneSignal.
- Haga clic en el botón "Agregar una cuenta".
-
Aparecerá una ventana modal. Introduzca la la clave de autenticación del usuario de su cuenta OneSignal y haga clic en el botón "Connect".
Si ya ha configurado la integración de OneSignal mediante una acción de automatización, puede seleccionar la conexión existente en esta pantalla.
-
Asigne los campos entrantes de OneSignal a los campos deseados en ActiveCampaign y, a continuación, haga clic en "Finalizar"
- Requerido: Debe asignar el campo "ID externo" de OneSignal al campo "Correo electrónico de contacto" de ActiveCampaign para que la integración funcione correctamente. Si no lo hace, la sincronización fallará
- Haga clic en la flecha situada junto al botón "Editar" del recurso creado y, a continuación, haga clic en "Copiar URL de Webhook" Guarde este valor en el portapapeles o péguelo en algún lugar para futuras referencias, ya que es necesario para la configuración de OneSignal.
Configuración de OneSignal:
- Inicie sesión en su cuenta OneSignal, seleccione "Todas las apps", y elija la app a la que desea conectarse.
- Haga clic en "Flujos de eventos" en el menú "Datos".
- Haga clic en "Nuevo flujo de eventos"
- Nombre el Flujo de Eventos como desee y haga clic en "Seleccionar Eventos" En el modal emergente, seleccione todos los eventos en las secciones "In-App Message" y "Push Notification" y haga clic en "Done"
- Pega la URL del Webhook que copiaste en el último paso de la configuración de ActiveCampaign en el campo URL.
- En la sección Cabeceras, añada una entrada con una clave "Content-Type" y un valor "app/json"
-
En la sección Cuerpo, seleccione "Cuerpo personalizado" en el menú desplegable. Sustituya el contenido de la sección por el siguiente JSON:
{
"event.kind": "{{ event.kind }}",
"event.id": "{{ event.id }}",
"event.timestamp": "{{ event.timestamp }}",
"event.datetime": "{{ event.datetime }}",
"event.app_id": "{{ event.app_id }}",
"event.subscription_device_type": "{{ event.subscription_device_type }}",
"event.subscription_id": "{{ event.subscription_id }}",
"event.onesignal_id": "{{ event.onesignal_id }}",
"event.external_id": "{{ event.external_id }}",
"message.id": "{{ message.id }}",
"message.name": "{{ message.name }}",
"message.title": "{{ message.title.en }}",
"message.contents": "{{ message.contents.en }}",
"template_id": "{{ message.template_id }}",
"message.template_id": "{{ message.template_id }}",
"message.url": "{{ message.url }}",
"message.app_url": "{{ message.app_url }}",
"message.web_url": "{{ message.web_url }}"
}El código JSON anterior debe copiarse tal cual; de lo contrario, la integración no funcionará correctamente.
- Haga clic en "Activar" para guardar y activar el flujo de eventos.
Conecte OneSignal a ActiveCampaign con la acción de automatización "OneSignal - Asignar una etiqueta".
Debe crear segmentos en OneSignal para utilizar esta acción de automatización. Una vez definido el segmento, puede enviar notificaciones móviles in-app directamente desde OneSignal. ActiveCampaign no puede enviar directamente notificaciones push in-app desde automatizaciones.
Qué esperar
Esta configuración consta de tres pasos principales:
- Cree un segmento en OneSignal utilizando el filtro "Etiquetas de usuarios" para el par clave/valor que utilizará al configurar la acción de automatización.
- Configure la notificación push en OneSignal para apps móviles.
- Añade la acción "OneSignal - Asignar una etiqueta" a tu automatización. En este paso, introducirá su clave API de OneSignal y creará un par clave/valor durante la configuración. Este par clave/valor debe coincidir con el segmento que creó en OneSignal. Cuando hayas terminado, establece tu automatización en "activa".
Cuando un contacto pasa por su automatización, la etiqueta de par clave/valor se envía a OneSignal. Cualquier etiqueta que envíe a OneSignal desde esta acción se creará en OneSignal si aún no existe para los contactos y se actualizará si existe.
Para encontrar la etiqueta de par clave/valor, inicie sesión en su cuenta OneSignal, luego navegue a Audiencia > Usuarios.
Instrucciones paso a paso
-
Cree un segmento en OneSignal:
- Iniciar sesión en tu cuenta de OneSignal
- Vaya a Audiencia > Segmento > Nuevo segmento
- Cree su nuevo segmento añadiendo el filtro "Etiquetas de usuario" para el par clave/valor creado en el paso 3 anterior. Para saber más, lea la guía de OneSignal sobre segmentación
- Cree el mensaje que desea enviar a su segmento. Para saber más, lea la guía de OneSignal sobre mensajería in-app.
- Recopile la clave API de OneSignal a nivel de app y guárdela en un archivo para el paso 5 (a continuación). Esta clave API se encuentra en ActiveCampaign App > Claves e IDs.
- Desde ActiveCampaign, crea o edita una automatización.
-
Arrastra la acción "OneSignal - Enviar un correo electrónico" a tu automatización. Se encuentra en la parte "Apps" del menú de acciones de automatización. Introduzca la siguiente información en los campos previstos para ello:
- Clave API de OneSignal
- Clave de la etiqueta de datos
- Valor de la etiqueta de datos
- Para conocer las mejores prácticas sobre la creación del par clave/valor, lea el artículo de ayuda de OneSignal Add user data tags
- Termina de crear tu automatización, luego configúrala en "Activo"
Conecte OneSignal a ActiveCampaign con la acción de automatización "OneSignal - Asignar una categoría".
Esta acción de automatización le permite enviar notificaciones push a dispositivos web y móviles.
Qué esperar
Una vez que añadas la acción "OneSignal - Enviar notificación push" a tu automatización, seguirás los pasos de autenticación y configuración de OneSignal. Puede utilizar una plantilla de OneSignal para su notificación push o crear manualmente su mensaje en la configuración.
Después de conectar la integración y configurar la automatización en "Activo", los contactos de que entren en su automatización y lleguen a su acción de OneSignal recibirán una notificación push. Además, el flujo de actividad de los registros de contacto mostrará que entraron en su automatización.
Puede encontrar informes para esta integración en su cuenta OneSignal. También puede utilizar ActiveCampaign para crear una búsqueda avanzada de todos los contactos que entraron y completaron su automatización OneSignal.
Esta integración no agrega etiquetas a una lista. Si desea añadir etiquetas a los contactos a los que se envió una notificación push, debe añadir la acción "Añadir una etiqueta" a su automatización, a continuación de la acción OneSignal.
Instrucciones paso a paso
- Asegúrese de tener la siguiente configuración en el lado de OneSignal: Cuenta OneSignal configurada para enviar notificaciones push, ActiveCampaign App, y Plantillas (recomendado).
- Recopile la siguiente información de OneSignal y guárdela en un archivo para el paso 5 (a continuación):
- Clave de autenticación de usuario - Esta es la clave a nivel de cuenta y se encuentra en Claves de cuenta y API
- OneSignal - Esta es la clave API a nivel de app y se encuentra en ActiveCampaign App > Keys & IDs para la app ActiveCampaign
- Desde ActiveCampaign, crea o edita una automatización.
- Arrastre la acción a la automatización. Se encuentra en la parte "CX Apps" del menú de acciones de automatización.
-
Complete los siguientes pasos en la acción de automatización de OneSignal para conectar la integración:
- Pegue su OneSignal User Auth Key en el campo proporcionado y, a continuación, haga clic en "Conectar"
- Seleccione la aplicación web que desea utilizar en el menú desplegable
- Pegue la clave API de la aplicación web
-
Seleccione la plantilla de notificaciones push que desee utilizar (recomendado). Aquí puede crear manualmente su notificación push si no desea utilizar una plantilla.
- Para crear manualmente una notificación push en la acción de automatización: introduzca su URL, encabezamiento (línea de asunto) y contenido
- También puede utilizar etiquetas de personalización para lo siguiente en su mensaje: Contacto, Cuenta, Oportunidad de venta, Ecommerce y Objetos personalizados
- Las etiquetas de personalización de ActiveCampaign no funcionan con las plantillas de OneSignal
- Haz clic en el botón "Finalizar".
Captura de dirección de correo electrónico para OneSignal con formularios de ActiveCampaign
Esta opción es para usuarios avanzados. Tienes que estar a gusto con el uso de HTML. Nuestro equipo de experiencia del cliente ampaign no puede ayudarlo a implementar o solucionar problemas de código.
Con el SDK Web de OneSignal, puede añadir código personalizado a sus formularios de ActiveCampaign para capturar la dirección de correo electrónico del contacto al enviarlo y añadirlo como suscriptor en OneSignal.
En primer lugar, instale el SDK Web de OneSignal en su sitio web siguiendo la guía de inicio de la documentación de OneSignal.
Una vez que haya verificado que el Web SDK ha sido instalado, el siguiente paso es añadir el formulario de ActiveCampaign a su sitio.
ActiveCampaign:
- Haz clic en "Sitio web" > "Formularios" en el menú de la izquierda.
- Cree un nuevo formulario y elija la opción "Formulario en línea".
- Después de diseñar el formulario, haz clic en el botón "Integrar" en la esquina superior derecha.
- Busca el código "full embed", selecciónalo y cópialo.
En el HTML de su sitio web (donde se mostrará el formulario de ActiveCampaign):
- Pegue el código de formulario copiado.
- Busque una función en el javascript incluido llamada form_submit. La primera línea de esta función debe ser e.preventDefault() Esto es importante.
- El código OneSignal debe insertarse después de la línea e.preventDefault() en esta función.
-
En una nueva línea debajo de la línea e.preventDefault(), añada el siguiente código:
var userEmail = document.getElementById("email").value;
OneSignalDeferred.push(async function(OneSignal) {
await OneSignal.User.addEmail(userEmail);
await OneSignal.login(userEmail);
});
Cuando se envíe el formulario de ActiveCampaign, la dirección de correo electrónico del remitente se introducirá en el campo ID externo de OneSignal.
Resolución de problemas
Revisa la configuración de tu Plantilla para permitir pushes en varios dispositivos.
- Guía de solución de problemas de Web Push
- Guía de solución de problemas de Mobile Push
- Razones comunes por las que las notificaciones Web Push de no se muestran en su dispositivo
- Razones comunes por las que notificaciones push móviles no se muestran en su dispositivo