Tabla de Contenidos

Uso de la API REST V10.5 de Be Aware 360

Uso de la API REST V10.5 de Be Aware 360

En esta sección podrá encontrar la información de la API REST de Be Aware 360 para consultar y administrar la información almacenada en su instancia de Be Aware 360.

Aquí podrá consultar:

Información para obtener el token de autenticación para el uso de cualquier acción a través de la API.
Descripción de cada uno de los recursos de la API REST.
Una guía a través de ejemplos simples para el uso de los recursos de la API REST.

Adicional, podrá visualizar el Webinar: Atienda sus clientes de principio a fin con Be Aware 360.

El listado de todos los recursos de la API REST son:

Token

Recursos	Descripción	Método	URL Recurso
GetToken	Retorna la información completa del usuario incluido el token que será obligatorio usar en todas los recursos que se consuman a través de la API.	POST	https://api.beaware360.com/ba360/apir/v10_5/login/auth

Contactos

Recursos	Descripción	Método	URL Recurso
Consultar contactos	Retorna la lista de contactos según los parámetros de búsqueda.	GET	https://api.beaware360.com/ba360/apir/v10_5/contacto/get
Consultar contacto por ID	Retorna la información de un contacto en específico, según su Id en Be Aware 360.	GET	https://api.beaware360.com/ba360/apir/v10_5/contacto/getby?id=<id_contacto>
Crear contacto	Crea un contacto en Be Aware 360	POST	https://api.beaware360.com/ba360/apir/v10_5/contacto/add
Actualizar contacto	Actualiza un contacto en Be Aware 360	PUT	https://api.beaware360.com/ba360/apir/v10_5/contacto/upd
Eliminar contacto	Elimina un contacto en Be Aware 360	DELETE	https://api.beaware360.com/ba360/apir/v10_5/contacto/del/?id=<id_contacto>
Validar correo del contacto	Envía el correo de verificación al contacto para que pueda verificar su correo electrónico.	POST	https://api.beaware360.com/ba360/apir/v10_5/contacto/verificar

Cuentas

Recursos	Descripción	Método	URL Recurso
Consultar cuentas	Retorna la lista de cuentas según los parámetros de búsqueda.	GET	https://api.beaware360.com/ba360/apir/v10_5/cuenta/get
Crear cuenta	Crea una cuenta en Be Aware 360	POST	https://api.beaware360.com/ba360/apir/v10_5/cuenta/add
Actualizar cuenta	Actualiza una cuenta en Be Aware 360	PUT	https://api.beaware360.com/ba360/apir/v10_5/cuenta/upd
Eliminar cuenta	Elimina una cuenta en Be Aware 360	DELETE	https://api.beaware360.com/ba360/apir/v10_5/cuenta/del/?id=<id_cuenta>

Casos

Recursos	Descripción	Método	URL Recurso
Consultar casos	Retorna la lista de los casos de acuerdo con el criterio de búsqueda.	GET	https://api.beaware360.com/ba360/apir/v10_5/caso/get/
Consultar caso por ID	Retorna la información de un caso específico, según su Id en Be Aware 360.	GET	https://api.beaware360.com/ba360/apir/v10_5/caso/getby?filtro=history&id=<id_caso>
Crear caso	Hace la creación de un caso en Be Aware 360.	POST	https://api.beaware360.com/ba360/apir/v10_5/caso/add
Actualizar caso	Actualiza la información de un caso específico, de acuerdo con la información enviada.	PUT	https://api.beaware360.com/ba360/apir/v10_5/caso/upd
Eliminar caso	Elimina un caso de Be Aware 360.	DELETE	https://api.beaware360.com/ba360/apir/v10_5/caso/del

Tipificación

Recursos	Descripción	Método	URL Recurso
Consultar productos	Retorna la lista de productos creados en Be Aware 360.	GET	https://api.beaware360.com/ba360/apir/v10_5/producto/get
Consultar motivos	Retorna la lista de motivos creados en Be Aware 360.	GET	https://api.beaware360.com/ba360/apir/v10_5/tipo/get
Consultar submotivos	Retorna la lista de submotivos creados en Be Aware 360.	GET	https://api.beaware360.com/ba360/apir/v10_5/subtipo/get
Consultar tipificación	Retorna la lista de tipificaciones creadas en Be Aware 360.	GET	https://api.beaware360.com/ba360/apir/v10_5/mtmultityping/get
Consultar prioridad	Retorna la lista de prioridades creadas en Be Aware 360.	GET	https://api.beaware360.com/ba360/apir/v10_5/prioridad/get
Crear tipificación	Crea una tipificación en Be Aware 360.	POST	https://api.beaware360.com/ba360/apir/v10_5/mtmultityping/add
Actualizar tipificación	Actualiza una tipificación en Be Aware 360.	PUT	https://api.beaware360.com/ba360/apir/v10_5/mtmultityping/upd
Eliminar tipificación	Elimina una tipificación en Be Aware 360.	DELETE	https://api.beaware360.com/ba360/apir/v10_5/mtmultityping/del?id=<id_tipificacion>

Gestión del caso

Recursos	Descripción	Método	URL Recurso
Consultar notas del caso	Consulta notas de un caso específico.	GET	https://api.beaware360.com/ba360/apir/v10_5/actividad/get?idobjeto=<id_caso>&tipoobjeto=casos
Agregar notas al caso	Agrega notas a un caso específico.	POST	https://api.beaware360.com/ba360/apir/v10_5/actividad/add
Agregar archivos adjuntos al caso	Agrega archivos adjuntos a un caso específico.	POST	https://api.beaware360.com/ba360/uploadfile
Descargar un archivo adjunto	Descarga archivos adjuntos según ID.	GET	https://api.beaware360.com/ba360/downloadfile
Avanzar el paso de un caso	Avanza el caso al siguiente paso.	POST	https://api.beaware360.com/ba360/apir/v10_5/workflow/next
Retroceder el paso de un caso	Retrocede el caso al paso anterior.	POST	https://api.beaware360.com/ba360/apir/v10_5/workflow/back

Actividades programadas

Recursos	Descripción	Método	URL Recurso
Crear una actividad programada	Hace la creación de un caso en Be Aware 360.	POST	https://api.beaware360.com/ba360/apir/v10_5/fsactividad/add

Primeros pasos

Puede realizar muchos tipos de solicitudes HTTP utilizando las API REST de Be Aware 360. Puede realizar solicitudes para consultar, crear, actualizar o eliminar registros.

Por favor tenga en cuenta los pasos descritos a continuación para un correcto uso de la API de Be Aware 360.

Paso 1. Seleccione su Cliente API REST

Debido a que las API REST usan métodos HTTP para enviar y recibir contenido, se pueden probar utilizando cualquier lenguaje de programación o herramienta que admita el envío y la recepción de mensajes HTTP. Puede elegir entre muchos clientes API REST que interactúan con Be Aware 360, como:

Postman. Nota: En nuestros ejemplos, usamos Postman.
SoapUI.
Su propio cliente desarrollado para conectarse con la API REST.

A través de un cliente API REST podrá probar el nombre de usuario, la contraseña y la URL de solicitud para el API REST y usar la información recopilada para construir y enviar varios tipos de solicitudes HTTP, como son de creación, actualización o eliminación de registros.

Paso 2. Obtenga información para conectarse a la API REST

Para realizar una solicitud REST HTTP, debe contar con la siguiente información:

URL Endpoint: Es la misma URL para todas los recursos: https://api.beaware360.com.
Company: Corresponde al nombre de la instancia de Be Aweare 360.
User: Corresponde al usuario de conexión a su instancia de Be Aware 360.
Password: Corresponde a la contraseña del usuario de conexión a su instancia de Be Aware 360.

Nota: Se recomienda utilizar un usuario genérico de integraciones con permisos para acceder a los recursos que está utilizando.

Paso 3. Obtenga el token (GetToken)

Este paso es el más importante de todo el proceso, dado que es obligatorio estar autenticado y tener el Token que entrega Be Aware 360 para poder realizar cualquier otra acción a través de la API, ya sea consulta o envío de información.

Nota: El token tiene una duración que puede ser parametrizable. Para ver la duración que tiene su instancia, ingrese a la consola de Be Aware 360 y navegue al menú Otros > Lista de Parámetros. Luego, vaya a la sección Sitio general y corresponde al campo Tiempo de inactividad (Minutos). El valor por defecto es de 30 minutos.

Método

POST

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/login/auth.

Request:

Parámetros:

Este recurso no recibe parámetros. Se usa el Body con el formato en RAW JSON.

Campos:

Campo API	Campo BA360	Tipo de dato	Requerido
company	Empresa	String	Sí
user	Usuario	String	Sí
password	Contraseña	String	Sí

Ejemplo:

{
	"company":"company",
	"pass":"password",
	"user":"usuario"
}

Response

El sistema retorna la información completa del usuario, incluido el token que será obligatorio en todas las demás acciones que se realicen a través de la API.

El contenido de la respuesta contiene el Token.

Ejemplo:

{
    "token": "Jd0GW22NNAk8fdAc0W3WXJ02N3aeirkWhNtUe9MXfN36Y4aLYpG0W77XN26v6c1Jc5Pu1K9R4QA93R2irbkWsGNJkb9Fe3F88LkH4vaXidX1k5skh6QC4hFLfMeEdwVw",
    "contacto": null,
    "usuario": {
        "language": "es",
        "multisession": 0,
        "cf": {},
        "isopais": null,
        "cantidadcasos": 3,
        "portada": null,
        "avatar": null,
        "idgrupodesc": null,
        "idpermisodesc": null,
        "idpermiso": null,
        "identificador": null,
        "idgrupo": null,
        "acceso": null,
        "idusuario": null,
        "idroldesc": "Agente de atención",
        "idrol": 4,
        "nombre": "Agente",
        "apellido": "Atención",
        "user": "aatencion",
        "pass": "9438081aa3781af0dafa3f088482e534",
        "email": "aatencion@inmotion.cl",
        "idempresa": null,
        "idempresadesc": null,
        "gruposkills": [],
        "fechacreacion": "2020-02-21 21:29:24.0",
        "fechamodificacion": null,
        "timezone": "America/Santiago",
        "notificacionactiva": 1,
        "uuid": null,
        "eid": null,
        "id": 4
    },
    ...
}

Una vez haya obtenido el token, podrá consumir los recursos de la API REST de Be Aware 360.

Recursos para Contactos

Consultar contactos

Método

GET

URL Recurso

Existen distintas formas de consultar contactos a través de la API. A continuación, se detallan:

Consultar todos los contactos: https://api.beaware360.com/ba360/apir/v10_5/contacto/get.
Consultar contacto por parámetros: https://api.beaware360.com/ba360/apir/v10_5/contacto/get/?parametro=valor.
Consultar contactos con paginación: https://api.beaware360.com/ba360/apir/v10_5/contacto/get/?pagina=<pagina>&cantidad=<cantidad_contactos_a_mostrar_por_pagina>.
Consultar contacto por filtro: https://api.beaware360.com/ba360/apir/v10_5/contacto/get?filtrobuscar=<filtro>&pagina=<pagina>&cantidad=<cantidad_contactos_a_mostrar_por_pagina>.

Request:

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Existen distintas formas de consultar contactos a través de la API. A continuación, se detallan:

Consultar todos los contactos

Parámetros:

Este recurso no recibe parámetros.

Campos:

No requiere enviar campos para el listado completo de contactos.

Consultar contacto por parámetros

Parámetros:

identificador -> Recibe el identificador del contacto.
email -> Recibe el correo electrónico del contacto.

Campos:

No requiere enviar campos.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/contacto/get/?identificador=32456567
https://api.beaware360.com/ba360/apir/v10_5/contacto/get/?email=oskcar@gmail.invalid

—-

Consultar contactos con paginación

Parámetros:

pagina -> Indica el número de página a retornar.
cantidad -> Indica el número de contactos a retornar por página.

Campos:

No requiere enviar campos.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/contacto/get?pagina=1&cantidad=2

Consultar contacto por filtro

Parámetros:

filtrobuscar -> Permite buscar por nombre, apellido, email, dirección, título e identificador.
pagina -> Indica el número de página que se desea consultar. Sirve para hacer paginación.
cantidad -> Indica la cantidad de contactos a mostrar por página.

Campos:

No requiere enviar campos.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/contacto/get?filtrobuscar=calle&pagina=1&cantidad=100

Response

Retorna la lista de los contactos según el criterio de búsqueda.

Ejemplo:

{
    "data": [
        {
            "email": [
                "oskcar@gmail.invalid"
            ],
            "fono": [
                "3185676567"
            ],
            "fonocp": null,
            "idtipo": 1,
            "facebook": null,
            "twitter": null,
            "instagram": null,
            "emailcp": null,
            "direccion": "Calle 134 # 11 - 80",
            "idcuenta": null,
            "fechanacimiento": null,
            "titulo": null,
            "cargo": null,
            "idcuentadesc": null,
            "idsla": null,
            "cf": {},
            "identificador": "32456567",
            "nombre": "Oskar",
            "apellido": "Cantor",
            "pass": null,
            "gruposkills": [
                1
            ],
            "fechacreacion": "2020-02-21 19:24:34.0",
            "fechamodificacion": "1",
            "company": null,
            "uuid": null,
            "eid": null,
            "id": 1
        },
        {
            "email": [
                "janeth@hotmail.invalid"
            ],
            "fono": [],
            "fonocp": null,
            "idtipo": null,
            "facebook": null,
            "twitter": null,
            "instagram": null,
            "emailcp": null,
            "direccion": "Calle 123 # 45-67",
            "idcuenta": null,
            "fechanacimiento": "1983-10-20",
            "titulo": null,
            "cargo": null,
            "idcuentadesc": null,
            "idsla": null,
            "cf": {},
            "identificador": "87654321",
            "nombre": "Janeth",
            "apellido": "Cantor",
            "pass": null,
            "gruposkills": [
                1
            ],
            "fechacreacion": "2020-02-25 16:01:48.0",
            "fechamodificacion": "1",
            "company": null,
            "uuid": null,
            "eid": null,
            "id": 2
        },
        ...
    ],
    "code": 200,
    "message": null,
    "pagination": {
        "cantPages": null,
        "size": 0,
        "actualPage": null
    }
}

Consultar contacto por ID

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/contacto/getby?id=<id_contacto>.

Request:

Parámetros:

id -> Recibe el id del contacto en Be Aware 360.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/contacto/getby?id=60

Response

Retorna la información de un contacto en específico, según su Id en Be Aware 360.

Ejemplo:

{
    "data": {
        "email": [
            "e_apardo@inmotion.cl"
        ],
        "fono": [
            "12345678"
        ],
        "fonocp": null,
        "idtipo": 1,
        "idcuenta": 1,
        "direccion": "Ave. Las Perdices, Condominio Alto Casa Grande, Peñalolen ",
        "idsla": 1,
        "company": null,
        "emailcp": null,
        "grupocuentas": [],
        "facebook": null,
        "twitter": null,
        "instagram": null,
        "titulo": null,
        "idcuentadesc": "MPSoftTechnologies",
        "fechanacimiento": "1997-02-22",
        "cargo": "Informático J ",
        "nombre": "Aiman ",
        "apellido": "Jaafarr ",
        "pass": null,
        "gruposkills": [
            1
        ],
        "cf": {
            "RUT Empresa": "as",
            "FOE": "as"
        },
        "identificador": "8-965-87188",
        "fechacreacion": null,
        "fechamodificacion": "1",
        "id": 60,
        "uuid": null,
        "eid": null
    },
    "code": 200,
    "message": null,
    "pagination": null
}

Crear contacto

Método

POST

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/contacto/add.

Request:

Parámetros:

Este recurso no recibe parámetros

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
nombre	Nombre del contacto	String	Sí		“Josefina”
apellido	Apellido del contacto	String	Sí		“Fernández”
identificador	Identificador del contacto	String	Sí	Debe ser único	“25291667-8”
email	Correo electrónico del contacto	String (Lista)	Sí	Acepta hasta 3 correos electrónicos	[“correo1@beaware.com”, “correo2@beaware.com”, “correo3@beaware.com”]
timezone	Zona horaria del contacto	String	Si	Acepta la zona horario en formato Continente/País	“America/Buenos Aires”
facebook	Id de Facebook del contacto	String	No		“1234567890”
twitter	Usuario de Twitter del contacto	String	No		“@josefa”
instagram	Usuario de Instagram del contacto	String	No		“@josefaig”
direccion	Dirección del contacto	String	No		“Calle 123 # 56 - 90”
grupocuentas	Cuenta a la que pertenece el contacto	String (Lista)	No	Corresponde a un arreglo con los Ids de las cuentas a las que pertenece el contacto separados por coma `,`.	[3,5,10]
fechanacimiento	Fecha de nacimiento del contacto	String	No	Formato: aaaa-mm-dd	“1983-11-20”
cargo	Cargo del contacto	String	No		“Jefe de proyectos”
idsla	Acuerdo del contacto	Integer	No	Corresponde al Id del acuerdo creado en Be Aware 360 y que se le asignará al contacto	1
gruposkills	Grupo al que pertenece el contacto	String (Lista)	No	Corresponde a un arreglo con los Ids de los grupos a los que pertenece el contacto separados por coma `,`	[1,2,5]
fono	Teléfono del contacto	String (Lista)	No	Acepta hasta 3 teléfonos. El sistema hace las siguientes validaciones del teléfono: \\» Solo números. » Símbolo `+` al inicio. » Símbolo `(` antes del primer número. » Símbolo `)` luego del tercer número antes del cuarto. » Longitud mínima 8 números (sin considerar símbolos). » Longitud máxima 20 números (considerando símbolos). Ejemplos de números aceptados (límites): » +(549)23232323232323 » 5492323232323232399 » +(549)23232 » 54923232 » +54923232 » (549)23232	[“+5713682466”,“+5626804615”]
cf	Campos personalizados del contacto	Lista (depende del tipo de campo)	No	Lista de campos personalizados con su valor correspondiente, separados por comas y entre corchetes {}. Nota: Los campos de tipo fecha deben ir especificados con la zona horaria, de lo contrario tomará 00:00 UTC-0	{“hobbie_principal”: “Lectura”, “fecha_ingreso_empresa”: “2020-01-06T05:00:00.000Z”}

Ejemplo:

{
	"email": ["carolis@gmail.invalidnuevo"],
	"fono": ["+5713682466","+5626804615"],
	"facebook": "12345678909876543",
	"twitter": "@carolistest",
	"instagram": "@carolisig",
	"direccion": "Calle 145 # 15A - 50",
	"grupocuentas": [2,5],
	"fechanacimiento": "1983-03-16",
	"cargo": "Bibliotecaria",
	"idsla": 1,
	"cf": {"hobbie_principal": "Lectura", "fecha_ingreso_empresa": "2020-01-06T05:00:00.000Z"},
	"identificador": "52822599",
	"nombre": "Carolina",
	"apellido": "OrtizNuevo",
	"gruposkills": [1],
	"timezone": "America/Buenos Aires"
}

Response

El sistema crea el contacto con la información que se ha enviado a través de la API. Si se quiere enviar el correo de verificación al contacto, se debe utilizar la API de Validación de correo del contacto.

Ejemplo:

{
    "data": {
        "email": [
            "carolis@gmail.invalidnuevo"
        ],
        "fono": [
            "+5713682466",
            "+5626804615"
        ],
        "fonocp": null,
        "timezone": "America/Buenos Aires",
        "timezonedesc": null,
        "direccion": "Calle 145 # 15A - 50",
        "nombre": "Carolina",
        "fechacreacion": "2023-09-18 16:09:12.0",
        "idcuentadesc": null,
        "idcuenta": null,
        "apellido": "OrtizNuevo",
        "identificador": "52822599",
        "cf": {
            "hobbie_principal": "Lectura",
            "fecha_ingreso_empresa": "2020-01-06T05:00:00.000Z"
        },
        "company": null,
        "gruposkills": [
            1
        ],
        "idtipo": null,
        "pass": null,
        "facebook": "12345678909876543",
        "instagram": "@carolisig",
        "twitter": "@carolistest",
        "idsla": 1,
        "casocuentapermiso": [],
        "fechanacimiento": "1983-03-16",
        "grupocuentas": [],
        "emailcp": "carolis@gmail.invalidnuevo",
        "cargo": "Bibliotecaria",
        "grupocuentasstring": "2,5",
        "origin": null,
        "lang": null,
        "haspass": null,
        "fechamodificacion": null,
        "titulo": null,
        "contacttimezonesla": null,
        "eid": null,
        "uuid": null,
        "id": 1563
    },
    "code": 200,
    "message": "Contacto creado exitosamente.",
    "pagination": null
}

Actualizar contacto

Nota: Para utilizar este recurso es necesario siempre enviar todos los campos del contacto y sus valores correspondientes y únicamente modificar los valores de los campos que se vayan a actualizar.

Método

PUT

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/contacto/upd.

Request:

Parámetros:

Este recurso no recibe parámetros

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
nombre	Nombre del contacto	String	Sí		“Josefina”
apellido	Apellido del contacto	String	Sí		“Fernández”
identificador	Identificador del contacto	String	Sí	Debe ser único	“25291667-8”
email	Correo electrónico del contacto	String (Lista)	Sí	Acepta hasta 3 correos electrónicos	[“correo1@beaware.com”, “correo2@beaware.com”, “correo3@beaware.com”]
timezone	Nombre timezone del contacto	String	Si		“America/Santiago”
facebook	Id de Facebook del contacto	String	No		“1234567890”
twitter	Usuario de Twitter del contacto	String	No		“@josefa”
instagram	Usuario de Instagram del contacto	String	No		“@josefaig”
direccion	Dirección del contacto	String	No		“Calle 123 # 56 - 90”
grupocuentas	Cuenta a la que pertenece el contacto	String (Lista)	No	Corresponde a un arreglo con los Ids de las cuentas a las que pertenece el contacto separados por coma `,`.	[3,5,10]
fechanacimiento	Fecha de nacimiento del contacto	String	No	Formato: aaaa-mm-dd	“1983-11-20”
cargo	Cargo del contacto	String	No		“Jefe de proyectos”
idsla	Acuerdo del contacto	Integer	No	Corresponde al Id del acuerdo creado en Be Aware 360 y que se le asignará al contacto	1
gruposkills	Grupo al que pertenece el contacto	String (Lista)	No	Corresponde a un arreglo con los Ids de los grupos a los que pertenece el contacto separados por coma `,`	[1,2,5]
fono	Teléfono del contacto	String (Lista)	No	Acepta hasta 3 teléfonos. El sistema hace las siguientes validaciones del teléfono: \\» Solo números. » Símbolo `+` al inicio. » Símbolo `(` antes del primer número. » Símbolo `)` luego del tercer número antes del cuarto. » Longitud mínima 8 números (sin considerar símbolos). » Longitud máxima 20 números (considerando símbolos). Ejemplos de números aceptados (límites): » +(549)23232323232323 » 5492323232323232399 » +(549)23232 » 54923232 » +54923232 » (549)23232	[“+5713682466”,“+5626804615”]
cf	Campos personalizados del contacto	Lista (depende del tipo de campo)	No	Lista de campos personalizados con su valor correspondiente, separados por comas y entre corchetes {}. Nota: Los campos de tipo fecha deben ir especificados con la zona horaria, de lo contrario tomará 00:00 UTC-0	{“hobbie_principal”: “Lectura”, “fecha_ingreso_empresa”: “2020-01-06T05:00:00.000Z”}
id	Id del contacto que se va a actualizar	Integer	Sí		8

Ejemplo:

{
	"email": ["carolis@gmail.invalid"],
	"fono": ["+5713682466","+5626804615"],
	"facebook": "12345678909876543",
	"twitter": "@carolistest",
	"instagram": "@carolisig",
	"direccion": "Calle 145 # 15BIS - 50",
	"grupocuentas": [2],
	"fechanacimiento": "1983-03-16",
	"cargo": "Bibliotecaria",
	"idsla": 1,
	"cf": {"hobbie_principal": "Cine", "fecha_ingreso_empresa": "2020-01-06T05:00:00.000Z"},
	"identificador": "52822500",
	"nombre": "Carolina",
	"apellido": "Ortiz Godoy",
	"gruposkills": [1],
        "timezone": "America/Buenos Aires",
	"id": 8
}

Response

El sistema actualiza el contacto con la información que se ha enviado a través de la API.

Ejemplo:

{
    "data": {
        "email": [
            "carolis@gmail.invalid"
        ],
        "fono": [
            "+5713682466",
            "+5626804615"
        ],
        "fonocp": null,
        "idtipo": null,
        "facebook": "12345678909876543",
        "twitter": "@carolistest",
        "instagram": "@carolisig",
        "emailcp": null,
        "direccion": "Calle 145 # 15BIS - 50",
        "idcuenta": null,
        "fechanacimiento": "1983-03-16",
        "titulo": null,
        "cargo": "Bibliotecaria",
        "idcuentadesc": "Mandomedio S.A.",
        "idsla": 1,
        "grupocuentas": [2],
        "cf": {
            "hobbie_principal": "Cine",
            "fecha_ingreso_empresa": "2020-01-06T05:00:00.000Z"
        },
        "identificador": "52822500",
        "nombre": "Carolina",
        "apellido": "Ortiz Godoy",
        "pass": null,
        "gruposkills": [
            1
        ],
        "fechacreacion": "2020-03-23 15:28:22.0",
        "fechamodificacion": "2020-03-23 16:43:44.0",
        "company": null,
        "uuid": null,
        "eid": null,
        "id": 8
    },
    "code": 200,
    "message": null,
    "pagination": null
}

Eliminar contacto

Método

DELETE

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/contacto/del/?id=<id_contacto>.

Request:

Parámetros:

id -> Id del contacto.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/contacto/del/?id=5

Response

Elimina un contacto en específico de la base de datos de Be Aware 360.

Ejemplo:

{
    "data": null,
    "code": 200,
    "message": "Contacto eliminado con éxito.",
    "pagination": null
}

Validar correo del contacto

Método

POST

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/contacto/verificar.

Request:

Parámetros:

Este recurso no recibe parámetros.

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
email	Correo electrónico del contacto	String	Sí	Se debe usar el correo del contacto que recibirá el correo de verificación.	“correo1@beaware.com”
idcontacto	Id del contacto	Integer	Sí	Corresponde al Id que le otorga Be Aware 360 al contacto.	90
origin	Nombre de la instancia de Be Aware 360	String	Sí		“ba360review.deskbeaware.com”

Ejemplo:

{
    "email":"correo1@beaware.com",
    "idcontacto":90,
    "origin":"ba360review.deskbeaware.com"
}

Response

El sistema envía el correo electrónico de verificación al contacto.

Ejemplo:

{
    "data": {
        "email": [],
        "fono": [],
        "fonocp": null,
        "timezone": "America/Santiago",
        "timezonedesc": null,
        "direccion": null,
        "nombre": "Usuario",
        "fechacreacion": "2020-07-10 12:48:03.0",
        "idcuentadesc": null,
        "idcuenta": null,
        "apellido": "Prueba",
        "identificador": "9898989898",
        "cf": {},
        "company": null,
        "gruposkills": [],
        "idtipo": null,
        "pass": null,
        "facebook": null,
        "instagram": null,
        "twitter": null,
        "idsla": null,
        "casocuentapermiso": [],
        "fechanacimiento": null,
        "grupocuentas": [],
        "emailcp": null,
        "cargo": null,
        "grupocuentasstring": "1",
        "origin": null,
        "lang": "es",
        "haspass": null,
        "fechamodificacion": "2022-04-18 15:45:24.0",
        "titulo": null,
        "contacttimezonesla": null,
        "eid": null,
        "uuid": null,
        "id": 90
    },
    "code": 200,
    "message": null,
    "pagination": null
}

Recursos para Cuentas

Consultar cuentas

Método

GET

URL Recurso

Existen distintas formas de consultar cuentas a través de la API. A continuación, se detallan:

Consultar todas las cuentas: https://api.beaware360.com/ba360/apir/v10_5/cuenta/get.
Consultar cuenta por parámetros: https://api.beaware360.com/ba360/apir/v10_5/cuenta/get/?parametro=valor.
Consultar cuentas con paginación: https://api.beaware360.com/ba360/apir/v10_5/cuenta/get/?pagina=<pagina>&cantidad=<cantidad_cuentas_a_mostrar_por_pagina>.
Consultar cuenta por filtro: https://api.beaware360.com/ba360/apir/v10_5/cuenta/get/?filtrobuscar=<filtro>&pagina=<pagina>&cantidad=<cantidad_cuentas_a_mostrar_por_pagina>.

Request:

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Existen distintas formas de consultar cuentas a través de la API. A continuación, se detallan:

Consultar todas las cuentas

Parámetros:

Este recurso no recibe parámetros.

Campos:

No requiere enviar campos.

Consultar cuenta por parámetros

Parámetros:

identificador -> Recibe el identificador de la cuenta.
idcuenta -> Recibe el id de Be Aware 360 correspondiente a la cuenta.
idcontacto -> Recibe el id de Be Aware 360 correspondiente al contacto asociado a la cuenta. Este parámetro busca entre los contactos que pertenecen a la cuenta.
idrepresentante -> Recibe el id del representante de la cuenta.
idsla -> Recibe el id del acuerdo al que está asociada la cuenta.

Campos:

No requiere enviar campos.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/cuenta/get/?identificador=7682345346-k
https://api.beaware360.com/ba360/apir/v10_5/cuenta/get/?idcuenta=38
https://api.beaware360.com/ba360/apir/v10_5/cuenta/get/?idcontacto=112
https://api.beaware360.com/ba360/apir/v10_5/cuenta/get/?idrepresentante=127
https://api.beaware360.com/ba360/apir/v10_5/cuenta/get/?idsla=1

Consultar cuentas con paginación

Parámetros:

pagina -> Indica el número de página a retornar.
cantidad -> Indica el número de cuentas a retornar por página.

Campos:

No requiere enviar campos.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/cuenta/get/?pagina=1&cantidad=10

Consultar cuenta por filtro

Parámetros:

filtrobuscar -> Permite buscar por Id SLA (Acuerdo), Nombre representante, Id contacto, Identificador y Razón social.
pagina -> Indica el número de página que se desea consultar. Sirve para hacer paginación.
cantidad -> Indica la cantidad de cuentas a mostrar por página.

Campos:

No requiere enviar campos.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/cuenta/get/?filtrobuscar=soft&pagina=1&cantidad=10

Response

Retorna la lista de todas las cuentas.

Ejemplo:

{
    "data": [
        {
            "fechacreacion": null,
            "fechamodificacion": "2020-03-19 18:42:15.0",
            "cf": {
                "TTT": "ppp",
                "campo_ex": "2020-01-16T03:00:00.000Z",
                "NOMBRE": "1221",
                "nombre": "10",
                "BBB": "ll"
            },
            "isopais": null,
            "identificador": "7682345346-k",
            "direccion": "Nueva Lyon 0124",
            "facebook": null,
            "instagram": null,
            "idrepresentante": 127,
            "razonsocial": "MPSoftTechnologies",
            "idsla": 1,
            "grupocontactos": [
                113,
                112,
                116,
                118,
                127,
                60
            ],
            "xpos": "-33.421013",
            "ypos": "-70.610858",
            "idsladesc": "SLA 24 Horas",
            "telefono": null,
            "giro": "MPSoftTechnologies Por giro",
            "paginaweb": null,
            "correo": null,
            "idrepresentantedesc": "Mariano Pivatto",
            "id": 1,
            "uuid": null,
            "eid": null
        },
        {
            "fechacreacion": null,
            "fechamodificacion": "2020-03-19 18:42:15.0",
            "cf": {
                "TTT": "ppp",
                "campo_ex": "2020-01-16T03:00:00.000Z",
                "NOMBRE": "1221",
                "nombre": "10",
                "BBB": "ll"
            },
            "isopais": null,
            "identificador": "7682345346-k",
            "direccion": "Nueva Lyon 0124",
            "facebook": null,
            "instagram": null,
            "idrepresentante": 127,
            "razonsocial": "MPSoftTechnologies",
            "idsla": 1,
            "grupocontactos": [
                113,
                112,
                116,
                118,
                127,
                60
            ],
            "xpos": "-33.421013",
            "ypos": "-70.610858",
            "idsladesc": "SLA 24 Horas",
            "telefono": null,
            "giro": "MPSoftTechnologies Por giro",
            "paginaweb": null,
            "correo": null,
            "idrepresentantedesc": "Mariano Pivatto",
            "id": 1,
            "uuid": null,
            "eid": null
        },
        ...
    ],
    "code": null,
    "message": null,
    "pagination": {
        "cantPages": null,
        "size": 0,
        "actualPage": null
    }
}

Crear cuenta

Método

POST

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/cuenta/add.

Request:

Parámetros:

Este recurso no recibe parámetros

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
razonsocial	Razón social de la cuenta	String	Sí	Este campo tiene una validación que sea menor a 255 caracteres.	“In Motion”
identificador	Identificador de la cuenta	String	Sí	Debe ser único. Este campo tiene una validación que sea menor a 20 caracteres.	“900262501-1”
idsla	Acuerdo de la cuenta	Integer	Sí	Corresponde al Id del acuerdo creado en Be Aware 360 y que se le asignará a la cuenta	1
direccion	Dirección de la cuenta	String	No	Este campo tiene una validación que sea menor a 255 caracteres.	“Carrera 11A # 93- 52”
email	Correo electrónico de la cuenta	String	No	Este campo tiene una validación que sea menor a 45 caracteres.	“contacto@grupoinmotion.com.invalid”
facebook	Id de Facebook de la cuenta	String	No	Este campo tiene una validación que sea menor a 100 caracteres.	“1234567890987654”
instagram	Usuario de Instagram de la cuenta	String	No	Este campo tiene una validación que sea menor a 100 caracteres.	“@imcol”
twitter	Usuario de Twitter de la cuenta	String	No	Este campo tiene una validación que sea menor a 100 caracteres.	“@immex”
giro	Giro o actividad económica de la cuenta	String	No	Este campo tiene una validación que sea menor a 200 caracteres.	“Servicios de tecnología”
paginaweb	Página web de la cuenta	String	No	Este campo tiene una validación que sea menor a 100 caracteres.	“www.grupoinmotion.com”
telefono	Teléfono de la cuenta	String	No	Solo acepta caracteres numéricos. Es importante que el teléfono vaya con el prefijo correspondiente	“5713004627”
idrepresentante	Contacto que corresponde al representante de la cuenta	Integer	No	Id del contacto que corresponde al representante de la cuenta	118
grupocontactos	Grupo de contactos asociados a la cuenta	Integer (Lista)	No	Correspondes a los Ids de contactos que están asociados a la cuenta	[112, 113, 118]
cf	Campos personalizados de la cuenta	Lista (depende del tipo de campo)	No	Lista de campos personalizados con su valor correspondiente, separados por comas y entre corchetes {}. Nota: Los campos de tipo fecha deben ir especificados con la zona horaria, de lo contrario tomará 00:00 UTC-0	{“campo_ex”: “2020-03-02T05:00:00.000Z”, “nombre”: “prueba”}

Ejemplo:

{
	"razonsocial": "In Motion Prueba de México S.A.S.",
	"identificador": "900262503-9",
	"idsla": 1,
	"direccion": "Carrera 11A # 93- 52",
	"facebook": "1234567890987654",
	"instagram": "@imcol",
        "twitter": "@immex",
	"correo": "contacto@grupoinmotion.com.invalidprueba",
	"giro": "Giro",
	"paginaweb": "www.grupoinmotion.com",
	"telefono": "525511929352",
	"idrepresentante": 118,
	"grupocontactos": [112, 113, 118],
	"cf": {"campo_ex": "2020-03-02T05:00:00.000Z", "nombre": "pruebaotra"}
}

Response

El sistema crea la cuenta con la información que se ha enviado a través de la API.

Ejemplo:

{
    "data": {
        "direccion": "Carrera 11A # 93- 52",
        "fechacreacion": "2023-09-20 13:41:10.0",
        "identificador": "900262503-9",
        "razonsocial": "In Motion Prueba de México S.A.S.",
        "telefono": "525511929352",
        "correo": "contacto@grupoinmotion.com.invalidprueba",
        "cf": {
            "campo_ex": "2020-03-02T05:00:00.000Z",
            "nombre": "pruebaotra"
        },
        "grupocontactos": [
            112,
            113,
            118,
            118,
            118
        ],
        "giro": "Giro",
        "idrepresentante": 118,
        "idrepresentantedesc": "Andres Zambrano",
        "facebook": "1234567890987654",
        "instagram": "@imcol",
        "twitter": "@immex",
        "paginaweb": "www.grupoinmotion.com",
        "idsla": 1,
        "casocuentapermiso": {},
        "grupocontactosplus": null,
        "grupocontactosstring": null,
        "grupocontactosout": null,
        "grupocontactosin": null,
        "fechamodificacion": null,
        "isopais": null,
        "xpos": null,
        "ypos": null,
        "permiso": null,
        "idsladesc": "Cliente VIP",
        "eid": null,
        "uuid": null,
        "id": 38
    },
    "code": 200,
    "message": "Cuenta creada con éxito.",
    "pagination": null
}

Actualizar cuenta

Nota: Para utilizar este recurso es necesario siempre enviar todos los campos de la cuenta y sus valores correspondientes y únicamente modificar los valores de los campos que se vayan a actualizar.

Método

PUT

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/cuenta/upd.

Request:

Parámetros:

Este recurso no recibe parámetros

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
razonsocial	Razón social de la cuenta	String	Sí		“In Motion”
identificador	Identificador de la cuenta	String	Sí	Debe ser único	“900262501-1”
idsla	Acuerdo de la cuenta	Integer	Sí	Corresponde al Id del acuerdo creado en Be Aware 360 y que se le asignará a la cuenta	1
direccion	Dirección de la cuenta	String	No		“Carrera 11A # 93- 52”
email	Correo electrónico de la cuenta	String	No		“contacto@grupoinmotion.com.invalid”
facebook	Id de Facebook de la cuenta	String	No		“1234567890987654”
instagram	Usuario de Instagram de la cuenta	String	No		“@imcol”
twitter	Usuario de Twitter de la cuenta	String	No		“@immex”
giro	Giro o actividad económica de la cuenta	String	No		“Servicios de tecnología”
paginaweb	Página web de la cuenta	String	No		“www.grupoinmotion.com”
telefono	Teléfono de la cuenta	String	No	Solo acepta caracteres numéricos. Es importante que el teléfono vaya con el prefijo correspondiente	“5713004627”
idrepresentante	Contacto que corresponde al representante de la cuenta	Integer	No	Id del contacto que corresponde al representante de la cuenta	118
grupocontactos	Grupo de contactos asociados a la cuenta	Integer (Lista)	No	Correspondes a los Ids de contactos que están asociados a la cuenta	[112, 113, 118]
cf	Campos personalizados de la cuenta	Lista (depende del tipo de campo)	No	Lista de campos personalizados con su valor correspondiente, separados por comas y entre corchetes {}. Nota: Los campos de tipo fecha deben ir especificados con la zona horaria, de lo contrario tomará 00:00 UTC-0	{“campo_ex”: “2020-03-02T05:00:00.000Z”, “nombre”: “prueba”}
id	Id de la cuenta que se va a actualizar	Integer	Sí		38

Ejemplo:

{
	"razonsocial": "In Motion de México Pruebas S.A.S.",
	"identificador": "900262503-9",
	"idsla": 1,
	"direccion": "Carrera 11A # 93- 52",
	"facebook": "1234567899876543",
	"instagram": "@imcol",
        "twitter": "@immex",
	"correo": "contacto@grupoinmotion.com.invalidprueba2",
	"giro": "Empresa que presta servicios de tecnología",
	"paginaweb": "www.grupoinmotion.com",
	"telefono": "525511929352",
	"idrepresentante": 118,
	"grupocontactos": [112, 113, 118],
	"cf": {"campo_ex": "2020-03-02T05:00:00.000Z", "nombre": "123"},
	"id": 38
}

Response

El sistema actualiza la cuenta con la información que se ha enviado a través de la API.

Ejemplo:

{
    "data": {
        "direccion": "Carrera 11A # 93- 52",
        "fechacreacion": "2023-09-20 13:41:10.0",
        "identificador": "900262503-9",
        "razonsocial": "In Motion de México Pruebas S.A.S.",
        "telefono": "525511929352",
        "correo": "contacto@grupoinmotion.com.invalidprueba2",
        "cf": {
            "campo_ex": "2020-03-02T05:00:00.000Z",
            "nombre": "123"
        },
        "grupocontactos": [],
        "giro": "Empresa que presta servicios de tecnología",
        "idrepresentante": 118,
        "idrepresentantedesc": "Andres Zambrano",
        "facebook": "1234567899876543",
        "instagram": "@imcol",
        "twitter": "@immex",
        "paginaweb": "www.grupoinmotion.com",
        "idsla": 1,
        "casocuentapermiso": {},
        "grupocontactosplus": null,
        "grupocontactosstring": null,
        "grupocontactosout": null,
        "grupocontactosin": null,
        "fechamodificacion": "2023-09-20 13:50:20.0",
        "isopais": null,
        "xpos": null,
        "ypos": null,
        "permiso": null,
        "idsladesc": "Cliente VIP",
        "eid": null,
        "uuid": null,
        "id": 38
    },
    "code": 200,
    "message": null,
    "pagination": null
}

Eliminar cuenta

Método

DELETE

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/cuenta/del/?id=<id_cuenta>.

Request:

Parámetros:

id -> Id de la cuenta.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/cuenta/del/?id=38

Response

Elimina una cuenta específica de la base de datos de Be Aware 360.

Ejemplo:

{
    "data": {
        "direccion": null,
        "fechacreacion": null,
        "identificador": null,
        "razonsocial": null,
        "telefono": null,
        "correo": null,
        "cf": {},
        "grupocontactos": [],
        "giro": null,
        "idrepresentante": null,
        "idrepresentantedesc": null,
        "facebook": null,
        "instagram": null,
        "twitter": null,
        "paginaweb": null,
        "idsla": null,
        "casocuentapermiso": {},
        "grupocontactosplus": null,
        "grupocontactosstring": null,
        "grupocontactosout": null,
        "grupocontactosin": null,
        "fechamodificacion": null,
        "isopais": null,
        "xpos": null,
        "ypos": null,
        "permiso": null,
        "idsladesc": null,
        "eid": null,
        "uuid": null,
        "id": 38
    },
    "code": 200,
    "message": "Cuenta elimindada con exito.",
    "pagination": null
}

Recursos para Casos

Consultar casos

Método

GET

URL Recurso

Existen distintas formas de consultar casos a través de la API. A continuación, se detallan:

Consultar histórico de casos: https://api.beaware360.com/ba360/apir/v10_5/caso/get/?filtro=history&pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>.
Consultar histórico de casos API ligera: https://api.beaware360.com/ba360/apir/v10_5/caso/historylite/get/?filtro=history&pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>
Consultar casos abiertos: https://api.beaware360.com/ba360/apir/v10_5/caso/get?filtro=getall&pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>.
Consultar casos en espera: https://api.beaware360.com/ba360/apir/v10_5/caso/get?filtro=waiting&pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>.
Consultar caso por filtro: https://api.beaware360.com/ba360/apir/v10_5/caso/get/?filtro=history&pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>&filtrobuscar=<filtro>.
Consultar caso por Id contacto: https://api.beaware360.com/ba360/apir/v10_5/caso/get/?icontacto=<id_contacto_ba360>.
Consultar casos abiertos creados por el usuario: https://api.beaware360.com/ba360/apir/v10_5/caso/get/?pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>&filtro=created.
Consultar caso por búsqueda avanzada: https://api.beaware360.com/ba360/apir/v10_5/caso/getBusquedaAvanzada.

Consultar histórico de casos

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/get/?filtro=history&pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>.

Request:

Parámetros:

filtro -> history.
pagina -> Indica el número de página que se desea consultar. Sirve para hacer paginación.
cantidad -> Indica la cantidad de casos a mostrar por página.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de todos los casos sin tener en cuenta el estado, grupo o usuario asignado al caso.

Ejemplo:

{
    "data": [
        {
            "checkList": null,
            "idusuariocreacion": 66,
            "direccion": null,
            "idcontacto": 1,
            "idestado": 1,
            "fechacreacion": "2023-09-27",
            "idcontactodesc": "Oskar Florez",
            "idcuentadesc": null,
            "origen": "FormWEB",
            "finalizado": 0,
            "refnum": "230927-000007",
            "asunto": "Caso actualizado desde API",
            "idcuenta": null,
            "idusuarioasignado": 7,
            "idtipodesc": "Requerimiento",
            "idsubtipodesc": "Aprovisionamiento de nueva instancia",
            "idestadodesc": "Creado",
            "idprioridaddesc": "Alta",
            "idproductodesc": null,
            "idusuarioasignadodesc": "integracion",
            "idworkflowdesc": null,
            "duedate": null,
            "duedateslan": "2023-09-28 14:40:00.0",
            "duedateslouser": null,
            "duedatesloutc": "2023-09-27 20:54:30.0",
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 2,
            "latitud": null,
            "longitud": null,
            "idworkflow": null,
            "idsla": null,
            "porcentaje": 0,
            "idproducto": 1,
            "idsubtipo": 2,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": null,
            "color": "NEGRO",
            "tmzcontacto": null,
            "colorusuario": "NEGRO",
            "destacado": false,
            "idprioridad": 1,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": null,
            "fechacreacionstr": "2023-09-27 00:00:00",
            "idusuariocreaciondesc": null,
            "cantidadcasos": null,
            "fechamodificacion": null,
            "fechahoracreacionutc": "2023-09-27 20:39:30.0",
            "idusuariomodificaciondesc": null,
            "slavalue": null,
            "fingreso": null,
            "flexible": null,
            "primerpaso": null,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": null,
            "timeactual": null,
            "idprioridadcolor": "#E74A25",
            "idstageactualdesc": null,
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhoralimit": "2023-09-27 18:39:58",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": null,
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5325
        },
        {
            "checkList": null,
            "idusuariocreacion": 66,
            "direccion": null,
            "idcontacto": 1,
            "idestado": 1,
            "fechacreacion": "2023-09-27",
            "idcontactodesc": "Oscar Florez",
            "idcuentadesc": null,
            "origen": "FormWEB",
            "finalizado": 0,
            "refnum": "230927-000006",
            "asunto": "Caso actualizado desde API",
            "idcuenta": null,
            "idusuarioasignado": 7,
            "idtipodesc": "Requerimiento",
            "idsubtipodesc": "Aprovisionamiento de nueva instancia",
            "idestadodesc": "Creado",
            "idprioridaddesc": "Alta",
            "idproductodesc": null,
            "idusuarioasignadodesc": "integracion",
            "idworkflowdesc": null,
            "duedate": null,
            "duedateslan": "2023-09-27 22:46:38.0",
            "duedateslouser": null,
            "duedatesloutc": "2023-09-27 20:01:38.0",
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 2,
            "latitud": null,
            "longitud": null,
            "idworkflow": null,
            "idsla": null,
            "porcentaje": 0,
            "idproducto": 1,
            "idsubtipo": 2,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": null,
            "color": "NEGRO",
            "tmzcontacto": null,
            "colorusuario": "NEGRO",
            "destacado": false,
            "idprioridad": 1,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": null,
            "fechacreacionstr": "2023-09-27 00:00:00",
            "idusuariocreaciondesc": null,
            "cantidadcasos": null,
            "fechamodificacion": null,
            "fechahoracreacionutc": "2023-09-27 19:46:38.0",
            "idusuariomodificaciondesc": null,
            "slavalue": null,
            "fingreso": null,
            "flexible": null,
            "primerpaso": null,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": null,
            "timeactual": null,
            "idprioridadcolor": "#E74A25",
            "idstageactualdesc": null,
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhoralimit": "2023-09-27 18:38:51",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": null,
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5324
        }
    ],
    "code": 200,
    "message": null,
    "pagination": {
        "cantPages": 346,
        "size": 691,
        "actualPage": 1
    }
}

Consultar histórico de casos API ligera

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/historylite/get/?filtro=history&pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>.

Request:

Parámetros:

filtro -> history.
pagina -> Indica el número de página que se desea consultar. Sirve para hacer paginación.
cantidad -> Indica la cantidad de casos a mostrar por página.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de todos los casos sin tener en cuenta el estado, grupo o usuario asignado al caso. Este servicio entrega una respuesta acotada respecto al servicio de histórico normal. Con esto, se espera una respuesta del servicio en un tiempo menor permitiendo consultas de gran cantidad de casos.

La respuesta del servicio entrega los mismos campos que la API del histórico de casos, pero solo retornará valores para los siguientes campos:

Campo	Descripción
id	Identificador único del caso asignado por Be Aware 360.
idestado	Identificador del estado asignado al caso.
idestadodesc	Descripción del estado asignado al caso.
refnum	Número del caso.
idcontacto	Identificador del contacto asignado al caso.
idcontactodesc	Nombre del contacto asignado al caso.
idcuenta	Identificador de la cuenta asignada al caso.
razonsocial	Nombre de la cuenta asignada al caso.
idusuarioasignado	Identificador del usuario asignado al caso.
idusuarioasignadodesc	Nombre del usuario asignado al caso.
idproducto	Identificador del producto asignado al caso.
idproductodesc	Nombre del producto asignado al caso.
idtipo	Identificador del motivo asignado al caso.
idtipodesc	Nombre del motivo asignado al caso.
idsubtipo	Identificador del submotivo asignado al caso.
idsubtipodesc	Nombre del submotivo asignado al caso.
origen	Nombre del canal por el cual se creó el caso.
asunto	Asunto del caso.
fechacreacion	Fecha de creación del caso.
finalizado	Indica si el caso está finalizado. 0 indica que el caso no está finalizado y 1 indica que sí está finalizado el caso.

Ejemplo:

{
    "data": [
        {
           "checkList": null,
            "idusuariocreacion": null,
            "direccion": null,
            "idcontacto": 1562,
            "idestado": 1,
            "fechacreacion": "2023-09-18",
            "idcontactodesc": "Jeymi Correa",
            "idcuentadesc": null,
            "origen": "AskWeb",
            "finalizado": 0,
            "refnum": "230918-000001",
            "asunto": "Pruebas desde ask",
            "idcuenta": null,
            "idusuarioasignado": 21,
            "idtipodesc": "Implementación",
            "idsubtipodesc": "Solicitud de información",
            "idestadodesc": "Creado",
            "idprioridaddesc": null,
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": "pdias",
            "idworkflowdesc": null,
            "duedate": null,
            "duedateslan": null,
            "duedateslouser": null,
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 3,
            "latitud": null,
            "longitud": null,
            "idworkflow": null,
            "idsla": null,
            "porcentaje": null,
            "idproducto": 1,
            "idsubtipo": 3,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": null,
            "color": null,
            "tmzcontacto": null,
            "colorusuario": null,
            "destacado": null,
            "idprioridad": null,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": null,
            "idusuariocreaciondesc": null,
            "fechamodificacion": null,
            "cantidadcasos": null,
            "fechacreacionstr": "2023-09-18 00:00:00",
            "fechahoracreacionutc": null,
            "idusuariomodificaciondesc": null,
            "slavalue": null,
            "fingreso": null,
            "flexible": null,
            "primerpaso": null,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": null,
            "timeactual": null,
            "idprioridadcolor": null,
            "idstageactualdesc": null,
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhoralimit": null,
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": null,
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5303
        },
        {
            "checkList": null,
            "idusuariocreacion": null,
            "direccion": null,
            "idcontacto": 1,
            "idestado": 1,
            "fechacreacion": "2023-09-14",
            "idcontactodesc": "Oskar Cantor Florez",
            "idcuentadesc": null,
            "origen": "AgenteWeb",
            "finalizado": 0,
            "refnum": "230914-000001",
            "asunto": "Prueba SAC ICB",
            "idcuenta": null,
            "idusuarioasignado": 3,
            "idtipodesc": "Consulta",
            "idsubtipodesc": "Funcionalidad de la herramienta",
            "idestadodesc": "Creado",
            "idprioridaddesc": null,
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": "scantor",
            "idworkflowdesc": null,
            "duedate": null,
            "duedateslan": null,
            "duedateslouser": null,
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 7,
            "latitud": null,
            "longitud": null,
            "idworkflow": null,
            "idsla": null,
            "porcentaje": null,
            "idproducto": 1,
            "idsubtipo": 10,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": null,
            "color": null,
            "tmzcontacto": null,
            "colorusuario": null,
            "destacado": null,
            "idprioridad": null,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": null,
            "idusuariocreaciondesc": null,
            "fechamodificacion": null,
            "cantidadcasos": null,
            "fechacreacionstr": "2023-09-14 00:00:00",
            "fechahoracreacionutc": null,
            "idusuariomodificaciondesc": null,
            "slavalue": null,
            "fingreso": null,
            "flexible": null,
            "primerpaso": null,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": null,
            "timeactual": null,
            "idprioridadcolor": null,
            "idstageactualdesc": null,
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhoralimit": null,
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": null,
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5302
        }, 
        ...       
    ],
    "code": 200,
    "message": null,
    "pagination": {
        "cantPages": 68,
        "size": 674,
        "actualPage": 1
    }
}

Consultar casos abiertos

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/get?filtro=getall&pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>.

Request:

Parámetros:

filtro -> getall.
pagina -> Indica el número de página que se desea consultar. Sirve para hacer paginación.
cantidad -> Indica la cantidad de casos a mostrar por página.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de todos los casos activos dentro de un proceso, independientemente del usuario o grupo asignado al caso.

Ejemplo:

{
    "data": [
        {
            "checkList": null,
            "idusuariocreacion": null,
            "direccion": null,
            "idcontacto": 1562,
            "idestado": 1,
            "fechacreacion": "2023-09-18",
            "idcontactodesc": "Jeymi Correa",
            "idcuentadesc": null,
            "origen": "AskWeb",
            "finalizado": 0,
            "refnum": "230918-000001",
            "asunto": "Pruebas desde ask",
            "idcuenta": null,
            "idusuarioasignado": 21,
            "idtipodesc": "Implementación",
            "idsubtipodesc": "Solicitud de información",
            "idestadodesc": "Creado",
            "idprioridaddesc": null,
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": "pdias",
            "idworkflowdesc": "Implementación de proyectos",
            "duedate": "2023-09-18 13:13:28.0",
            "duedateslan": null,
            "duedateslouser": "2023-09-18 16:13:28.0",
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 3,
            "latitud": null,
            "longitud": null,
            "idworkflow": 7,
            "idsla": null,
            "porcentaje": -6826,
            "idproducto": 1,
            "idsubtipo": 3,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": 9,
            "color": "NEGRO",
            "tmzcontacto": "America/Santiago",
            "colorusuario": "NEGRO",
            "destacado": false,
            "idprioridad": null,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": "2023-09-18 12:13:29.0",
            "idusuariocreaciondesc": null,
            "fechamodificacion": "2023-09-18",
            "cantidadcasos": null,
            "fechacreacionstr": "2023-09-18 00:00:00",
            "fechahoracreacionutc": "2023-09-18 15:13:28.0",
            "idusuariomodificaciondesc": null,
            "slavalue": 60,
            "fingreso": "2023-09-18 15:13:28.0",
            "flexible": null,
            "primerpaso": 1,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": "2023-09-18 00:00:00",
            "timeactual": null,
            "idprioridadcolor": null,
            "idstageactualdesc": "Solicitar información al cliente",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhoralimit": "2023-09-18 13:13:29",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": "America/Santiago",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5303
        },
        {
           "checkList": null,
            "idusuariocreacion": 3,
            "direccion": null,
            "idcontacto": 1,
            "idestado": 1,
            "fechacreacion": "2023-09-13",
            "idcontactodesc": "Oskar Cantor Florez",
            "idcuentadesc": null,
            "origen": "AgenteWeb",
            "finalizado": 0,
            "refnum": "230913-000001",
            "asunto": "Prueba",
            "idcuenta": null,
            "idusuarioasignado": 3,
            "idtipodesc": "Implementación",
            "idsubtipodesc": "Solicitud de información",
            "idestadodesc": "Creado",
            "idprioridaddesc": null,
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": "scantor",
            "idworkflowdesc": "Implementación de proyectos",
            "duedate": "2023-09-13 16:30:57.0",
            "duedateslan": null,
            "duedateslouser": "2023-09-13 19:30:57.0",
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 3,
            "latitud": null,
            "longitud": null,
            "idworkflow": 7,
            "idsla": null,
            "porcentaje": -18496,
            "idproducto": 1,
            "idsubtipo": 3,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": 9,
            "color": "NEGRO",
            "tmzcontacto": "America/Santiago",
            "colorusuario": "NEGRO",
            "destacado": false,
            "idprioridad": null,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": "2023-09-13 15:30:58.0",
            "idusuariocreaciondesc": "Sandra Cantor",
            "fechamodificacion": "2023-09-13",
            "cantidadcasos": null,
            "fechacreacionstr": "2023-09-13 00:00:00",
            "fechahoracreacionutc": "2023-09-13 18:30:57.0",
            "idusuariomodificaciondesc": null,
            "slavalue": 60,
            "fingreso": "2023-09-13 18:30:57.0",
            "flexible": null,
            "primerpaso": 1,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": "2023-09-13 00:00:00",
            "timeactual": null,
            "idprioridadcolor": null,
            "idstageactualdesc": "Solicitar información al cliente",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhoralimit": "2023-09-13 16:30:58",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": "America/Santiago",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5296
        }, 
        ....
    ],
    "code": 200,
    "message": null,
    "pagination": {
        "cantPages": 49,
        "size": 487,
        "actualPage": 1
    }
}

Consultar casos en espera

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/get?filtro=waiting&pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>.

Request:

Parámetros:

filtro -> waiting.
pagina -> Indica el número de página que se desea consultar. Sirve para hacer paginación.
cantidad -> Indica la cantidad de casos a mostrar por página.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de todos los casos que se encuentran en un estado de Espera, independientemente del usuario o grupo asignado al caso.

Ejemplo:

{
    "data": [
        {
            "checkList": null,
            "idusuariocreacion": 8,
            "direccion": null,
            "idcontacto": 1478,
            "idestado": 4,
            "fechacreacion": "2023-07-04",
            "idcontactodesc": "Andrés Trejos",
            "idcuentadesc": null,
            "origen": "AgenteWeb",
            "finalizado": 1,
            "refnum": "230704-000004",
            "asunto": "Prueba",
            "idcuenta": null,
            "idusuarioasignado": null,
            "idtipodesc": "Requerimiento",
            "idsubtipodesc": "Aprovisionamiento de nueva instancia",
            "idestadodesc": "Más información",
            "idprioridaddesc": "Media",
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": null,
            "idworkflowdesc": "Nuevos requerimientos BA360",
            "duedate": "2023-07-05 08:01:00.0",
            "duedateslan": "2023-07-05 15:00:00.0",
            "duedateslouser": null,
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {
                "creadorInt": "8",
                "causa_raiz": "Seleccione un valor",
                "fecha_compra": "2023-07-25T04:00:00.000Z"
            },
            "idusuariomodificacion": 8,
            "descripcion": null,
            "idtipo": 2,
            "latitud": null,
            "longitud": null,
            "idworkflow": 2,
            "idsla": null,
            "porcentaje": -23520,
            "idproducto": 1,
            "idsubtipo": 2,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": 10,
            "color": null,
            "tmzcontacto": "America/Santiago",
            "colorusuario": "NEGRO",
            "destacado": false,
            "idprioridad": 2,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": "2023-07-05 00:00:34.0",
            "idusuariocreaciondesc": "Germán Andres Olano",
            "fechamodificacion": "2023-07-05",
            "cantidadcasos": null,
            "fechacreacionstr": "2023-07-04 00:00:00",
            "fechahoracreacionutc": "2023-07-05 03:57:54.0",
            "idusuariomodificaciondesc": "Germán Andres Olano",
            "slavalue": 1,
            "fingreso": "2023-07-05 04:00:24.0",
            "flexible": null,
            "primerpaso": 0,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": "2023-07-05 00:00:00",
            "timeactual": null,
            "idprioridadcolor": "#2ECC71",
            "idstageactualdesc": "Cierre",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": "2023-07-05 03:00:01",
            "fechamodificacionhoralimit": "2023-07-05 01:00:34",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": "America/Santiago",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5195
        },
        {
            "checkList": null,
            "idusuariocreacion": null,
            "direccion": null,
            "idcontacto": 1,
            "idestado": 4,
            "fechacreacion": "2023-05-30",
            "idcontactodesc": "Oskar Cantor Florez",
            "idcuentadesc": null,
            "origen": "BAEmail",
            "finalizado": 0,
            "refnum": "230530-000004",
            "asunto": "Creación de caso por correo",
            "idcuenta": null,
            "idusuarioasignado": null,
            "idtipodesc": "PUC - Tengo una solicitud",
            "idsubtipodesc": "PUC - Soporte proactivo",
            "idestadodesc": "Más información",
            "idprioridaddesc": "Normal",
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": null,
            "idworkflowdesc": "PUC - Soporte proactivo",
            "duedate": "2023-06-09 09:00:00.0",
            "duedateslan": "2023-06-12 20:00:00.0",
            "duedateslouser": null,
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 24,
            "latitud": null,
            "longitud": null,
            "idworkflow": 24,
            "idsla": null,
            "porcentaje": -19825,
            "idproducto": 1,
            "idsubtipo": 46,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": 46,
            "color": "NEGRO",
            "tmzcontacto": "America/Santiago",
            "colorusuario": null,
            "destacado": false,
            "idprioridad": 4,
            "sistemaexterno": "BAEMAIL",
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": "2023-06-20 13:43:16.0",
            "idusuariocreaciondesc": null,
            "fechamodificacion": "2023-06-20",
            "cantidadcasos": null,
            "fechacreacionstr": "2023-05-30 00:00:00",
            "fechahoracreacionutc": "2023-05-31 03:54:03.0",
            "idusuariomodificaciondesc": null,
            "slavalue": 60,
            "fingreso": "2023-06-09 00:22:00.0",
            "flexible": null,
            "primerpaso": 1,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": "2023-06-20 00:00:00",
            "timeactual": null,
            "idprioridadcolor": "#0283CC",
            "idstageactualdesc": "Contactar al cliente",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": "2023-06-20 16:00:00",
            "fechamodificacionhoralimit": "2023-06-20 14:43:16",
            "fechareapertura": "2023-06-08 20:22:00.0",
            "porcentajeslan": null,
            "tmzinstance": "America/Santiago",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5190
        }
    ],
    "code": 200,
    "message": null,
    "pagination": {
        "cantPages": 1,
        "size": 3,
        "actualPage": 1
    }
    ...
}

Consultar caso por filtro

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/get/?filtro=history&pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>&filtrobuscar=<filtro>.

Request:

Parámetros:

filtro -> history. Permite buscar por todos los casos.
pagina -> Indica el número de página que se desea consultar. Sirve para hacer paginación.
cantidad -> Indica la cantidad de casos a mostrar por página.
filtrobuscar -> Permite buscar por Número de referencia, Asunto, Contacto, Fecha de creación, Tipo, Estado y Canal.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/caso/get/?filtro=history&pagina=1&cantidad=100&filtrobuscar=200325-000006
https://api.beaware360.com/ba360/apir/v10_5/caso/get/?filtro=history&pagina=1&cantidad=10&filtrobuscar=2023-08-28

Response

Retorna la información de casos, según el filtro que se especifique. Los filtros que se manejan son: Número de referencia, Asunto, Contacto, Fecha de creación, Tipo, Estado y Canal.

Es importante aclarar que esta versión de la API, retorna información básica del caso con el fin que el tiempo de respuesta de la API sea más rápido. Para obtener toda la información del caso, se debe consumir el recurso Consultar caso por ID

Ejemplo:

{
    "data": [
        {
            "checkList": null,
            "idusuariocreacion": 8,
            "direccion": null,
            "idcontacto": 1478,
            "idestado": 4,
            "fechacreacion": "2023-07-04",
            "idcontactodesc": "Andrés Trejos",
            "idcuentadesc": null,
            "origen": "AgenteWeb",
            "finalizado": 1,
            "refnum": "230704-000004",
            "asunto": "Prueba",
            "idcuenta": null,
            "idusuarioasignado": null,
            "idtipodesc": "Requerimiento",
            "idsubtipodesc": "Aprovisionamiento de nueva instancia",
            "idestadodesc": "Más información",
            "idprioridaddesc": "Media",
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": null,
            "idworkflowdesc": "Nuevos requerimientos BA360",
            "duedate": "2023-07-05 08:01:00.0",
            "duedateslan": "2023-07-05 15:00:00.0",
            "duedateslouser": null,
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {
                "creadorInt": "8",
                "causa_raiz": "Seleccione un valor",
                "fecha_compra": "2023-07-25T04:00:00.000Z"
            },
            "idusuariomodificacion": 8,
            "descripcion": null,
            "idtipo": 2,
            "latitud": null,
            "longitud": null,
            "idworkflow": 2,
            "idsla": null,
            "porcentaje": -23521,
            "idproducto": 1,
            "idsubtipo": 2,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": 10,
            "color": null,
            "tmzcontacto": "America/Santiago",
            "colorusuario": "NEGRO",
            "destacado": false,
            "idprioridad": 2,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": "2023-07-05 00:00:34.0",
            "idusuariocreaciondesc": "Germán Andres Olano",
            "fechamodificacion": "2023-07-05",
            "cantidadcasos": null,
            "fechacreacionstr": "2023-07-04 00:00:00",
            "fechahoracreacionutc": "2023-07-05 03:57:54.0",
            "idusuariomodificaciondesc": "Germán Andres Olano",
            "slavalue": 1,
            "fingreso": "2023-07-05 04:00:24.0",
            "flexible": null,
            "primerpaso": 0,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": "2023-07-05 00:00:00",
            "timeactual": null,
            "idprioridadcolor": "#2ECC71",
            "idstageactualdesc": "Cierre",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": "2023-07-05 03:00:01",
            "fechamodificacionhoralimit": "2023-07-05 01:00:34",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": "America/Santiago",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5195
        },
        {
            "checkList": null,
            "idusuariocreacion": null,
            "direccion": null,
            "idcontacto": 1,
            "idestado": 4,
            "fechacreacion": "2023-05-30",
            "idcontactodesc": "Oskar Cantor Florez",
            "idcuentadesc": null,
            "origen": "BAEmail",
            "finalizado": 0,
            "refnum": "230530-000004",
            "asunto": "Creación de caso por correo",
            "idcuenta": null,
            "idusuarioasignado": null,
            "idtipodesc": "PUC - Tengo una solicitud",
            "idsubtipodesc": "PUC - Soporte proactivo",
            "idestadodesc": "Más información",
            "idprioridaddesc": "Normal",
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": null,
            "idworkflowdesc": "PUC - Soporte proactivo",
            "duedate": "2023-06-09 09:00:00.0",
            "duedateslan": "2023-06-12 20:00:00.0",
            "duedateslouser": null,
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 24,
            "latitud": null,
            "longitud": null,
            "idworkflow": 24,
            "idsla": null,
            "porcentaje": -19826,
            "idproducto": 1,
            "idsubtipo": 46,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": 46,
            "color": "NEGRO",
            "tmzcontacto": "America/Santiago",
            "colorusuario": null,
            "destacado": false,
            "idprioridad": 4,
            "sistemaexterno": "BAEMAIL",
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": "2023-06-20 13:43:16.0",
            "idusuariocreaciondesc": null,
            "fechamodificacion": "2023-06-20",
            "cantidadcasos": null,
            "fechacreacionstr": "2023-05-30 00:00:00",
            "fechahoracreacionutc": "2023-05-31 03:54:03.0",
            "idusuariomodificaciondesc": null,
            "slavalue": 60,
            "fingreso": "2023-06-09 00:22:00.0",
            "flexible": null,
            "primerpaso": 1,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": "2023-06-20 00:00:00",
            "timeactual": null,
            "idprioridadcolor": "#0283CC",
            "idstageactualdesc": "Contactar al cliente",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": "2023-06-20 16:00:00",
            "fechamodificacionhoralimit": "2023-06-20 14:43:16",
            "fechareapertura": "2023-06-08 20:22:00.0",
            "porcentajeslan": null,
            "tmzinstance": "America/Santiago",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5190
        },
        {
            "checkList": null,
            "idusuariocreacion": 3,
            "direccion": null,
            "idcontacto": 1,
            "idestado": 4,
            "fechacreacion": "2023-03-22",
            "idcontactodesc": "Oskar Cantor Florez",
            "idcuentadesc": null,
            "origen": "AgenteWeb",
            "finalizado": 1,
            "refnum": "230322-000007",
            "asunto": "Prueba cierre caso",
            "idcuenta": null,
            "idusuarioasignado": 3,
            "idtipodesc": "PUC - Tengo una solicitud",
            "idsubtipodesc": "PUC - Soporte proactivo",
            "idestadodesc": "Más información",
            "idprioridaddesc": null,
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": "scantor",
            "idworkflowdesc": "PUC - Soporte proactivo",
            "duedate": "2023-03-22 17:03:05.0",
            "duedateslan": "2023-03-25 18:33:00.0",
            "duedateslouser": "2023-03-22 20:03:57.0",
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": 3,
            "descripcion": null,
            "idtipo": 24,
            "latitud": null,
            "longitud": null,
            "idworkflow": 24,
            "idsla": null,
            "porcentaje": -878540,
            "idproducto": 1,
            "idsubtipo": 46,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": 48,
            "color": null,
            "tmzcontacto": "America/Santiago",
            "colorusuario": "NEGRO",
            "destacado": false,
            "idprioridad": null,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": "2023-03-22 16:33:57.0",
            "idusuariocreaciondesc": "Sandra Cantor",
            "fechamodificacion": "2023-03-22",
            "cantidadcasos": null,
            "fechacreacionstr": "2023-03-22 00:00:00",
            "fechahoracreacionutc": "2023-03-22 19:32:24.0",
            "idusuariomodificaciondesc": "Sandra Cantor",
            "slavalue": 30,
            "fingreso": "2023-03-22 19:33:05.0",
            "flexible": null,
            "primerpaso": 0,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": "2023-03-22 00:00:00",
            "timeactual": null,
            "idprioridadcolor": null,
            "idstageactualdesc": "Evaluar el servicio",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": "2023-03-22 19:00:00",
            "fechamodificacionhoralimit": "2023-03-22 17:33:57",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": "America/Santiago",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5072
        }
    ],
    "code": 200,
    "message": null,
    "pagination": {
        "cantPages": 1,
        "size": 3,
        "actualPage": 1
    }
}

Consultar caso por Id contacto

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/get/?idcontacto=<id_contacto_ba360>.

Request:

Parámetros:

idcontacto -> Indica el identificador del contacto que otorga Be Aware 360.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de todos los casos asignados al contacto por el cual se está realizando la búsqueda.

Ejemplo:

{
    "data": [
        {
            "checkList": null,
            "idusuariocreacion": 66,
            "direccion": null,
            "idcontacto": 1469,
            "idestado": 1,
            "fechacreacion": "2022-10-14",
            "idcontactodesc": "natalia tarragona",
            "idcuentadesc": null,
            "origen": "AgenteWeb",
            "finalizado": 0,
            "refnum": "221014-000001",
            "asunto": "prueba de e3",
            "idcuenta": null,
            "idusuarioasignado": 66,
            "idtipodesc": "Consulta",
            "idsubtipodesc": "Funcionalidad de la herramienta",
            "idestadodesc": "Creado",
            "idprioridaddesc": null,
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": "ntarragona",
            "idworkflowdesc": null,
            "duedate": null,
            "duedateslan": "2022-10-15 12:28:00.0",
            "duedateslouser": null,
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 7,
            "latitud": null,
            "longitud": null,
            "idworkflow": null,
            "idsla": null,
            "porcentaje": 0,
            "idproducto": 1,
            "idsubtipo": 10,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": null,
            "color": null,
            "tmzcontacto": "America/Santiago",
            "colorusuario": null,
            "destacado": false,
            "idprioridad": null,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": null,
            "idusuariocreaciondesc": "Natalia tARRAGONA",
            "fechamodificacion": null,
            "cantidadcasos": null,
            "fechacreacionstr": "2022-10-14 00:00:00",
            "fechahoracreacionutc": "2022-10-14 20:27:13.0",
            "idusuariomodificaciondesc": null,
            "slavalue": 0,
            "fingreso": null,
            "flexible": null,
            "primerpaso": 0,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": null,
            "timeactual": null,
            "idprioridadcolor": null,
            "idstageactualdesc": null,
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhoralimit": null,
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": "America/Santiago",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 4822
        }
    ],
    "code": 200,
    "message": null,
    "pagination": {
        "cantPages": 2147483647,
        "size": 1,
        "actualPage": 0
    }
}

Consultar casos abiertos creados por el usuario

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/get/?pagina=<pagina>&cantidad=<cantidad_casos_por_pagina>&filtro=created.

Request:

Parámetros:

filtro -> created.
pagina -> Indica el número de página que se desea consultar. Sirve para hacer paginación.
cantidad -> Indica la cantidad de casos a mostrar por página.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de todos los casos creados por el usuario que está autenticado y que se encuentran abiertos, independientemente de quién los tenga asignados.

Ejemplo:

{
    "data": [
        {
            "checkList": null,
            "idusuariocreacion": 7,
            "direccion": null,
            "fechacreacion": "2024-01-18",
            "idcontactodesc": "Oscar Florez",
            "idcuentadesc": null,
            "origen": "FormWEB",
            "idcontacto": 1,
            "idestado": 1,
            "finalizado": 0,
            "refnum": "240118-000001",
            "asunto": "Caso creado por API, prueba de checklist",
            "idcuenta": null,
            "idusuarioasignado": null,
            "idtipodesc": "Requerimiento",
            "idsubtipodesc": "Aprovisionamiento de nueva instancia",
            "idestadodesc": "Creado",
            "idprioridaddesc": "Alta",
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": null,
            "idworkflowdesc": "Nuevos requerimientos BA360",
            "duedate": "2024-01-18 16:19:33.0",
            "duedateslan": "2024-01-18 22:04:34.0",
            "duedateslouser": null,
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {
                "creadorInt": "7"
            },
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 2,
            "latitud": null,
            "longitud": null,
            "idworkflow": 2,
            "idsla": null,
            "porcentaje": -270026,
            "idproducto": 1,
            "idsubtipo": 2,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": 4,
            "color": "NEGRO",
            "tmzcontacto": "America/Santiago",
            "colorusuario": null,
            "destacado": false,
            "idprioridad": 1,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": "2024-01-18 16:04:36.0",
            "slavalue": 15,
            "fingreso": "2024-01-18 19:04:33.0",
            "fechacreacionstr": "2024-01-18 00:00:00",
            "idusuariocreaciondesc": "Integración API BA360 Review",
            "fechamodificacion": "2024-01-18",
            "cantidadcasos": null,
            "fechahoracreacionutc": "2024-01-18 19:04:33.0",
            "idusuariomodificaciondesc": null,
            "flexible": null,
            "primerpaso": 1,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": "2024-01-18 00:00:00",
            "timeactual": null,
            "idprioridadcolor": "#E74A25",
            "idstageactualdesc": "Ingreso de datos",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhoralimit": "2024-01-18 17:04:36",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": "America/Buenos_Aires",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5386
        },
        {
            "checkList": null,
            "idusuariocreacion": 7,
            "direccion": null,
            "fechacreacion": "2023-07-10",
            "idcontactodesc": "Miguel Pombo",
            "idcuentadesc": null,
            "origen": "FormWEB",
            "idcontacto": 2,
            "idestado": 2,
            "finalizado": 0,
            "refnum": "230710-000001",
            "asunto": "Caso creado por API, prueba de checklist",
            "idcuenta": null,
            "idusuarioasignado": 21,
            "idtipodesc": "Requerimiento",
            "idsubtipodesc": "Aprovisionamiento de nueva instancia",
            "idestadodesc": "Cerrado",
            "idprioridaddesc": "Alta",
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": "pdias",
            "idworkflowdesc": "Nuevos requerimientos BA360",
            "duedate": "2023-07-26 15:07:36.0",
            "duedateslan": "2023-07-11 15:00:00.0",
            "duedateslouser": null,
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {
                "creadorInt": "7",
                "idcasooriginal": "284221"
            },
            "idusuariomodificacion": 3,
            "descripcion": null,
            "idtipo": 2,
            "latitud": null,
            "longitud": null,
            "idworkflow": 2,
            "idsla": null,
            "porcentaje": 498332,
            "idproducto": 1,
            "idsubtipo": 2,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idstageactual": 10,
            "color": "NEGRO",
            "tmzcontacto": "America/Santiago",
            "colorusuario": "NEGRO",
            "destacado": false,
            "idprioridad": 1,
            "sistemaexterno": null,
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": "2023-07-26 16:06:35.0",
            "slavalue": 1,
            "fingreso": "2023-07-26 19:06:36.0",
            "fechacreacionstr": "2023-07-10 00:00:00",
            "idusuariocreaciondesc": "Integración API BA360 Review",
            "fechamodificacion": "2023-07-26",
            "cantidadcasos": null,
            "fechahoracreacionutc": "2023-07-10 22:46:54.0",
            "idusuariomodificaciondesc": "Sandra Cantor",
            "flexible": null,
            "primerpaso": 0,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": "2023-07-26 00:00:00",
            "timeactual": null,
            "idprioridadcolor": "#E74A25",
            "idstageactualdesc": "Cierre",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhoralimit": "2023-07-26 17:06:35",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": "America/Buenos_Aires",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5207
        },
        {
            "checkList": null,
            "idusuariocreacion": 7,
            "direccion": null,
            "fechacreacion": "2023-07-13",
            "idcontactodesc": "Diana Ochoa",
            "idcuentadesc": null,
            "origen": "voz",
            "idcontacto": 5,
            "idestado": 1,
            "finalizado": 0,
            "refnum": "230713-000006",
            "asunto": "CAMBIO DE ASUNTO EN POSTIN",
            "idcuenta": null,
            "idusuarioasignado": 4,
            "idtipodesc": "Implementación",
            "idsubtipodesc": "Solicitud de información",
            "idestadodesc": "Creado",
            "idprioridaddesc": null,
            "idproductodesc": "Be Aware 360",
            "idusuarioasignadodesc": "baintegracion",
            "idworkflowdesc": "Implementación de proyectos",
            "duedate": "2023-07-13 17:18:00.0",
            "duedateslan": null,
            "duedateslouser": "2023-07-13 21:18:00.0",
            "duedatesloutc": null,
            "duedateslorol": null,
            "cf": {},
            "idusuariomodificacion": null,
            "descripcion": null,
            "idtipo": 3,
            "latitud": null,
            "longitud": null,
            "idworkflow": 7,
            "idsla": null,
            "porcentaje": 0,
            "idproducto": 1,
            "idsubtipo": 3,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": "1",
            "idconversacion": null,
            "idstageactual": 9,
            "color": "NEGRO",
            "tmzcontacto": "America/Santiago",
            "colorusuario": "NEGRO",
            "destacado": false,
            "idprioridad": null,
            "sistemaexterno": "purecloud",
            "operationsistext": null,
            "ccemails": null,
            "textreopencase": null,
            "fechamodificacionhora": "2023-07-13 17:18:01.0",
            "slavalue": 60,
            "fingreso": "2023-07-13 20:18:00.0",
            "fechacreacionstr": "2023-07-13 00:00:00",
            "idusuariocreaciondesc": "Integración API BA360 Review",
            "fechamodificacion": "2023-07-13",
            "cantidadcasos": null,
            "fechahoracreacionutc": "2023-07-13 20:18:00.0",
            "idusuariomodificaciondesc": null,
            "flexible": null,
            "primerpaso": 1,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechamodificacionstr": "2023-07-13 00:00:00",
            "timeactual": null,
            "idprioridadcolor": null,
            "idstageactualdesc": "Solicitar información al cliente",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhoralimit": "2023-07-13 18:18:01",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": "America/Buenos_Aires",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "eid": null,
            "uuid": null,
            "id": 5213
        }
    ],
    "code": 200,
    "message": null,
    "pagination": {
        "cantPages": 2,
        "size": 6,
        "actualPage": 1
    }
}

Consultar caso por ID

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/getby?filtro=history&id=<id_caso>.

Request:

Parámetros:

filtro -> history. Este filtro es para que pueda buscar por la totalidad de casos.
id -> Recibe el id del caso en Be Aware 360.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/caso/getby?filtro=history&id=5039

Response

Retorna la información de un caso específico, según su Id en Be Aware 360.

Ejemplo:

{
    "data": {
        "checkList": null,
        "idusuariocreacion": 7,
        "direccion": null,
        "idcontacto": 1469,
        "idestado": 3,
        "fechacreacion": "2023-02-23",
        "idcontactodesc": "natalia tarragona",
        "idcuentadesc": null,
        "origen": "AgenteWeb",
        "finalizado": 0,
        "refnum": "230223-000009",
        "asunto": "se cayo la plataforma",
        "idcuenta": null,
        "idusuarioasignado": 80,
        "idtipodesc": "PUC - Tengo un Requerimiento T1G",
        "idsubtipodesc": "PUC - Requerimiento T1G",
        "idestadodesc": "En progreso",
        "idprioridaddesc": null,
        "idproductodesc": "PUC - Continuidad Operacional T1G",
        "idusuarioasignadodesc": "AgenteT1G",
        "idworkflowdesc": "PUC - Proceso de requerimiento continuidad operacional (T1G)",
        "duedate": "2023-03-01 12:38:00.0",
        "duedateslan": "2023-03-06 16:38:00.0",
        "duedateslouser": "2023-03-01 15:38:00.0",
        "duedatesloutc": null,
        "duedateslorol": "2023-03-01 15:38:00.0",
        "cf": {},
        "idusuariomodificacion": null,
        "descripcion": null,
        "idtipo": 31,
        "latitud": null,
        "longitud": null,
        "idworkflow": 31,
        "idsla": null,
        "porcentaje": -3403,
        "idproducto": 28,
        "idsubtipo": 58,
        "urlorigin": null,
        "canal": null,
        "idinteraccion": null,
        "idconversacion": null,
        "idstageactual": 63,
        "color": "NEGRO",
        "tmzcontacto": "America/Santiago",
        "colorusuario": "NEGRO",
        "destacado": false,
        "idprioridad": null,
        "sistemaexterno": null,
        "operationsistext": null,
        "ccemails": null,
        "textreopencase": null,
        "fechamodificacionhora": null,
        "idusuariocreaciondesc": "Integración API BA360",
        "fechamodificacion": null,
        "cantidadcasos": null,
        "fechacreacionstr": "2023-02-23 00:00:00",
        "fechahoracreacionutc": "2023-02-23 15:37:47.0",
        "idusuariomodificaciondesc": null,
        "slavalue": 2400,
        "fingreso": "2023-02-23 15:37:48.0",
        "flexible": null,
        "primerpaso": 1,
        "psolucionado": "0",
        "pcreado": "0",
        "ppendiente": "0",
        "horastranscurridas2": null,
        "totalnotas2": null,
        "horastranscurridas": null,
        "urgente": null,
        "normal": null,
        "totalnotas": null,
        "solucionado": null,
        "creado": null,
        "pendiente": null,
        "totalcasos": null,
        "fechamodificacionstr": null,
        "timeactual": null,
        "idprioridadcolor": null,
        "idstageactualdesc": "Ejecución de la solicitud",
        "idsladesc": null,
        "logauditoria": null,
        "fechafinalizacionhoralimit": null,
        "fechamodificacionhoralimit": null,
        "fechareapertura": null,
        "porcentajeslan": null,
        "tmzinstance": "America/Santiago",
        "duedateslo": null,
        "porcentajeslo": null,
        "datafor": null,
        "eid": null,
        "uuid": null,
        "id": 5039
    },
    "code": 200,
    "message": null,
    "pagination": null
}

Consultar caso por búsqueda avanzada

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/getBusquedaAvanzada.

Request:

Parámetros:

Al ser una búsqueda avanzada se podrán usar como parámetros los campos estándar de un caso y/o también los campos personalizados (Custom Fields) definidos para los casos, en este último caso se debe enviar como parámetro el valor del campo label.

La búsqueda corresponde a un operador AND, por lo tanto, el resultado retornará los casos que cumplen con todos los parámetros de búsqueda.

A continuación, listamos los campos estándar del caso que pueden utilizar para este recurso:

Campo	Descripción
id	Identificador único del caso asignado por Be Aware 360.
idestado	Identificador del estado asignado al caso.
idestadodesc	Descripción del estado asignado al caso.
refnum	Número del caso.
idcontacto	Identificador del contacto asignado al caso.
idcontactodesc	Nombre del contacto asignado al caso.
idcuenta	Identificador de la cuenta asignada al caso.
razonsocial	Nombre de la cuenta asignada al caso.
idusuarioasignado	Identificador del usuario asignado al caso.
idusuarioasignadodesc	Nombre del usuario asignado al caso.
idproducto	Identificador del producto asignado al caso.
idproductodesc	Nombre del producto asignado al caso.
idtipo	Identificador del motivo asignado al caso.
idtipodesc	Nombre del motivo asignado al caso.
idsubtipo	Identificador del submotivo asignado al caso.
idsubtipodesc	Nombre del submotivo asignado al caso.
origen	Nombre del canal por el cual se creó el caso.
asunto	Asunto del caso.
fechacreacion	Fecha de creación del caso.
finalizado	Indica si el caso está finalizado. 0 indica que el caso no está finalizado y 1 indica que sí está finalizado el caso.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/caso/getBusquedaAvanzada?refnum=231128-001422&nombre y apellido=perez&medio de comunicacion=celular.

Response

Retorna la lista de todos los casos que cumplen con los criterios de búsqueda especificados en los parámetros.

Ejemplo:

{
    "data": [
        {
            "checkList": null,
            "idcontacto": 777,
            "origen": "AgenteWeb",
            "finalizado": 0,
            "refnum": "231128-001422",
            "asunto": "Prueba Masiva",
            "fechacreacion": "2023-11-28",
            "idcontactodesc": "Andrés Olano",
            "idtipodesc": "Facturación y Pago",
            "idestadodesc": "Completado",
            "idusuarioasignadodesc": "MartaC",
            "idcuentadesc": null,
            "descripcion": null,
            "idworkflow": 54,
            "idtipo": 6,
            "idcuenta": null,
            "direccion": null,
            "latitud": null,
            "longitud": null,
            "idsla": null,
            "idproducto": 9,
            "idsubtipo": 1,
            "urlorigin": null,
            "canal": null,
            "idinteraccion": null,
            "idconversacion": null,
            "idusuarioasignado": 173,
            "idstageactual": 116,
            "idestado": 5,
            "idusuariocreacion": 84,
            "idworkflowdesc": "Prueba Olayo Rojas",
            "color": "NEGRO",
            "duedate": "2024-05-29 15:03:51.0",
            "duedateslan": null,
            "duedatesloutc": null,
            "duedateslouser": "2024-05-29 19:03:51.0",
            "duedateslorol": "2024-05-29 15:03:51.0",
            "tmzcontacto": "America/Santiago",
            "destacado": false,
            "porcentaje": -230923,
            "cf": {
                "Orden": "Tipo B",
                "tipo_caso": "Medio",
                "tipo_enfermedad": "Ninguna",
                "caracteristicas_caso": "[Escalado, Priorizado]",
                "medio": "Celular",
                "campo_ex": "2024-04-26T03:00:00.000Z",
                "guia": "1234",
                "nombre": "Juan Perez",
                "TipoCliente": "A"
            },
            "idusuariomodificacion": 131,
            "ccemails": null,
            "textreopencase": null,
            "idsubtipodesc": "Solicitud",
            "idprioridaddesc": "Media",
            "idproductodesc": "Crédito Inteligente",
            "idprioridad": 2,
            "colorusuario": "NEGRO",
            "fingreso": "2024-05-29 18:33:51.0",
            "flexible": null,
            "primerpaso": 0,
            "psolucionado": "0",
            "pcreado": "0",
            "ppendiente": "0",
            "horastranscurridas2": null,
            "totalnotas2": null,
            "horastranscurridas": null,
            "urgente": null,
            "normal": null,
            "totalnotas": null,
            "solucionado": null,
            "creado": null,
            "pendiente": null,
            "totalcasos": null,
            "fechacreacionstr": "2023-11-28 00:00:00",
            "fechamodificacionstr": "2024-05-29 00:00:00",
            "timeactual": null,
            "idprioridadcolor": "#27AE60",
            "idstageactualdesc": "Completado",
            "idusuariomodificaciondesc": "María Benedicto",
            "idusuariocreaciondesc": "Germán Andrés Olano",
            "idsladesc": null,
            "logauditoria": null,
            "fechafinalizacionhoralimit": null,
            "fechamodificacionhora": "2024-05-29 14:33:51.0",
            "fechamodificacionhoralimit": "2024-05-29 19:33:51",
            "fechareapertura": null,
            "porcentajeslan": null,
            "tmzinstance": "America/Santiago",
            "duedateslo": null,
            "porcentajeslo": null,
            "datafor": null,
            "operationsistext": null,
            "fechafinalizacion": null,
            "slavalue": 30,
            "sistemaexterno": null,
            "fechamodificacion": "2024-05-29",
            "fechahoracreacionutc": "2023-11-28 23:28:43.0",
            "cantidadcasos": null,
            "id": 5412,
            "eid": null,
            "uuid": null
        }
    ],
    "code": 200,
    "message": null,
    "pagination": null
}

Crear caso

Método

POST

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/add.

Request:

Parámetros:

Este recurso no recibe parámetros

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
idcontacto	Id del contacto asociado al caso	Integer	Sí		788
idproducto	Id del producto asociado al caso	Integer	Sí		36
idtipo	Id del motivo asociado al caso	Integer	Sí		4
idsubtipo	Id del submotivo asociado al caso	Integer	Sí		3
asunto	Asunto del caso	String	Sí	Máximo 500 caracteres. Si se supera este tamaño, la API responderá código de error 422.	“Asunto del caso”
origen	Canal del caso	String	Sí	Acepta los siguientes valores: FormWEB, AgenteWeb, Voz, Chat, Email, SMS, TWDirect, Messenger, Facebook, Whatsapp, Telegram, Hangout, Instagram	“FormWEB”
idusuarioasignado	Id del usuario asignado al caso	Integer	No	Esta es la lógica que emplea Be Aware 360 cuando se se envía el usuario asignado en la creación de un caso: * Si el usuario asignado NO se incluye en el request, se asigna el caso según el proceso (Asignación automática de BA360). * Si el usuario asignado se incluye en el request con valor VACÍO, se asigna el caso según el proceso (Asignación automática de BA360). * Si el usuario asignado se incluye en el request con valor NULL, se asigna el caso según el proceso (Asignación automática de BA360). * Si el usuario asignado se incluye en el request con un ID de Usuario, se asigna el caso de acuerdo con las siguientes características: - Si el ID de usuario es válido: Se crea el caso y se asigna al usuario correspondiente (ID). - Si el ID de usuario es inválido: Se crea el caso y se asigna según el proceso (Asignación automática de BA360). - Si el ID de Usuario corresponde a un Usuario Inactivo: Se crea el caso y se asigna según el proceso (Asignación automática de BA360).	7
idestado	Id del estado asociado al caso	Integer	No		1
idprioridad	Id de la prioridad asociada al caso	Integer	No		1
idcuenta	Cuenta a la que pertenece el contacto que está asociada al caso	Integer	No		45
idsla	Id del acuerdo asociado al caso	Integer	No		1
idworkflow	Id del proceso asociado al caso	Integer	No	No es necesario enviar este campo dado que la combinación del producto, motivo y submotivo asigna automáticamente el caso al proceso	2
cf	Campos personalizados del caso	Lista (depende del tipo de campo)	Depende de la configuración del campo personalizado si fue marcado como obligatorio.	Lista de campos personalizados con su valor correspondiente, separados por comas y entre corchetes {}. Nota: Los campos de tipo fecha deben ir especificados con la zona horaria, de lo contrario tomará 00:00 UTC-0	{“guia”: “2345”, “fecha guía”: “2020-01-06T05:00:00.000Z”}

Ejemplo:

{
	"idcontacto": 1,
	"idproducto": 1,
	"idtipo": 2,
	"idsubtipo": 2,
	"asunto": "Prueba Caso creado desde API",
	"origen": "FormWEB",
        "idusuarioasignado": 7,
	"idestado": 1,
	"idprioridad": 1,
	"idworkflow": null,
	"idsla": null,
	"cf": {
		"Acénto Ñ": "4567", "SPA_Número de Guía": "1234", "guia": "2345", "nombre": "Prueba"
	}
}

Response

El sistema crea el caso con la información que se ha enviado a través de la API.

Ejemplo:

{
    "data": {
        "checkList": null,
        "idusuariocreacion": 66,
        "direccion": null,
        "idcontacto": 1,
        "idestado": 1,
        "fechacreacion": "2023-09-21",
        "idcontactodesc": "Oskar Cantor Florez",
        "idcuentadesc": null,
        "origen": "FormWEB",
        "finalizado": 0,
        "refnum": "230921-000002",
        "asunto": "Prueba Caso creado desde API",
        "idcuenta": null,
        "idusuarioasignado": 7,
        "idtipodesc": "Requerimiento",
        "idsubtipodesc": "Aprovisionamiento de nueva instancia",
        "idestadodesc": "Creado",
        "idprioridaddesc": "Alta",
        "idproductodesc": "Be Aware 360",
        "idusuarioasignadodesc": "integracion",
        "idworkflowdesc": "Nuevos requerimientos BA360",
        "duedate": "2023-09-22 08:15:00.0",
        "duedateslan": "2023-09-22 15:00:00.0",
        "duedateslouser": "2023-09-22 11:15:00.0",
        "duedatesloutc": null,
        "duedateslorol": "2023-09-22 11:15:00.0",
        "cf": {
            "creadorInt": 66,
            "Acénto Ñ": "4567",
            "SPA_Número de Guía": "1234",
            "guia": "2345",
            "nombre": "Prueba"
        },
        "idusuariomodificacion": null,
        "descripcion": null,
        "idtipo": 2,
        "latitud": null,
        "longitud": null,
        "idworkflow": 2,
        "idsla": null,
        "porcentaje": 0,
        "idproducto": 1,
        "idsubtipo": 2,
        "urlorigin": null,
        "canal": null,
        "idinteraccion": null,
        "idconversacion": null,
        "idstageactual": 4,
        "color": "VERDE",
        "tmzcontacto": "America/Santiago",
        "colorusuario": "VERDE",
        "destacado": false,
        "idprioridad": 1,
        "sistemaexterno": null,
        "operationsistext": null,
        "ccemails": null,
        "textreopencase": null,
        "fechamodificacionhora": null,
        "idusuariocreaciondesc": "Natalia tARRAGONA",
        "fechamodificacion": null,
        "cantidadcasos": null,
        "fechacreacionstr": "2023-09-21 00:00:00",
        "fechahoracreacionutc": "2023-09-21 21:24:20.0",
        "idusuariomodificaciondesc": null,
        "slavalue": 15,
        "fingreso": null,
        "flexible": null,
        "primerpaso": 1,
        "psolucionado": "0",
        "pcreado": "0",
        "ppendiente": "0",
        "horastranscurridas2": null,
        "totalnotas2": null,
        "horastranscurridas": null,
        "urgente": null,
        "normal": null,
        "totalnotas": null,
        "solucionado": null,
        "creado": null,
        "pendiente": null,
        "totalcasos": null,
        "fechamodificacionstr": null,
        "timeactual": null,
        "idprioridadcolor": "#E74A25",
        "idstageactualdesc": "Ingreso de datos",
        "idsladesc": null,
        "logauditoria": null,
        "fechafinalizacionhoralimit": null,
        "fechamodificacionhoralimit": null,
        "fechareapertura": null,
        "porcentajeslan": null,
        "tmzinstance": "America/Santiago",
        "duedateslo": null,
        "porcentajeslo": null,
        "datafor": null,
        "eid": null,
        "uuid": null,
        "id": 5306
    },
    "code": 200,
    "message": "Caso creado exitosamente.",
    "pagination": null
}

Actualizar caso

Nota: Para utilizar este recurso es necesario siempre enviar todos los campos del caso y sus valores correspondientes y únicamente modificar los valores de los campos que se vayan a actualizar.

Método

PUT

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/upd.

Request:

Parámetros:

Este recurso no recibe parámetros

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
idcontacto	Id del contacto asociado al caso	Integer	Sí		788
idproducto	Id del producto asociado al caso	Integer	Sí		36
idtipo	Id del motivo asociado al caso	Integer	Sí		4
idsubtipo	Id del submotivo asociado al caso	Integer	Sí		3
asunto	Asunto del caso	String	Sí	Máximo 500 caracteres. Si se supera este tamaño, la API responderá código de error 422.	“Asunto del caso”
origen	Canal del caso	String	Sí	Acepta los siguientes valores: FormWEB, AgenteWeb, Voz, Chat, Email, SMS, TWDirect, Messenger, Facebook, Whatsapp, Telegram, Hangout, Instagram	“FormWEB”
refnum	Número de referencia del caso	String	No	Este campo se compone de: ######-######	“200421-000010”
idestado	Id del estado asociado al caso	Integer	No		1
idprioridad	Id de la prioridad asociada al caso	Integer	No		1
idcuenta	Cuenta a la que pertenece el contacto que está asociada al caso	Integer	No		45
idsla	Id del acuerdo asociado al caso	Integer	No		1
idworkflow	Id del proceso asociado al caso	Integer	No	No es necesario enviar este campo dado que la combinación del producto, motivo y submotivo asigna automáticamente el caso al proceso	2
idusuarioasignado	Id del usuario asignado al caso	Integer	No	Esta es la lógica que emplea Be Aware 360 cuando se actualiza el asignado de un caso: * Si se envía ID asignado válido, lo asigna al caso. * Si se envía ID asignado inválido, deja Caso sin asignado. * Si no se envía parámetro de asignado, deja Caso sin asignado. * Si se envía ID asignado NULL, deja al Caso sin asignado. * Si se envía un ID asignado de un usuario que está Inactivo, lo asigna al Caso.	3
cf	Campos personalizados del caso	Lista (depende del tipo de campo)	Depende de la configuración del campo personalizado si fue marcado como obligatorio.	Lista de campos personalizados con su valor correspondiente, separados por comas y entre corchetes {}. Nota: Los campos de tipo fecha deben ir especificados con la zona horaria, de lo contrario tomará 00:00 UTC-0	{“guia”: “2345”, “fecha guía”: “2020-01-06T05:00:00.000Z”}
id	Id del caso que se va a actualizar	Integer	Sí		8

Ejemplo:

{
	"idcontacto": 1,
	"idproducto": 1,
	"idtipo": 1,
	"idsubtipo": 1,
	"asunto": "Caso actualizado desde API",
	"origen": "AgenteWeb",
	"idestado": 1,
	"idusuarioasignado": 3,
	"idprioridad": 2,
	"idworkflow": 11,
	"idsla": 9,
	"cf": 
	{
		"creadorInt": "4", 
		"guia": "0987655", 
		"fecha_compra": "2020-07-02T05:00:00.000Z", 
		"nombre": "Cambio de nombre"},
	"id": 183
}

Response

El sistema actualiza el caso con la información que se ha enviado a través de la API.

Ejemplo:

{
    "data": {
        "checkList": null,
        "porcentaje": 0,
        "idcontacto": 1,
        "idproducto": 1,
        "idtipo": 1,
        "idsubtipo": 1,
        "asunto": "Caso actualizado desde API",
        "descripcion": null,
        "idcuenta": null,
        "origen": "AgenteWeb",
        "finalizado": 0,
        "idstageactual": null,
        "idworkflow": 11,
        "idworkflowdesc": "Proceso mismo asignado rol",
        "idusuarioasignado": 3,
        "refnum": "200701-000007",
        "idprioridad": 2,
        "idusuariocreacion": 3,
        "idusuariomodificacion": null,
        "cf": {
            "creadorInt": "4",
            "guia": "0987655",
            "fecha_compra": "2020-07-02T05:00:00.000Z",
            "nombre": "Cambio de nombre"
        },
        "destacado": false,
        "canal": null,
        "idinteraccion": null,
        "idconversacion": null,
        "idestado": 1,
        "idsla": 9,
        "fechacreacion": "2020-07-01",
        "fechamodificacion": "2020-07-08",
        "cantidadcasos": null,
        "sistemaexterno": null,
        "slavalue": 0,
        "fingreso": null,
        "duedate": null,
        "flexible": null,
        "primerpaso": 0,
        "psolucionado": "0",
        "pcreado": "0",
        "ppendiente": "0",
        "horastranscurridas2": null,
        "totalnotas2": null,
        "horastranscurridas": null,
        "urgente": null,
        "normal": null,
        "totalnotas": null,
        "solucionado": null,
        "creado": null,
        "pendiente": null,
        "totalcasos": null,
        "fechacreacionstr": "2020-07-01T00:00",
        "fechamodificacionstr": "2020-07-08T00:00",
        "timeactual": null,
        "idprioridadcolor": "#2ECC71",
        "idstageactualdesc": null,
        "idtipodesc": "Defecto",
        "idusuariomodificaciondesc": null,
        "idusuariocreaciondesc": "Sandra Cantor",
        "idproductodesc": "Be Aware 360",
        "idsladesc": "Atención normal",
        "idsubtipodesc": "Error de producto",
        "idusuarioasignadodesc": "scantor",
        "idprioridaddesc": "Media",
        "idcontactodesc": "Oskar Cantor",
        "idestadodesc": "Creado",
        "logauditoria": null,
        "idcuentadesc": null,
        "eid": null,
        "uuid": null,
        "id": 183
    },
    "code": 200,
    "message": null,
    "pagination": null
}

Eliminar caso

Método

DELETE

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/caso/del/?id=<id_caso>.

Request:

Parámetros:

id -> Id del caso.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/caso/del/?id=30

Response

Elimina un caso específico de la base de datos de Be Aware 360.

Ejemplo:

{
    "data": {
        "checkList": null,
        "idusuariocreacion": 66,
        "direccion": null,
        "idcontacto": 1,
        "idestado": 1,
        "fechacreacion": "2023-09-22",
        "idcontactodesc": "Oskar Cantor Florez",
        "idcuentadesc": null,
        "origen": "FormWEB",
        "finalizado": 0,
        "refnum": "230922-000001",
        "asunto": "Caso actualizado desde API",
        "idcuenta": null,
        "idusuarioasignado": 7,
        "idtipodesc": "Requerimiento",
        "idsubtipodesc": "Aprovisionamiento de nueva instancia",
        "idestadodesc": "Creado",
        "idprioridaddesc": "Alta",
        "idproductodesc": "Be Aware 360",
        "idusuarioasignadodesc": "integracion",
        "idworkflowdesc": null,
        "duedate": null,
        "duedateslan": "2023-09-22 15:58:21.0",
        "duedateslouser": null,
        "duedatesloutc": null,
        "duedateslorol": null,
        "cf": {},
        "idusuariomodificacion": null,
        "descripcion": null,
        "idtipo": 2,
        "latitud": null,
        "longitud": null,
        "idworkflow": null,
        "idsla": null,
        "porcentaje": 0,
        "idproducto": 1,
        "idsubtipo": 2,
        "urlorigin": null,
        "canal": null,
        "idinteraccion": null,
        "idconversacion": null,
        "idstageactual": null,
        "color": "ROJO",
        "tmzcontacto": "America/Santiago",
        "colorusuario": "ROJO",
        "destacado": false,
        "idprioridad": 1,
        "sistemaexterno": null,
        "operationsistext": null,
        "ccemails": null,
        "textreopencase": null,
        "fechamodificacionhora": "2023-09-22 10:00:22.0",
        "idusuariocreaciondesc": "Natalia tARRAGONA",
        "fechamodificacion": "2023-09-22",
        "cantidadcasos": null,
        "fechacreacionstr": "2023-09-22 00:00:00",
        "fechahoracreacionutc": "2023-09-22 12:58:21.0",
        "idusuariomodificaciondesc": null,
        "slavalue": 0,
        "fingreso": null,
        "flexible": null,
        "primerpaso": 0,
        "psolucionado": "0",
        "pcreado": "0",
        "ppendiente": "0",
        "horastranscurridas2": null,
        "totalnotas2": null,
        "horastranscurridas": null,
        "urgente": null,
        "normal": null,
        "totalnotas": null,
        "solucionado": null,
        "creado": null,
        "pendiente": null,
        "totalcasos": null,
        "fechamodificacionstr": "2023-09-22 00:00:00",
        "timeactual": null,
        "idprioridadcolor": "#E74A25",
        "idstageactualdesc": null,
        "idsladesc": null,
        "logauditoria": null,
        "fechafinalizacionhoralimit": null,
        "fechamodificacionhoralimit": "2023-09-22 11:00:22",
        "fechareapertura": null,
        "porcentajeslan": null,
        "tmzinstance": "America/Santiago",
        "duedateslo": null,
        "porcentajeslo": null,
        "datafor": null,
        "eid": null,
        "uuid": null,
        "id": 5307
    },
    "code": 200,
    "message": "Caso eliminado con éxito.",
    "pagination": null
}

Recursos para tipificación

Consultar productos

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/producto/get.

Este endpoint devuelve los productos, teniendo en cuenta el valor que esté configurado en la Lista de parámetros de la instancia.

Cuando consume este endpoint, se mostrarán los productos según la información que está en los parámetros de configuración en el apartado Tipificación caso en creación:

No considerar grupos → Muestra todos los productos dado que no considera grupos de contactos o agentes.

Considerar grupos de contactos → Muestra todos los productos dado que, para este endpoint, no se tiene en cuenta el grupo de contactos.

Considerar grupos de agentes → Muestra solo los productos asociados a los grupos a los que el usuario, que está ejecutando el endpoint, pertenece.

https://api.beaware360.com/ba360/apir/v10_5/producto/get?principal=1.

Este endpoint devuelve todos productos cargados en la instancia sin importar la parametrización de la Lista de parámetros.

Para más información sobre la parametrización de Tipificación caso en creación, haga clic aquí.

https://api.beaware360.com/ba360/apir/v10_5/producto/get?idcontacto=<id contacto>.

Este endpoint devuelve todos productos cargados en la instancia que puede visualizar un contacto en particular.

Request:

Parámetros:

Este recurso no recibe parámetros.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de productos creados en Be Aware 360.

Ejemplo:

{
    "data": [
        {
            "nombre": "Be Aware 360",
            "eid": null,
            "uuid": null,
            "id": 1
        },
        {
            "nombre": "Cajeros",
            "eid": null,
            "uuid": null,
            "id": 32
        },
       {
            "nombre": "Soporte mesa de ayuda",
            "eid": null,
            "uuid": null,
            "id": 33
        },
        ....
    ],
    "code": 200,
    "message": null,
    "pagination": null
}

Consultar motivos

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/tipo/get.

Este endpoint retorna todos los motivos que existen en la plataforma.

https://api.beaware360.com/ba360/apir/v10_5/tipo/get?idproducto=<idproducto>&idcontacto=<idcontacto>.

Este endpoint retorna todos los motivos que pertenecen a un producto específico y que el contacto puede visualizar.

Request:

Parámetros:

Este recurso no recibe parámetros.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de motivos creados en Be Aware 360.

Ejemplo:

{
    "data": [
       {
            "nombre": "Actualización de datos",
            "eid": null,
            "uuid": null,
            "id": 14
        },
        {
            "nombre": "Alerta Monitoreo",
            "eid": null,
            "uuid": null,
            "id": 13
        },
        {
            "nombre": "Autorización",
            "eid": null,
            "uuid": null,
            "id": 8
        },
        {
            "nombre": "Cambiar datos de la cuenta",
            "eid": null,
            "uuid": null,
            "id": 35
        }
    ],
    "code": 200,
    "message": null,
    "pagination": null
}

Consultar submotivos

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/subtipo/get.

Este endpoint retorna todo el listado de submotivos registrados en la plataforma.

https://api.beaware360.com/ba360/apir/v10_5/subtipo/get?idtipo=<idmotivo>&idproducto=<idproducto>&idcontacto=<idcontacto>.

Este endpoint retorna todos los submotivos que pertenecen al producto y motivo y que solo el contacto puede visualizar.

Request:

Parámetros:

Este recurso no recibe parámetros.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de submotivos creados en Be Aware 360.

Ejemplo:

{
    "data": [
        {
            "nombres": "1010101010",
            "eid": null,
            "uuid": null,
            "id": 38
        },
        {
            "nombres": "Acceso a la Plataforma",
            "eid": null,
            "uuid": null,
            "id": 17
        },
        {
            "nombres": "Actualización software",
            "eid": null,
            "uuid": null,
            "id": 65
        },
        {
            "nombres": "Aprovisionamiento de nueva instancia",
            "eid": null,
            "uuid": null,
            "id": 2
        },
        {
            "nombres": "Atención domiciliaria",
            "eid": null,
            "uuid": null,
            "id": 5
        }
    ],
    "code": 200,
    "message": null,
    "pagination": null
}

Consultar tipificación

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/mtmultityping/get.

Request:

Parámetros:

Este recurso no recibe parámetros.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de tipificaciones creadas en Be Aware 360.

Ejemplo:

{
    "data": [
        {
            "nombre": "Soporte BeAware 360",
            "descripcion": "Tipificación para Soporte de Be Aware 360.",
            "mtproductos": [
                1,
                17
            ],
            "mtsubtipos": [
                1,
                28
            ],
            "mttipos": [
                1,
                14
            ],
            "eid": null,
            "uuid": null,
            "id": 1
        },
        {
            "nombre": "Requerimientos BA360",
            "descripcion": "Atención de nuevos requerimientos para BA360",
            "mtproductos": [
                1
            ],
            "mtsubtipos": [
                2
            ],
            "mttipos": [
                2
            ],
            "eid": null,
            "uuid": null,
            "id": 2
        }
    ],
    "code": 200,
    "message": null,
    "pagination": {
        "cantPages": 0,
        "size": 0,
        "actualPage": 0
    }
}

Consultar prioridad

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/prioridad/get.

Request:

Parámetros:

Este recurso no recibe parámetros.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna la lista de prioridades creadas en Be Aware 360.

Ejemplo:

{
    "data": [
        {
            "color": "#E74A25",
            "nivel": "Alta",
            "uuid": null,
            "eid": null,
            "id": 1
        },
        {
            "color": "#2ECC71",
            "nivel": "Media",
            "uuid": null,
            "eid": null,
            "id": 2
        },
        {
            "color": "#0283CC",
            "nivel": "Normal",
            "uuid": null,
            "eid": null,
            "id": 4
        },
        {
            "color": "#FFB136",
            "nivel": "Baja",
            "uuid": null,
            "eid": null,
            "id": 5
        },
        {
            "color": "#34495E",
            "nivel": "VIP",
            "uuid": null,
            "eid": null,
            "id": 6
        }
    ],
    "code": 200,
    "message": null,
    "pagination": null
}

Crear tipificación

Método

POST

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/mtmultityping/add.

Request:

Parámetros:

Este recurso no recibe parámetros.

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
nombre	Nombre de la tipificación	String	Sí		Tipificación de prueba
mtproductos	Listado de los productos que harán parte de la tipificación	Id de producto	Sí	Se debe indicar el Id de los productos separados por comas `,` y enmarcados en corchetes cuadrados `[]`	[5, 6]
mttipos	Listado de los motivos que harán parte de la tipificación	Id de motivo	Sí	Se debe indicar el Id de los motivos separados por comas `,` y enmarcados en corchetes cuadrados `[]`	[3, 4, 5]
mtsubtipos	Listado de los submotivos que harán parte de la tipificación	Id de submotivo	Sí	Se debe indicar el Id de los submotivos separados por comas `,` y enmarcados en corchetes cuadrados `[]`	[3, 5]
descripcion	Texto de explicación de la tipificación	String	No		Descripción de tipificación de prueba

Ejemplo:

{
    "nombre": "Tipificación de prueba", 
    "mtproductos": [5, 6], 
    "mttipos": [3, 4, 5], 
    "mtsubtipos": [5, 3],
    "descripcion": "Descripción de tipificación de prueba"
}

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Response

Retorna los datos de la tipificación creada incluyendo el identificador asignado por Be Aware 360.

Ejemplo:

{
    "data": {
        "nombre": "Tipificación de prueba",
        "descripcion": "Descripción de tipificación de prueba",
        "mtproductos": [
            5,
            6
        ],
        "mtsubtipos": [
            5,
            3
        ],
        "mttipos": [
            3,
            4,
            5
        ],
        "eid": null,
        "uuid": null,
        "id": 40
    },
    "code": 200,
    "message": null,
    "pagination": null
}

Actualizar tipificación

Nota: Para utilizar este recurso es necesario siempre enviar todos los campos de la tipificación y sus valores correspondientes y únicamente modificar los valores de los campos que se vayan a actualizar.

Método

PUT

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/mtmultityping/upd.

Request:

Parámetros:

Este recurso no recibe parámetros

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
nombre	Nombre de la tipificación	String	Sí		Tipificación de prueba
mtproductos	Listado de los productos que harán parte de la tipificación	Id de producto	Sí	Se debe indicar el Id de los productos separados por comas `,` y enmarcados en corchetes cuadrados `[]`	[5, 6]
mttipos	Listado de los motivos que harán parte de la tipificación	Id de motivo	Sí	Se debe indicar el Id de los motivos separados por comas `,` y enmarcados en corchetes cuadrados `[]`	[3, 4, 5]
mtsubtipos	Listado de los submotivos que harán parte de la tipificación	Id de submotivo	Sí	Se debe indicar el Id de los submotivos separados por comas `,` y enmarcados en corchetes cuadrados `[]`	[3, 5]
descripcion	Texto de explicación de la tipificación	String	No		Descripción de tipificación de prueba
id	Identificador de la tipificación	Integer	Sí		18

Ejemplo:

{
    "nombre": "Tipificación de prueba actualizada", 
    "mtproductos": [5, 6], 
    "mttipos": [3, 4, 5], 
    "mtsubtipos": [6, 7],
    "descripcion": "Actualización de la descripción de tipificación de prueba",
    "id": 40
}

Response

El sistema actualiza la tipificación con la información que se ha enviado a través de la API.

Ejemplo:

{
    "data": {
        "nombre": "Tipificación de prueba actualizada",
        "descripcion": "Actualización de la descripción de tipificación de prueba",
        "mtproductos": [
            5,
            6
        ],
        "mtsubtipos": [
            6,
            7
        ],
        "mttipos": [
            3,
            4,
            5
        ],
        "eid": null,
        "uuid": null,
        "id": 40
    },
    "code": 200,
    "message": null,
    "pagination": null
}

Eliminar tipificación

Método

DELETE

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/mtmultityping/del?id=<id_tipificacion>.

Request:

Parámetros:

id -> Id de la tipificación.

Campos:

No requiere enviar campos.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/mtmultityping/del?id=15

Response

Elimina una tipificación específica de la base de datos de Be Aware 360.

Ejemplo:

{
    "data": {
        "nombre": null,
        "descripcion": null,
        "mtproductos": null,
        "mtsubtipos": null,
        "mttipos": null,
        "eid": null,
        "uuid": null,
        "id": 40
    },
    "code": 200,
    "message": null,
    "pagination": null
}

Recursos para gestión del caso

Consultar notas del caso

Método

GET

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/actividad/get?idobjeto=<id_caso>&tipoobjeto=casos&pagina=<pagina>&cantidad=<cantidad_notas_a_mostrar_por_pagina>.

Request:

Parámetros:

idobjeto -> Corresponde al id del caso.
tipoobjeto -> Corresponde al tipo de objeto del cual se están consultando las notas. En este caso el valor corresponde a //caso//.
pagina -> Indica el número de página a retornar.
cantidad -> Indica el número de notas a retornar por página.

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Campos:

No requiere enviar campos.

Ejemplo:

https://api.beaware360.com/ba360/apir/v10_5/actividad/get?idobjeto=129&tipoobjeto=casos&pagina=1&cantidad=10

Response

El sistema retorna las notas del caso específico.

Ejemplo:

{
    "data": [
        {
            "message": null,
            "idcontacto": 0,
            "idcontactodesc": null,
            "idusuario": 3,
            "idarchivo": 0,
            "texto": "<p>Nota 11</p>",
            "tipoobjeto": "casos",
            "idobjeto": 129,
            "cfinalizado": 0,
            "privado": 1,
            "casos": [],
            "fechahora": "13-10-2020 14:49:36",
            "seen": 0,
            "canal": null,
            "idconversacion": null,
            "caso": "200610-000003",
            "idusuarionombre": null,
            "idusuarioapellido": null,
            "idusuariodesc": "Sandra Cantor",
            "nombrearchivo": null,
            "idarchivos": null,
            "tags": null,
            "fechahoracreacionutc": "2020-06-10 19:43:13.0",
            "eid": null,
            "uuid": null,
            "id": 886
        },
        {
            "message": null,
            "idcontacto": 0,
            "idcontactodesc": null,
            "idusuario": 3,
            "idarchivo": 0,
            "texto": "<p>Nota 10</p>",
            "tipoobjeto": "casos",
            "idobjeto": 129,
            "cfinalizado": 0,
            "privado": 1,
            "casos": [],
            "fechahora": "13-10-2020 14:49:29",
            "seen": 0,
            "canal": null,
            "idconversacion": null,
            "caso": "200610-000003",
            "idusuarionombre": null,
            "idusuarioapellido": null,
            "idusuariodesc": "Sandra Cantor",
            "nombrearchivo": null,
            "idarchivos": null,
            "tags": null,
            "fechahoracreacionutc": "2020-06-10 19:43:13.0",
            "eid": null,
            "uuid": null,
            "id": 885
        },
        {
            "message": null,
            "idcontacto": 0,
            "idcontactodesc": null,
            "idusuario": 3,
            "idarchivo": 0,
            "texto": "<p>Nota&nbsp;</p>",
            "tipoobjeto": "casos",
            "idobjeto": 129,
            "cfinalizado": 0,
            "privado": 1,
            "casos": [],
            "fechahora": "13-10-2020 14:49:25",
            "seen": 0,
            "canal": null,
            "idconversacion": null,
            "caso": "200610-000003",
            "idusuarionombre": null,
            "idusuarioapellido": null,
            "idusuariodesc": "Sandra Cantor",
            "nombrearchivo": null,
            "idarchivos": null,
            "tags": null,
            "fechahoracreacionutc": "2020-06-10 19:43:13.0",
            "eid": null,
            "uuid": null,
            "id": 884
        }        
    ],
    "code": null,
    "message": null,
    "pagination": {
        "cantPages": 2,
        "size": 12,
        "actualPage": 1
    }
}

Agregar notas al caso

Método

POST

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/actividad/add.

Request:

Parámetros:

Este recurso no recibe parámetros

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
idobjeto	Id del caso al que se le agregará la nota	Integer	Sí		28
tipoobjeto	Especifica el tipo de objeto de la nota	String	Sí	Valor: “casos”	“casos”
texto	Texto correspondiente a la nota	String	Sí		“Ejemplo de una nota agregada”
privado	Identifica si la nota es privada o pública	Integer	Sí	Valores posibles: 0 → pública 1 → privada	1

Ejemplo:

{
	"idobjeto": 5306,
	"tipoobjeto": "casos",
	"texto": "<p>Nota agregada</p>",
	"privado": 1
}

Response

El sistema agrega una nota al caso con la información que se ha enviado a través de la API.

Ejemplo:

{
    "data": {
        "message": null,
        "idcontacto": 0,
        "idcontactodesc": null,
        "idusuario": 66,
        "idarchivo": 0,
        "texto": "<p>Nota agregada</p>",
        "tipoobjeto": "casos",
        "idobjeto": 5306,
        "cfinalizado": 0,
        "privado": 1,
        "casos": [],
        "fechahora": "2023-09-22 20:04:03.0",
        "seen": 0,
        "canal": null,
        "idconversacion": null,
        "caso": "230921-000002",
        "idusuarionombre": null,
        "idusuarioapellido": null,
        "idusuariodesc": "Natalia tARRAGONA",
        "nombrearchivo": null,
        "idarchivos": null,
        "tags": null,
        "fechahoracreacionutc": "2023-09-21 21:24:20.0",
        "eid": null,
        "uuid": null,
        "id": 4472
    },
    "code": 200,
    "message": "Nota creada exitosamente.",
    "pagination": null
}

Agregar archivos adjuntos al caso

Método

POST

URL Recurso

https://api.beaware360.com/ba360/uploadfile.

Request:

Parámetros:

Este recurso no recibe parámetros

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
COMPANYNAME	Instancia de Be Aware 360.	String	Sí		ba360review
IDOBJETO	Id del caso al que se le agregará el archivo.	Integer	Sí		203
TIPOOBJETO	Especifica el tipo de objeto de la nota.	String	Sí	Valor: “casos”	casos
TAGS	Especifica la etiqueta que llevará el archivo adjunto al caso.	String	Sí	Acepta valores vacíos, pero es obligatorio que se envíe en el request.	Prueba API
FILE	Archivo adjunto del caso	Archivo (Formato binario).	Sí	De acuerdo con el lenguaje de programación que se esté empleando, se deben usar las funciones para cargar el archivo y generar dicho archivo en formato binario.
IDUSUARIO	Identifica el ID de usuario que hace la carga del archivo al caso.	Integer	Sí		3

Ejemplo:

Ejemplo de carga de archivos adjuntos desde Postman

Response

El sistema agrega un archivo al caso y retorna el Id del archivo adjunto.

Ejemplo:

{
	"id":"314"
}

Descargar un archivo adjunto

Método

POST

URL Recurso

https://api.beaware360.com/ba360/downloadfile.

Request:

Parámetros:

Este recurso no recibe parámetros

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
COMPANYNAME	Instancia de Be Aware 360.	String	Sí		ba360review
ID	Id del archivo que se va a descargar.	Integer	Sí		34

Ejemplo:

Ejemplo descarga de archivos adjuntos

Response

El sistema retorna el archivo adjunto en formato binario y en la cabecera de la respuesta se observa la información retornada.

Ejemplo:

Ejemplo respuesta descarga de archivos adjuntos

Avanzar el paso de un caso

Método

POST

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/workflow/next.

Request:

Parámetros:

Este recurso no recibe parámetros

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
id	Id del caso al que se le avanzará el paso.	Integer	Sí		5306

Ejemplo:

{
    "id": 5306
}

Response

El sistema valida si los checklist asociados al paso del caso han sido completados y avanza al siguiente paso.

Ejemplo cuando se han marcado todos los checklists del paso:

{
    "data": {
        "checkList": null,
        "idusuariocreacion": 66,
        "direccion": null,
        "idcontacto": 1,
        "idestado": null,
        "fechacreacion": "2023-09-21",
        "idcontactodesc": "Oskar Cantor Florez",
        "idcuentadesc": null,
        "origen": "FormWEB",
        "finalizado": 0,
        "refnum": "230921-000002",
        "asunto": "Caso actualizado desde API",
        "idcuenta": null,
        "idusuarioasignado": null,
        "idtipodesc": "Requerimiento",
        "idsubtipodesc": "Aprovisionamiento de nueva instancia",
        "idestadodesc": null,
        "idprioridaddesc": "Alta",
        "idproductodesc": "Be Aware 360",
        "idusuarioasignadodesc": null,
        "idworkflowdesc": null,
        "duedate": null,
        "duedateslan": "2023-09-22 15:00:00.0",
        "duedateslouser": null,
        "duedatesloutc": null,
        "duedateslorol": null,
        "cf": {},
        "idusuariomodificacion": 66,
        "descripcion": null,
        "idtipo": 2,
        "latitud": null,
        "longitud": null,
        "idworkflow": null,
        "idsla": null,
        "porcentaje": null,
        "idproducto": 1,
        "idsubtipo": 2,
        "urlorigin": null,
        "canal": null,
        "idinteraccion": null,
        "idconversacion": null,
        "idstageactual": null,
        "color": "VERDE",
        "tmzcontacto": "America/Santiago",
        "colorusuario": "NEGRO",
        "destacado": false,
        "idprioridad": 1,
        "sistemaexterno": null,
        "operationsistext": null,
        "ccemails": null,
        "textreopencase": null,
        "fechamodificacionhora": "2023-09-22 18:39:39.0",
        "idusuariocreaciondesc": "Natalia tARRAGONA",
        "fechamodificacion": "2023-09-22",
        "cantidadcasos": null,
        "fechacreacionstr": "2023-09-21 00:00:00",
        "fechahoracreacionutc": "2023-09-21 21:24:20.0",
        "idusuariomodificaciondesc": "Natalia tARRAGONA",
        "slavalue": 0,
        "fingreso": null,
        "flexible": null,
        "primerpaso": 0,
        "psolucionado": "0",
        "pcreado": "0",
        "ppendiente": "0",
        "horastranscurridas2": null,
        "totalnotas2": null,
        "horastranscurridas": null,
        "urgente": null,
        "normal": null,
        "totalnotas": null,
        "solucionado": null,
        "creado": null,
        "pendiente": null,
        "totalcasos": null,
        "fechamodificacionstr": "2023-09-22 00:00:00",
        "timeactual": null,
        "idprioridadcolor": "#E74A25",
        "idstageactualdesc": null,
        "idsladesc": null,
        "logauditoria": null,
        "fechafinalizacionhoralimit": null,
        "fechamodificacionhoralimit": "2023-09-22 19:39:39",
        "fechareapertura": null,
        "porcentajeslan": null,
        "tmzinstance": "America/Santiago",
        "duedateslo": null,
        "porcentajeslo": null,
        "datafor": null,
        "eid": null,
        "uuid": null,
        "id": 5306
    },
    "code": 200,
    "message": null,
    "pagination": null
}

Ejemplo cuando no se han marcado todos los checklists del paso:

{
    "data": null,
    "code": 500,
    "message": "No se han cumplido todos los checks de la lista.",
    "pagination": null
}

Retroceder el paso de un caso

Método

POST

URL Recurso

https://api.beaware360.com/ba360/apir/v10_5/workflow/back.

Request:

Parámetros:

Este recurso no recibe parámetros

Autenticación:

Tipo de autenticación	Usuario	Contraseña
Basic Auth	compañia/usuario. Por ejemplo ba360review/aatencion	El Token obtenido en GetToken.

Campos:

Campo API	Descripción	Tipo de dato	Requerido	Comentario	Ejemplo
id	Id del caso al cual se retrocederá el paso.	Integer	Sí		5306

Ejemplo:

{
    "id": 5306
}

Response

El sistema retrocede el caso al paso anterior.

Ejemplo:

{
    "data": {
        "checkList": null,
        "idusuariocreacion": 66,
        "direccion": null,
        "idcontacto": 1,
        "idestado": null,
        "fechacreacion": "2023-09-21",
        "idcontactodesc": "Oskar Cantor Florez",
        "idcuentadesc": null,
        "origen": "FormWEB",
        "finalizado": 0,
        "refnum": "230921-000002",
        "asunto": "Caso actualizado desde API",
        "idcuenta": null,
        "idusuarioasignado": null,
        "idtipodesc": "Requerimiento",
        "idsubtipodesc": "Aprovisionamiento de nueva instancia",
        "idestadodesc": null,
        "idprioridaddesc": "Alta",
        "idproductodesc": "Be Aware 360",
        "idusuarioasignadodesc": null,
        "idworkflowdesc": null,
        "duedate": null,
        "duedateslan": "2023-09-22 15:00:00.0",
        "duedateslouser": null,
        "duedatesloutc": null,
        "duedateslorol": null,
        "cf": {},
        "idusuariomodificacion": 66,
        "descripcion": null,
        "idtipo": 2,
        "latitud": null,
        "longitud": null,
        "idworkflow": null,
        "idsla": null,
        "porcentaje": 0,
        "idproducto": 1,
        "idsubtipo": 2,
        "urlorigin": null,
        "canal": null,
        "idinteraccion": null,
        "idconversacion": null,
        "idstageactual": null,
        "color": "VERDE",
        "tmzcontacto": "America/Santiago",
        "colorusuario": "NEGRO",
        "destacado": false,
        "idprioridad": 1,
        "sistemaexterno": null,
        "operationsistext": null,
        "ccemails": null,
        "textreopencase": null,
        "fechamodificacionhora": "2023-09-22 18:44:14.0",
        "idusuariocreaciondesc": "Natalia tARRAGONA",
        "fechamodificacion": "2023-09-22",
        "cantidadcasos": null,
        "fechacreacionstr": "2023-09-21 00:00:00",
        "fechahoracreacionutc": "2023-09-21 21:24:20.0",
        "idusuariomodificaciondesc": "Natalia tARRAGONA",
        "slavalue": 0,
        "fingreso": null,
        "flexible": null,
        "primerpaso": 0,
        "psolucionado": "0",
        "pcreado": "0",
        "ppendiente": "0",
        "horastranscurridas2": null,
        "totalnotas2": null,
        "horastranscurridas": null,
        "urgente": null,
        "normal": null,
        "totalnotas": null,
        "solucionado": null,
        "creado": null,
        "pendiente": null,
        "totalcasos": null,
        "fechamodificacionstr": "2023-09-22 00:00:00",
        "timeactual": null,
        "idprioridadcolor": "#E74A25",
        "idstageactualdesc": null,
        "idsladesc": null,
        "logauditoria": null,
        "fechafinalizacionhoralimit": null,
        "fechamodificacionhoralimit": "2023-09-22 19:44:14",
        "fechareapertura": null,
        "porcentajeslan": null,
        "tmzinstance": "America/Santiago",
        "duedateslo": null,
        "porcentajeslo": null,
        "datafor": null,
        "eid": null,
        "uuid": null,
        "id": 5306
    },
    "code": 200,
    "message": null,
    "pagination": null
}