{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Disponible desde la versión 7.0.0","type":"text"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"none"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"024d2352-027d-44c5-a55d-986222c22805"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"05928c9a-7419-4360-917c-a86dcf80b1a4"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Introducción","type":"text"}]},{"type":"paragraph","content":[{"text":"Se ha implementado en Onesait Platform un módulo para la ","type":"text"},{"text":"gestión de comunicaciones","type":"text","marks":[{"type":"strong"}]},{"text":" que va a permitir la definición de comunicaciones para posteriormente enviar notificaciones de diversos tipos vinculadas a las mismas.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":908,"alt":"thumbnail_Gráfico_pegado-1-20250307-112846.png","id":"faddbd46-eafb-407d-a5f2-86a69da25ac1","collection":"contentId-5009997853","type":"file","height":462}}]},{"type":"paragraph","content":[{"text":"Este módulo permite definir ","type":"text"},{"text":"tipologías de comunicaciones","type":"text","marks":[{"type":"strong"}]},{"text":", así como el envío de diferentes tipos de notificaciones y suscripción a las mismas: notificaciones entre servicios, correos electrónicos, ","type":"text"},{"text":"chats","type":"text","marks":[{"type":"em"}]},{"text":" y ","type":"text"},{"text":"PUSH","type":"text","marks":[{"type":"em"}]},{"text":". Las notificaciones pueden ser programadas para ser enviadas en un momento concreto o incluso repetidas en el tiempo, mediante expresiones cron.","type":"text"}]},{"type":"paragraph","content":[{"text":"El módulo está construido sobre ","type":"text"},{"text":"Spring Boot","type":"text","marks":[{"type":"strong"}]},{"text":" haciendo uso de ","type":"text"},{"text":"Quartz Scheduler","type":"text","marks":[{"type":"strong"}]},{"text":" para la programación de envío de notificaciones, y de ","type":"text"},{"text":"Azure Notification Hub","type":"text","marks":[{"type":"strong"}]},{"text":" para el envío de notificaciones ","type":"text"},{"text":"PUSH","type":"text","marks":[{"type":"em"}]},{"text":" a dispositivos móviles.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Tipos de notificaciones","type":"text"}]},{"type":"paragraph","content":[{"text":"Entre los distintos tipos de notificaciones disponibles, se encuentran:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notificaciones ","type":"text","marks":[{"type":"strong"}]},{"text":"back end","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" entre servicios","type":"text","marks":[{"type":"strong"}]},{"text":": el objetivo de este tipo de notificaciones es enviar mensajes entre diferentes módulos o servicios del sistema. Dichos servicios serán encargados de suscribirse a unos «tópicos» y recibirán las notificaciones vinculadas a dichos tópicos. A continuación, se representa un esquema de este tipo de notificaciones.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":792,"alt":"image-20250307-114733.png","id":"50fd8133-6b87-4b49-b6c2-d7143017ed54","collection":"contentId-5009997853","type":"file","height":571}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notificaciones de tipo ","type":"text","marks":[{"type":"strong"}]},{"text":"device","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": estas notificaciones funcionan igual que las de tipo Backend pero están destinadas a que, una vez recibida la notificación, se desencadene una segunda notificación nativa a dispositivos iOS y Android. A continuación, se representa un esquema de este tipo de notificaciones:","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":951,"alt":"image-20250307-115048.png","id":"0b872a64-34f6-48b5-95e0-1e001f02cfb4","collection":"contentId-5009997853","type":"file","height":676}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notificaciones de tipo correo electrónico","type":"text","marks":[{"type":"strong"}]},{"text":": estas notificaciones hacen uso de un servidor de correo SMTP para enviar correos a destinatarios.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notificaciones de tipo ","type":"text","marks":[{"type":"strong"}]},{"text":"chat","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": este tipo de notificaciones está pensando para el caso de uso de ","type":"text"},{"text":"chat","type":"text","marks":[{"type":"em"}]},{"text":" entre dos partes, con un origen y un destino. A continuación, se representa un esquema de este tipo de notificaciones:","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1242,"alt":"image-20250307-115101.png","id":"98fa9944-f3eb-4035-8c54-e17709b6ce53","collection":"contentId-5009997853","type":"file","height":352}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notificaciones nativas a dispositivos (","type":"text","marks":[{"type":"strong"}]},{"text":"PUSH","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":")","type":"text","marks":[{"type":"strong"}]},{"text":": notificaciones ","type":"text"},{"text":"PUSH","type":"text","marks":[{"type":"em"}]},{"text":" que serán enviadas a través del Azure Notification Hub a dispositivos nativos iOS y Android.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Tipos de suscripciones","type":"text"}]},{"type":"paragraph","content":[{"text":"Para las suscripciones, se distinguen dos tipos:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Suscripciones de dispositivos iOS y Android","type":"text","marks":[{"type":"strong"}]},{"text":": este tipo de suscripciones se harán registrando el dispositivo e informando de los «","type":"text"},{"text":"tags","type":"text","marks":[{"type":"em"}]},{"text":"» a los que se van a suscribir. Solo aplica a notificaciones de tipo nativas a dispositivos.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Suscripciones al resto de notificaciones","type":"text","marks":[{"type":"strong"}]},{"text":": estas suscripciones aplicarán al resto de tipo de notificaciones, se tendrá que informar del identificador de suscriptor (p.e. Servicio21) y de los «tópicos» a los que se va a suscribir.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Cómo gestionar las comunicaciones","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Registro de un tipo de comunicación","type":"text"}]},{"type":"paragraph","content":[{"text":"Para enviar notificaciones, en primer lugar se deberá definir el tipo de la comunicación. Esto se hará a través de un ","type":"text"},{"text":"endpoint","type":"text","marks":[{"type":"em"}]},{"text":" de la API REST expuesta por el gestor de comunicaciones, el cual que tendrá el siguiente formato:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2594,"alt":"image-20250307-115838.png","id":"7f71d205-8149-4e3c-8243-37dea6f00ecd","collection":"contentId-5009997853","type":"file","height":1086}}]},{"type":"paragraph","content":[{"text":"En una comunicación se define el tipo (nombre) de la comunicación, la tipología de notificaciones que van a asociarse a esta comunicación y los campos que van a llevar estas notificaciones, de tal forma que los suscriptores puedan conocer de antemano los campos a los que pueden suscribirse. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Estos campos, en conjunto con su valor, serán los denominados en las notificaciones como «tópicos» en este sistema de notificaciones.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Envío de notificaciones","type":"text"}]},{"type":"paragraph","content":[{"text":"Una vez definida la comunicación que se va a utilizar para enviar cierto tipo de comunicaciones, se podrá enviar dichas notificaciones.","type":"text"}]},{"type":"paragraph","content":[{"text":"Para enviar notificaciones de tipo ","type":"text"},{"text":"BACKEND","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"DEVICE","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"MAIL","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"CHAT","type":"text","marks":[{"type":"code"}]},{"text":", se utilizará un mismo ","type":"text"},{"text":"endpoint","type":"text","marks":[{"type":"em"}]},{"text":",","type":"text"},{"type":"hardBreak"},{"text":"mientras que, para enviar notificaciones nativas a dispositivos, se utilizará un ","type":"text"},{"text":"endpoint","type":"text","marks":[{"type":"em"}]},{"text":" y ","type":"text"},{"text":"payload","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"diferentes.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Notificaciones generales","type":"text"}]},{"type":"paragraph","content":[{"text":"Estas notificaciones, que podrán ser de tipo: ","type":"text"},{"text":"BACKEND","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"DEVICE","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"MAIL","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"CHAT","type":"text","marks":[{"type":"code"}]},{"text":", podrán enviarse en formato JSON, o en formato ","type":"text"},{"text":"multipart","type":"text","marks":[{"type":"em"}]},{"text":" si se van a enviar archivos adjuntos como es el caso de tipo ","type":"text"},{"text":"MAIL","type":"text","marks":[{"type":"code"}]},{"text":" o","type":"text"},{"text":"POST","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"A continuación se muestra un par de ejemplos de un tipo ","type":"text"},{"text":"DEVICE","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2564,"alt":"image-20250307-120503.png","id":"d65271bb-f2fd-41f5-b654-cd4b28cf66ad","collection":"contentId-5009997853","type":"file","height":1314}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2590,"alt":"image-20250307-120512.png","id":"1f16b1da-4766-41bb-b528-1dfd02cee8c9","collection":"contentId-5009997853","type":"file","height":1142}}]},{"type":"paragraph","content":[{"text":"Respecto al objeto JSON, éste cuenta con los siguientes campos generales:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Title","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": título de la notificación.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Message","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": cuerpo de la notificación.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": ","type":"text"},{"text":"BACKEND","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"DEVICE","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"MAIL","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"CHAT","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Origin","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": Identificador único del servicio que envía la notificación.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Communication Type","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": nombre de la comunicación previamente dada de alta.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cron expression","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": expresión CRON en caso de que se quiera programar el envío de la","type":"text"},{"type":"hardBreak"},{"text":"notificación.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Categories","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": categorías asociadas a la notificación.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Para los tipos de ","type":"text"},{"text":"BACKEND","type":"text","marks":[{"type":"code"}]},{"text":" y ","type":"text"},{"text":"DEVICE","type":"text","marks":[{"type":"code"}]},{"text":" se cuenta con el siguiente campo específico:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Target subscription fields","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": mapa de clave-valor que contiene los campos y valores a los que va","type":"text"},{"type":"hardBreak"},{"text":"destinada esta notificación. En los valores se admiten expresiones regulares para poder","type":"text"},{"type":"hardBreak"},{"text":"alcanzar a varios «tópicos» en envíos masivos u otros casos de uso.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":500,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":652,"alt":"image-20250307-121212.png","id":"dd9d3f89-4030-4504-bebe-ba8f6a5f4a12","collection":"contentId-5009997853","type":"file","height":409}}]},{"type":"paragraph","content":[{"text":"En caso del tipo ","type":"text"},{"text":"MAIL","type":"text","marks":[{"type":"code"}]},{"text":", contaría con los siguientes campos específicos:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": a quien va dirigido el correo, admite lista separada por «;».","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cc","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": con copia, admite lista separada por «;».","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Html","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": booleano para indicar si el message tiene contenido HTML.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Adjuntos","type":"text","marks":[{"type":"strong"}]},{"text":": archivos adjuntos en el correo, obliga a usar formato ","type":"text"},{"text":"multipart","type":"text","marks":[{"type":"em"}]},{"text":" en la petición.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":480,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":595,"alt":"image-20250307-121254.png","id":"5c0f03e5-39e8-4549-bc95-45d126aae947","collection":"contentId-5009997853","type":"file","height":415}}]},{"type":"paragraph","content":[{"text":"Para el tipo ","type":"text"},{"text":"CHAT","type":"text","marks":[{"type":"code"}]},{"text":", cuenta con dos campos específicos:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Chat ID","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": solo será necesario si es para continuar una conversación. Si se abre una nueva conversación, se autogenera.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Destination","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": a que servicio o destino va dirigido.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":440,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":554,"alt":"image-20250307-121532.png","id":"0e1efcf7-7599-4ae6-bf59-93d3431e1605","collection":"contentId-5009997853","type":"file","height":336}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Notificaciones ","type":"text"},{"text":"PUSH","type":"text","marks":[{"type":"em"}]},{"text":" a dispositivos","type":"text"}]},{"type":"paragraph","content":[{"text":"Para este tipo de notificaciones se utilizará otro ","type":"text"},{"text":"endpoint","type":"text","marks":[{"type":"em"}]},{"text":", y las peticiones se harán siempre en formato","type":"text"},{"type":"hardBreak"},{"text":"JSON (no ","type":"text"},{"text":"multipart","type":"text","marks":[{"type":"em"}]},{"text":").","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2658,"alt":"image-20250307-121634.png","id":"c2405a52-acc8-4b20-8e72-20444978efb5","collection":"contentId-5009997853","type":"file","height":1102}}]},{"type":"paragraph","content":[{"text":"En este caso, los campos del JSON serán los siguientes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Message","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": cuerpo de la notificación.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Title","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": título de la notificación.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Extra template props","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": mapa clave-valor para añadir propiedades extra si se ha registrado una","type":"text"},{"type":"hardBreak"},{"text":"plantilla en el dispositivo que no es la de por defecto.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tag expression","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": expresión lógica de tags para dirigir la notificación, como por ejemplo: ","type":"text"},{"text":"barcelona && deportes","type":"text","marks":[{"type":"code"}]},{"text":". Tiene prioridad sobre el atributo ","type":"text"},{"text":"tags","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tags","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": etiquetas a las que va dirigida la notificación, como por ejemplo: ","type":"text"},{"text":"[\"minsait”,”madrid”]","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Categories","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": categorías asociadas a esta notificación.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Suscribirse para recibir notificaciones","type":"text"}]},{"type":"paragraph","content":[{"text":"Puesto que hay dos formas de notificaciones, también se cuenta con dos formas de suscripción.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Suscripciones a notificaciones generales","type":"text"}]},{"type":"paragraph","content":[{"text":"En las suscripciones para notificaciones de tipo ","type":"text"},{"text":"BACKEND","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"DEVICE","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"MAIL","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"CHAT","type":"text","marks":[{"type":"code"}]},{"text":" se hará uso del ","type":"text"},{"text":"endpoint","type":"text","marks":[{"type":"em"}]},{"text":" que aceptará el siguiente formato:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2654,"alt":"image-20250307-122509.png","id":"d6062c65-25e7-49e9-aac7-fc52fd556b1a","collection":"contentId-5009997853","type":"file","height":876}}]},{"type":"paragraph","content":[{"text":"El cuerpo de la llamada será un JSON con los siguientes campos:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification endpoint","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": endpoint de callback REST para recibir las notificaciones.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Subscriber ID","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": identificador único del servicio que se suscribe.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Subscription fields","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": mapa de clave-valor indicando el nombre del campo y el valor. El valor","type":"text"},{"type":"hardBreak"},{"text":"podrá ser un ","type":"text"},{"text":"wildcard","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"*","type":"text","marks":[{"type":"code"}]},{"text":" para suscribirse a cualquier valor o incluso una expresión regular,","type":"text"},{"type":"hardBreak"},{"text":"como por ejemplo: ","type":"text"},{"text":"“chatId”: “1|2|3”","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"El suscriptor es responsable de suscribirse a los todos los campos de interés, aunque sea con un ","type":"text"},{"text":"wildcard","type":"text","marks":[{"type":"em"}]},{"text":" como valor, ya que si por ejemplo entra una notificación con los campos «empresa» y","type":"text"},{"type":"hardBreak"},{"text":"«grupo_empresa» y el suscriptor quiere recibir esa notificación, pero solo ha indicado en la suscripción el campo ","type":"text"},{"text":"empresa: “*”","type":"text","marks":[{"type":"code"}]},{"text":", no recibirá la notificación.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"A continuación mostramos algunos ejemplos de los archivos JSON:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1076,"alt":"image-20250310-085222.png","id":"31ce287e-c814-442e-a7f7-e1ab61d2a524","collection":"contentId-5009997853","type":"file","height":323}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1078,"alt":"image-20250310-085058.png","id":"76c32cee-0db9-40d7-934c-835b62147a49","collection":"contentId-5009997853","type":"file","height":292}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1086,"alt":"image-20250310-085355.png","id":"f2f119f3-9dbc-46e6-8dde-2f254c727f2a","collection":"contentId-5009997853","type":"file","height":326}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Suscripciones a notificaciones ","type":"text"},{"text":"PUSH","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"El registro se hará desde las aplicaciones nativas iOS y Android desde los dispositivos. Se utilizará el","type":"text"},{"type":"hardBreak"},{"text":"mismo ","type":"text"},{"text":"endpoint","type":"text","marks":[{"type":"em"}]},{"text":" tanto para el registro por primera vez, como para la actualización de los tags a los que","type":"text"},{"type":"hardBreak"},{"text":"está suscrito.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2682,"alt":"image-20250307-131751.png","id":"89b985d4-5b35-4178-b635-a9a1bac65860","collection":"contentId-5009997853","type":"file","height":828}}]},{"type":"paragraph","content":[{"text":"En este caso, los campos del JSON serán los siguientes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Registration ID","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": ID de registro en caso de que sea una actualización del registro, por esta razón","type":"text"},{"type":"hardBreak"},{"text":"la aplicación móvil deberá almacenar el ID de registro de alguna forma y así evitar el registro","type":"text"},{"type":"hardBreak"},{"text":"continuo del mismo dispositivo.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Device Token ID","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": token extraído programáticamente del dispositivo. Las APIs de iOS y Android","type":"text"},{"type":"hardBreak"},{"text":"permiten obtenerlo. Si se necesitase ayuda para recuperarlo, contactar con algún responsable","type":"text"},{"type":"hardBreak"},{"text":"del C1.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Template","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": por defecto se utilizan plantillas básicas para Azure Notificación Hub. Si se quisiera","type":"text"},{"type":"hardBreak"},{"text":"personalizar una plantilla, se indicaría aquí. El formato de las plantillas se puede encontrar en la","type":"text"},{"type":"hardBreak"},{"text":"documentación de Azure Notification Hub y las plantillas por defecto que se utilizan son las","type":"text"},{"type":"hardBreak"},{"text":"siguientes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Platform","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": ","type":"text"},{"text":"IOS","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"ANDROID","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tags","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": etiquetas a las que se subscribe el dispositivo","type":"text"}]}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":400,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":460,"alt":"image-20250307-132001.png","id":"ddae14e8-c386-4ff3-9aef-bd9c12dc1faf","collection":"contentId-5009997853","type":"file","height":261}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":380,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":437,"alt":"image-20250307-132023.png","id":"3c3f5e3b-25d6-42fe-a687-630b6d0c439f","collection":"contentId-5009997853","type":"file","height":238}}]},{"type":"paragraph","content":[{"text":"Un ejemplo de este tipo de suscripción sería:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":700,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1849,"alt":"image-20250307-132148.png","id":"f41f887e-7fb7-4eb3-b30d-e90e4301e765","collection":"contentId-5009997853","type":"file","height":215}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Operaciones adicionales","type":"text"}]},{"type":"paragraph","content":[{"text":"Además de la operativa de notificaciones y suscripciones, existen otras operaciones como la de confirmación de recepción de una notificación, consulta de histórico de notificaciones, etc.","type":"text"}]},{"type":"paragraph","content":[{"text":"Para más detalles, consultar el descriptor Open API del Gestor de Comunicaciones.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Especificación Open API y librería Java de DTOs","type":"text"}]},{"type":"paragraph","content":[{"text":"El gestor de comunicaciones cuenta con un ","type":"text"},{"text":"descriptor Open API","type":"text","marks":[{"type":"strong"}]},{"text":" para poder consultar los ","type":"text"},{"text":"endpoints","type":"text","marks":[{"type":"em"}]},{"text":" y el modelo de intercambio de datos (DTOs).","type":"text"}]},{"type":"paragraph","content":[{"text":"El descriptor Open API se puede encontrar en la siguiente URL:","type":"text"}]},{"type":"codeBlock","content":[{"text":"https:///communication-manager/swagger-ui/index.html","type":"text"}]},{"type":"paragraph","content":[{"text":"Además, se dispone de ","type":"text"},{"text":"una librería para proyectos Maven/Java","type":"text","marks":[{"type":"strong"}]},{"text":" que contiene los DTOs necesarios para las peticiones y respuestas al gestor de comunicaciones, por lo que si se usa una aplicación Java para la integración se recomienda su uso.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n com.minsait.onesait\n notification-dtos\n 1.0.0\n\n\n \n osp releases\n https://nexus.onesaitplatform.com/nexus/repository/releases/\n \n","type":"text"}]}],"version":1}

Browser not supported