Lista de eventos

get

https://{subdominio}.kommo.com/api/v4/events

Este método permite obtener la lista de eventos.

Limitaciones
El método está disponible para todos los usuarios de la cuenta. La información retornada depende de los derechos del usuario para la entidad.

Encabezado de tipo de datos cuando la solicitud es exitosa
Content-Type: application/hal+json.

Encabezado de tipo de datos en caso de un error
Content-Type: application/problem+json.

Parámetros de respuesta

El método retorna un arreglo de objetos evento.

Parámetro	Tipo de dato	Descripción
id	string	ID del evento.
type	string	Tipo de evento.
entity_id	int	ID de la entidad a la que pertenece el evento.
entity_type	string	Tipo de la entidad a la que pertenece el evento.
created_by	int	ID del usuario que creó el evento.
created_at	int	Fecha de creación del evento en formato Unix Timestamp.
value_after	array	Un arreglo de los cambios del evento.
value_before	array	Un arreglo de los cambios del evento.
account_id	int	ID de la cuenta donde se encuentra el evento.

parámetros `with`

Parámetro	Descripción
contact_name	Si el evento pertenece a un contacto, recibirás el nombre del contacto así como su ID en la respuesta.
lead_name	Si el evento pertenece a un lead, recibirás el nombre del lead así como su ID en la respuesta.
company_name	Si el evento pertenece a una compañía, recibirás el nombre de la compañía así como su ID en la respuesta.
catalog_name	Si el evento pertenece a un elemento de lista, recibirás el nombre de la lista así como su ID en la respuesta.
catalog_element_name	Si el evento pertenece a un elemento de lista, recibirás el nombre de la lista así como su ID en la respuesta.

Query Params

with

string

Este parámetro acepta una cadena que puede consistir en varios valores separados por comas. Puedes encontrarlos en la tabla WITH

page

int32

Una página de los datos de la respuesta

limit

int32

El número de entidades retornadas en la respuesta de una solicitud (límite: 250)

filter[id]

string

Filtrar por el ID del evento. Puedes pasar un solo ID o varios IDs separados por comas

filter[created_at][from]

int32

Filtrar por la fecha de creación del evento. Se puede pasar una marca de tiempo; en ese caso, se retornarán los eventos creados después del valor de la marca de tiempo

filter[created_at][to]

int32

Filtrar por la fecha de creación del evento. Se puede pasar una marca de tiempo, en ese caso, se retornarán los eventos creados antes del valor de la marca de tiempo

filter[created_by]

string

Filtrar por usuarios. Se puede pasar una cadena de hasta 10 IDs de usuarios, separados por coma

filter[entity]

string

Filtrar por el tipo de entidad, pasado como una cadena de entidades separadas por coma. Parámetros disponibles: lead, contact, company, task, catalog_{LIST_ID}

filter[entity_id]

string

Filtrar por el ID de la entidad. Se puede pasar una cadena con hasta 10 IDs separados por comas. Pasa solo una entidad para filtrar[entity] para utilizar este filtro

filter[type]

string

Filtrar por el tipo de evento. Los tipos se pasan como una cadena de tipos separados por comas. Puedes encontrar los tipos de evento aquí: https://es-developers.kommo.com/reference/tipos-de-eventos

Responses

Parámetros de respuesta

parámetros with

200200

401401

402402

parámetros `with`