Configurar App notificaciones automáticas
Para permitirle utilizar notificaciones push en su estrategia multicanal, Actito se integra directamente con nuestra plataforma Notificare, una solución de notificaciones push adquirida recientemente por Actito.
Esta sección lo guiará a través de las instrucciones que debe seguir para configurar el canal de notificaciones push de la Aplicación (para aplicaciones móviles).
Si solo tiene un sitio web, siga la guía de configuración para Web Push.
Si desea implementar el canal push tanto en su sitio web como en su aplicación, siga ambas guías. La configuración se puede realizar en paralelo o uno tras otro.
Los usuarios de teléfonos inteligentes pueden navegar por la versión móvil de su sitio web. Siempre que se haga a través de un navegador web y no de una aplicación, cuenta como canal Web.
Hay 3 pasos:
-
Paso #1: Configuración de la plataforma
-
Paso #2: Configurar tu aplicación nativa y tu sitio web
-
Paso #3: Configurar la ventana emergente para obtener suscripciones
Paso #1: Configurar la plataforma
Dependiendo de la plataforma utilizada para enviar la notificación push (aplicación Android/iOS/Huawei), Actito debe configurar el canal para enviar correctamente la notificación push a través de Notificare.
Para comenzar, siga el documento de configuración para la plataforma correspondiente (ver a continuación) para crear una cuenta de servicio Firebase (Android), una clave de autenticación APNS (iOS) y/o un proyecto HMS (Huawei). Se deberán proporcionar las claves o identificadores correspondientes a los equipos de Actito.
Si es posible, le recomendamos que mantenga las mismas credenciales y conserve la cuenta de Firebase, la clave APNS y/o el proyecto HMS existente.
Entréguelos a los equipos de Actito (a través del Transfer Box de su licencia) y siga la guía de migración.
| Plataforma | Qué necesita Actito para su configuración | Recursos que le ayudarán a proporcionar información a Actito | Qué le proporciona Actito |
|---|---|---|---|
| Androide | Clave de cuenta de servicio (archivo json) | Documento de configuración de Android | Archivos de configuración del SDK para Android |
| iOS | Clave de autenticación APNS: - Archivo .p8 - ID de clave - ID de paquete - ID de equipo | Documento de configuración de iOS | Archivos de configuración del SDK para iOS |
| Huawei | ID de la aplicación Clave secreta de la aplicación | Documento de configuración de HMS | - Archivos de configuración del SDK para Android - Dirección de devolución de llamada - Certificado HTTPS (formato pem) - Usuario de devolución de llamada - Clave de devolución de llamada |
Para compartir elementos confidenciales como archivos SDK o claves para plataformas Android/Huawei/iOS, utilizamos Transfer Box de Actito.
Los archivos de configuración del SDK de la aplicación se colocarán en el Transfer box de su licencia.
Actito te notificará cuando la(s) plataforma(s) se hayan configurado correctamente, para que puedas continuar con el paso 2.
Paso #2: Configura tu aplicación nativa
La configuración técnica se puede resumir en 2 pasos principales:
1. Obtenga el SDK
Conéctate a tu licencia Actito y accede a la aplicación Transfer box. Podrás recuperar el kit de desarrollo de software (SDK) correcto, publicado en línea por el equipo de Actito según el tipo de plataforma. Luego siga las guías de implementación (enlaces a continuación).
2. Implementar el SDK
Como el proceso es muy diferente entre Web, Android e IOS, y entre frameworks específicos, consulte directamente la documentación de Notificare según las plataformas correspondientes a sus aplicaciones.
Puede seguir las secciones Implementation, Device registration y Remote Notifications de la guía de configuración (utilizando los ejemplos de la guía de solución de problemas si es necesario).
Los archivos de configuración a los que se hace referencia en la sección "Implementación" son el archivo SDK que recuperó de Transferbox.
Si está utilizando un marco dedicado para desarrollar su aplicación (como Cordova, Ionic, Flutter o React), siga la guía adecuada.
Guías de implementación
Plataforma nativa
| Plataforma | Implementación | Solución de problemas | Recursos |
|---|---|---|---|
| Android | Implementación de Android | Solución de problemas de Android | - Muestras - Tamaños de dependencia |
| iOS | Implementación de iOS | Solución de problemas de iOS | - Muestras - Tamaños de dependencia |
Framework
| Plataforma | Implementación | Solución de problemas | Recursos |
|---|---|---|---|
| Cordova | Implementación de Cordova | Solución de problemas de Cordova | Muestras de Cordova |
| Ionic nativo | implementación Ionic | Solución de problemas de Ionic | muestras Ionic |
| Flutter | Implementación de Flutter | Solución de problemas de Flutter | Muestras de Flutter |
| React nativo | Implementación de React | Solución de problemas de React | React Samples |
Funciones básicas
Como no todos los sitios web utilizarán todas las funciones que ofrece el canal push, el SDK es flexible y usted puede elegir qué módulos se implementan (consulte las funciones compatibles a continuación).
Se deben implementar las funciones mínimas:
- registrar dispositivos
- Registrar un usuario
- Solicitar autorización
- Recibir notificaciones
Las siguientes funciones son compatibles con el módulo de notificaciones push de Actito:
Registro del dispositivo
- Regístrate como usuario
- Cambiar idioma del dispositivo
Notificaciones remotas
- Solicitar autorización
- Permitir notificaciones
- Desactivar notificaciones de forma remota
- Recibir notificaciones
La sección Server key (legacy) y la funcionalidad de Google Maps no son compatibles.
3. Asignar un ID de cliente final a un dispositivo suscrito
Al registrar una identificación de cliente final en el dispositivo suscrito, Actito podrá vincular el dispositivo a un perfil existente en Actito y crear una vista centralizada alrededor del perfil.
El identificador del cliente final lo definirá su sistema (por ejemplo: su CRM).
La asignación del identificador del cliente final a un dispositivo se llevará a cabo cuando un perfil opte por las notificaciones automáticas y sea conocido por su sistema (por ejemplo, conectado a su sitio/aplicación) y que tienes configurada correctamente la función "Register as a user".
Debe estar disponible el mismo identificador de cliente final en la tabla de perfiles de Actito, para poder conectar los perfiles en los 3 sistemas.
Por lo tanto, para elegir el identificador de cliente final correcto:
- Los datos deben estar disponibles como clave en Actito a través de la sincronización de datos entre su sistema y Actito. *Los datos deben estar disponibles en su sitio web o aplicación móvil.
Utiliza un atributo ya definido como único en tu tabla de perfil de Actito.
Si necesita agregar un nuevo atributo único, esto es posible, pero tenga cuidado ya que esto podría afectar su proceso de sincronización de datos entre su sistema y Actito. Pídale a su experto en datos la integración si es necesario.
Paso #3: Configurar la ventana emergente para obtener suscripciones
Para aplicaciones nativas, la ventana emergente debe manejarse mediante la función de alternancia de notificaciones (se requiere implementación técnica en la aplicación)
Asegúrese de implementar "Requesting permission" (Android) o "Authorization options" (iOS) guías de implementación.
Alcance del canal
Las campañas de Actito solo pueden apuntar a los perfiles que actualicen su aplicación nativa con la versión que contiene el SDK proporcionado durante la configuración.