Contactos
Permite la administración de los contactos del sistema
Obtener un contacto
GET
https://api.trii.com.ar/v1/contacts/{idC}
Query Parameters
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
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
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
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