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

{
    // 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

{
    "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
    ]
}

Obtener log de cambios en Contactos

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

[
    {
        "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"

{
    // Response
}

Last updated