Diferencias

Muestra las diferencias entre dos versiones de la página.

--- integraciones [2022/12/02 16:26] – [Configuración de la integración entre Be Aware 360 y Azure Active Directory] scantor
+++ integraciones [2025/05/22 20:09] (actual) – [URL genérica] scantor
@@ Línea 1: / Línea 1: @@
-====== Integraciones con sistemas externos ======
+====== Integraciones con otros sistemas ======
-Existen distintos mecanismos de integración entre Be Aware 360 y sistemas externos:
+Existen distintos mecanismos de integración entre Be Aware 360 y otros sistemas:
   * [[integraciones#Integración por URL sistemas externos|Integración por URL sistemas externos]]
-  * [[integraciones#Integración por URL Genesys PureCloud|Integración por URL Genesys PureCloud]]
   * [[integraciones#Integración del histórico de conversación con Be Aware Social]]
   * [[integraciones#Integración SSO con el Directorio Activo de Microsoft Azure]]
@@ Línea 59: / Línea 58: @@
 | auth_token | Corresponde al token de autenticación del usuario en Be Aware 360. Para más información sobre el token de autenticación, clic [[integraciones#Consumo del token de autenticación|aquí]]. | String |
-=== URL anterior ===
+==== URL con variables ====
-La URL anterior para integración con sistemas externos tiene la siguiente estructura:
+Con la última actualización, la URL de integración con sistemas externos permite también enviar valores a **campos personalizados** del caso en Be Aware 360.
-<code>
+  * Cada campo personalizado debe enviarse con el siguiente formato: "caso_CF_<nombreCampoCustom>":"<valor>" y separado por comas.
-{URL_Instancia}/integracionview/{plataforma}/{canal}/{ID_Interaccion}/{"identificador":"179259168","nombre":"","idrrss":null,"email":"","telefono":"","empresa":null,"caso":"201201-000005"}/{auth_token}
+  * Se pueden incluir múltiples campos en un mismo envío.
-</code>
+La estructura de la URL con campos personalizados queda de la siguiente forma:
-**Ejemplo ambiente de preproducción:**
 <code>
-https://ba360reviewdesk.beaware360.com/integracionview/chattigo/chat/150/"identificador":"","nombre":"","idrrss":null,"email":"","telefono":"993405075","empresa":null,"caso":null/ZTMgcHJ1ZWJhY2hhdCAxMjM0IHlCeWdPcktxQTAgMjAyMDAyMDc
+https://{URL_Instancia}/integracionview/PLATAFORMA/CANAL/IDCHAT/{"contacto":"parametro_contacto","empresa":"parametro_empresa","caso":"parametro_caso","caso_CF_nombreCampo1":"valor1","caso_CF_nombreCampo2":"valor2"}/TOKEN
 </code>
-**Ejemplo ambiente de producción:**
+**Ejemplo con campos personalizados en ambiente de producción:**
 <code>
-https://ba360review.deskbeaware.com/integracionview/chattigo/chat/150/"identificador":"","nombre":"","idrrss":null,"email":"","telefono":"993405075","empresa":null,"caso":null/ZTMgcHJ1ZWJhY2hhdCAxMjM0IHlCeWdPcktxQTAgMjAyMDAyMDc
+https://ba360review.deskbeaware.com/integracionview/genesys/chat/1234567645/{"contacto":"998874563","empresa":null,"caso":"210112-000000","caso_CF_dni":"59123456789","caso_CF_ivropcion":"Opcion2"}/ZTMgcHJ1ZWJhY2hhdCAxMjM0IHlCeWdPcktxQTAgMjAyMDAyMDc
 </code>
-A continuación se detallan los campos que pueden viajar en la URL anterior:
+**Nota:**
+  * Si el nombre del campo personalizado no existe, se generará una nota privada en el caso informando que no se pudo asignar el valor.
+  * El nombre del campo debe coincidir exactamente con el nombre configurado en Be Aware 360.
+A continuación, se detallan los campos adicionales que pueden viajar en la URL:
 ^ Campo ^ Descripción ^ Tipo de dato ^
-| plataforma | Corresponde al nombre de la plataforma del sistema externo que está invocando Be Aware 360. | String |
+| caso_CF_nombreCampo | Valor para ser asignado a un campo personalizado del caso en Be Aware 360. Reemplazar "nombreCampo" por el nombre real del campo personalizado. | String |
-| canal | Corresponde al nombre del canal con el que quedará creado el caso en Be Aware 360. Clic [[integraciones#Canales aceptados|aquí]] para conocer los valores disponibles de canales. | String |
-| ID_Interaccion | Corresponde al Id de la interacción de la plataforma del sistema externo y que quedará relacionado en el caso de Be Aware 360. El tamaño máximo del campo son 120 caracteres. | String |
-| identificador | Corresponde al identificador del contacto en Be Aware 360. | String |
-| nombre | Corresponde al nombre y apellido del contacto en Be Aware 360. | String |
-| idrrss | Corresponde al Id de las redes sociales del contacto en Be Aware 360. | String |
-| email | Corresponde al correo electrónico del contacto en Be Aware 360. | String |
-| telefono | Corresponde al número de teléfono del contacto en Be Aware 360. | String |
-| empresa | Corresponde a cualquier parámetro de búsqueda de la cuenta en Be Aware 360, entre los campos: Identificador, Representante, Razón Social, Giro y Dirección. | String |
-| caso | Corresponde al número de caso de Be Aware 360. | String |
-| auth_token | Corresponde al token de autenticación del usuario en Be Aware 360. Para más información sobre el token de autenticación, clic [[integraciones#Consumo del token de autenticación|aquí]]. | String |
 ==== Búsqueda de casos, cuentas y contactos ====
@@ Línea 137: / Línea 136: @@
   * **URL producción:** %%https://api.beaware360.com%%
   * **URL preproducción (Instancias de los partners):** %%https://api-prep.beaware360.com%%
-  * **Resource:** /ba360/apir/v10/login/authexternalsystem
+  * **Resource:** /ba360/apir/v10_5/login/authexternalsystem
 === Body ===
@@ Línea 187: / Línea 186: @@
     - Nombre, Apellido y User se toma del valor “user”.
     - Contraseña, se toma del valor “pass”.
+      - **Nota:** Al crear un usuario a través de esta autenticación, el sistema no le solicitará cambio de contraseña por primer login, si el usuario llega a ingresar a la consola de Be Aware 360.
     - Email se forma desde el valor “user” como {user}@authexternalsystem.com. Luego debe ser modificado por un administrador de usuarios para evitar el envío de correos electrónicos que reboten.
       - Ejemplo:
@@ Línea 208: / Línea 208: @@
     - Luego del login exitoso se redirige a la vista invocada en la URL.
-===== Integración por URL Genesys PureCloud =====
+==== Registro de IDs de interacción asociados al caso de Be Aware 360 ====
-//En construcción//
+Con el objetivo de registrar la relación entre la plataforma gestora de canales de atención y los casos atendidos en Be Aware 360, hemos implementado el registro de todos los ID de Interacción, también conocidos como ID de Chat o ID de Conversación, utilizados al invocar la vista de Sistemas Externos de Be Aware.
+De esta manera, es posible realizar el cruce de datos del caso con la atención brindada a través del canal correspondiente.
+=== Características: ===
+  * La tabla **interaccion_casos_sistemas_externos** registra todas las acciones realizadas en el caso desde la vista de Sistemas Externos de Be Aware.
+  * Se registran las siguientes acciones:
+    * Creación de caso.
+    * Edición de caso.
+    * Marcado de lista de chequeo del caso.
+    * Avance o retroceso en el caso.
+    * Agregado de nota al caso.
+    * Carga o descarga de archivos al caso.
+    * Envío de respuesta por correo.
+  * Los datos se obtienen a través de los informes generados en Be Aware 360.
+=== Tabla Interacción casos sistemas externos ===
+**Nombre de la tabla:** interaccion_casos_sistemas_externos
+**Descripción:** La tabla interaccion_casos_sistemas_externos almacena la relación entre las interacciones generadas en el sistema que gestiona la comunicación con el cliente y los casos creados o modificados en Be Aware 360.
+**Ejemplo práctico:**
+<code mysql>
+SELECT caso.REFNUM AS 'REFNUM', producto.NOMBRE AS 'PRODUCTO', tipo.NOMBRE AS 'MOTIVO', subtipo.NOMBRES AS 'SUBMOTIVO', caso.ORIGEN AS 'CANAL',
+interaccion_casos_sistemas_externos.IDINTERACCION AS 'ID INTERACCIÓN',
+interaccion_casos_sistemas_externos.OPERACION AS 'OPERACIÓN REALIZADA',
+DATE_FORMAT(CONVERT_TZ(interaccion_casos_sistemas_externos.FECHACREACION,'UTC',GETVALUE('TIME_ZONE')), '%Y-%m-%d %H:%i:%s') AS 'FECHA'
+FROM interaccion_casos_sistemas_externos
+JOIN caso ON interaccion_casos_sistemas_externos.IDCASO = caso.ID
+JOIN producto ON caso.IDPRODUCTO = producto.ID
+JOIN tipo ON caso.IDTIPO = tipo.ID
+JOIN subtipo ON caso.IDSUBTIPO = subtipo.ID
+WHERE CONVERT_TZ(interaccion_casos_sistemas_externos.FECHACREACION,'UTC',GETINSTANCETIMEZONE())
+BETWEEN DATE_FORMAT('{{FECHADESDE}}','%Y-%m-%d 00:00:00') AND DATE_FORMAT('{{FECHAHASTA}}','%Y-%m-%d 23:59:59')
+</code>
+^ Campo ^ Tipo ^ Tipo Clave ^Objeto Relacionado ^ Descripción ^
+| ID | INT | Llave Primaria | | Identificador del registro. |
+| IDINTERACCION | VARCHAR |  |  | ID de la interacción generada en el sistema externo. Más conocida como ID de Chat o ID de conversación. |
+| PLATAFORMA | VARCHAR |  |  | Nombre de la plataforma donde se genera la interacción en el sistema externo. |
+| IDCASO | INT |  | caso.ID | ID del caso relacionado en el cual se realizó alguna acción (creación o edición). |
+| iDUSUARIO | INT |  | usuario.ID | ID del usuario que realizó la acción sobre el caso (creación o edición). |
+| OPERACION | VARCHAR |  |  | Descripción de la operación realizada sobre el caso (creación o edición). |
+| FECHACREACION | DATETIME |  |  | Fecha de creación del registro en la tabla. |
 ===== Integración del histórico de conversación con Be Aware Social =====
@@ Línea 236: / Línea 283: @@
 La consola de Be Aware 360 cuenta con la posibilidad de realizar login unificado (SSO) con la plataforma Azure Active Directory para usuarios de Be Aware 360 en Consola.
-Con esta integración se permite gestionar el acceso a la consola de Be Aware 360 a través de la configuración de usuarios en Azure Active Directory, dónde no necesitarán realizar doble login (Azure + Be Aware 360) si no que con el acceso a Microsoft Azure se habilita el acceso a Consola de Be Aware 360.
+Con esta integración se permite gestionar el acceso a la consola de Be Aware 360 a través de la configuración de usuarios en Azure Active Directory, donde no necesitarán realizar doble login (Azure + Be Aware 360) sino que con el acceso a Microsoft Azure se habilita el acceso a Consola de Be Aware 360.
 ==== Flujo de autenticación en Be Aware 360 con Azure Active Directory  ====
@@ Línea 408: / Línea 455: @@
   - Presionar Guardar
-:!: //Nota: Luego de aplicar los permisos, el usuario con el rol modificado debe cerrar sesión y volver a
+:!: //**Nota:** Luego de aplicar los permisos, el usuario con el rol modificado debe cerrar sesión y volver a
 ingresar a la Consola para ver los cambios aplicados.//