Contactos

Permite la administración de los contactos del sistema

Obtener un contacto

GET https://api.trii.com.ar/v1/contacts/{idC}

Query Parameters

Name	Type	Description
idC	int	id del contacto

200: OK

{
    // Response
}

400: Bad Request

{
    // Response
}

401: Unauthorized

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Buscar contactos

GET https://api.trii.com.ar/v1/Contacts

Todos los parámetros son opcionales. En caso de no especificar ninguno devuelve los primeros 20 de la lista completa, utilizar currentPage para la paginación. Los valores pasados para realizar la búsqueda pueden ser parciales ejemplo: https://api.trii.com.ar/v1/Contacts?DNI=12345678

Query Parameters

Name	Type	Description
currentPage	int	indicar el numero de pagina, 20 resultados por página. Valor por defecto: 1
name	string	nombre del contacto. Búsqueda parcial
im	string	numero de WhatsApp
email	string	email del contacto
tag	string	etiqueta del contacto
phone	string	numero telefónico
{customField}	string	Cualquier otro campo personalizado definido. {customField} Debe coincidir con alguno de los nombres definidos en: "Sistema -> Contactos -> Campos Personalizados"
updateAfter	string	yyyy-mm-dd

200: OK

{
    "paginacion": {
        "total": 1,               //cantidad total de resultados
        "perPage": 20,            //cant de resultados por pagina
        "currentPage": 1,         
        "lastPage": 1,            //cant total de paginas
        "cantPageElements": 1     //cant de resultados en la pagina actual
    },
    "contacts":[
        {...}//resultado de la busqueda
    ]
}

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Obtener log de cambios en Contactos

GET https://api.trii.com.ar/v1/Contacts/logs/{yyyy-mm-dd}

200: OK

[
    {
        "id": 1000001, //id de log
        "fechahora": "2023-01-01T00:00:00.000",
        "idC": 10001, //id del contacto en Trii
        "usuario": "test", //usuario que realiza el cambio
        "detalle": "Se actualiza contacto.",
        "column": "Mombre",
        "value_before": "Juan",
        "value_after": "Juan Pablo" //nuevo valor
    }
]

/// El atributo "column" puede especificar el nombre del campo personalizado o tamar algunos de los siguientes valores:
///
///contactAddressAdd -> se agrega nueva direccion de contacto (tel, email, whatsapp, etc)
///contactAddressDel -> se quita una direccion de contacto
///Join -> se unen 2 contactos
///profileUrl -> imagen del perfil
///tagAdd -> se agrega etiqueta
///tagDel -> se quita etiqueta

Crear/actualizar contactos.

PUT https://api.trii.com.ar/v1/contacts

Request Body

Name	Type	Description
contactos*	array	array de objetos JSON con los atributos del contacto
actualizarSegun	string	nombre del parámetro utilizado para buscar el contacto y posteriormente actualizar. El objeto JSON debe tener un atributo con ésta misma clave. Valores permitidos: ["id", "nombre", {cualquier valor asociado a un campo personalizado}] Si no está definido, la operación será "Crear contacto"

200: OK

{
    // Response
}

400: Bad Request

{
    // Response
}

401: Unauthorized

{
    // Response
}

500: Internal Server Error

{
    // Response
}