Pasos para configurar Push con Firebase en DANAconnect

**Es importante contar con su app móvil o/y web, integrada con Firebase FCM para recibir Push Notifications.**

Generar la Clave de Cuenta de Servicio (serviceAccount.json)

Ir a Configuración del Proyecto:
Ve a la consola de Firebase y selecciona tu proyecto.
Ir a la pestaña "Cuentas de servicio":
En la barra lateral, selecciona "Cuentas de servicio".

Generar una nueva clave privada:
Haz clic en el botón "Generar una nueva clave privada".
Asegúrate de que el tipo de clave esté configurado como "JSON".
Haz clic en "Generar" y se descargará el archivo serviceAccount.json.

Entregar el archivo a DANAconnect:
Ese archivo debe ser entregado al gerente de cuentas de DANAconnect para que tramite su configuración en la plataforma de DANAconnect.
Solicitar ese archivo serviceAccount.json.
Solicitar un título por defecto (esto es requerido para la configuración inicial). El título de cada notificación puede ser personalizado en el mismo nodo.
Solicitar al menos un token de un dispositivo para hacer pruebas.
Solicitar el nombre de la APP o cómo quieren que aparezca en la selección del nodo PUSH. Recuerden que cada uno de estos pasos se debe repetir por cada aplicación que el cliente desee tener configurada en DANAconnect.

Configuración del Push con FCM:
Una vez se reciba la información arriba mencionada se estará canalizando la configuración.

Eventos Bounce:
400: Significa que falta algún parámetro a configurar tanto en la consola de su FCM o no está mandando un parámetro que solicite FCM.
404: Indica que el token del dispositivo no está registrado en la APP de FCM.
500: Otros errores en el envío.

Opciones en los parámetros de push:
title: Título dinámico, incluso se puede personalizar con las etiquetas.
image: La imagen que sale en la notificación.
linkURL: Este es para el link, pero solo es una funcionalidad para las web notifications, no es un atributo de las notificaciones móviles.
richcontent: Esta etiqueta es especial, ya que las notificaciones no aceptan HTML, pero se le va a mandar en un putdata para que el desarrollador de la aplicación pueda tomar ese HTML y usarlo a su forma.
Atributos personalizados: Pueden colocar cualquier atributo que requiera la app donde se le mandarán los datos que ellos quieran en el putDATA. Pueden colocar la etiqueta que necesiten y el valor que requieran; este valor puede venir de la lista de contactos. Así tienen la flexibilidad para que en sus apps hagan lo que quieran.



Ejemplo de uso:
Si el desarrollador de la app móvil requiere un parámetro como el ID del cliente y elige usar la etiqueta IDCLIENT, el valor puede ser extraído de la lista de contactos con la etiqueta $s{idcliente}. Con esto, se hace flexible para que el desarrollador de la app pueda hacer comandos al momento de una notificación push.

Actualizado el: 03/09/2024