Diferencias

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

--- integraciones [2024/02/16 16:08] – [Lógica de negocio] scantor
+++ integraciones [2025/05/22 20:09] (actual) – [URL genérica] scantor
@@ Línea 58: / 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 136: / 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 186: / Línea 186: @@
     - Nombre, Apellido y User se toma del valor “user”.
     - Contraseña, se toma del valor “pass”.
-      - 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.
+      - **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 283: / 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  ====