Diferencias

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

Enlace a la vista de comparación

Ambos lados, revisión anteriorRevisión previa
Próxima revisión
Revisión previa
integraciones [2023/05/17 16:16] scantorintegraciones [2024/09/02 15:10] (actual) – [Consumo del token de autenticación] scantor
Línea 136: Línea 136:
   * **URL producción:** %%https://api.beaware360.com%%   * **URL producción:** %%https://api.beaware360.com%%
   * **URL preproducción (Instancias de los partners):** %%https://api-prep.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 === === Body ===
Línea 186: Línea 186:
     - Nombre, Apellido y User se toma del valor “user”.     - Nombre, Apellido y User se toma del valor “user”.
     - Contraseña, se toma del valor “pass”.     - 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.     - 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:        - Ejemplo: 
Línea 206: Línea 207:
     - Se muestra pantalla de login solicitando credenciales.     - Se muestra pantalla de login solicitando credenciales.
     - Luego del login exitoso se redirige a la vista invocada en la URL.     - Luego del login exitoso se redirige a la vista invocada en la URL.
 +
 +==== Registro de IDs de interacción asociados al caso de Be Aware 360 ====
 +
 +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 ===== ===== Integración del histórico de conversación con Be Aware Social =====
Línea 232: 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. 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  ==== ==== Flujo de autenticación en Be Aware 360 con Azure Active Directory  ====