Retrieve threads
Obtén una lista de hilos de conversación de las bandejas de entrada especificadas en tu cuenta de HubSpot. Este punto de terminación te permite filtrar hilos por contactos asociados, tickets, estado y más. Es útil para gestionar y revisar hilos de comunicación de forma eficiente.
Supported products
Supported products
Required Scopes
Required Scopes
Autorizaciones
The access token received from the authorization server in the OAuth 2.0 flow.
Parámetros de consulta
El token del cursor de paginación del último recurso leído con éxito se devolverá como la propiedad JSON paging.next.after de una respuesta paginada que contenga más resultados.
Si se devolverán solo los resultados que se han archivado.
Obtén una lista filtrada de conversaciones de un contacto específico por su ID. Este parámetro no puede utilizarse junto con la propiedad inboxId.
El ID de un ticket asociado al hilo. Cuando se proporciona, solo devuelve los hilos vinculados al ticket especificado.
Puedes especificar aquí un tipo de asociación de TICKET. Si se define este parámetro, la respuesta incluirá un objeto Asociaciones de cadenas y un identificador de ticket asociado, si está presente. Si no hay asociaciones a un ticket con esta conversación, el objeto Asociaciones de cadenas no estará presente en la respuesta.
TICKET El ID de la bandeja de conversaciones que puedes incluir opcionalmente para recuperar los mensajes asociados. Este parámetro no puede utilizarse junto con la propiedad associatedContactId.
El latestMessageTimestamp mínimo (más antiguo). Solo es necesario cuando se ordena por latestMessageTimestamp.
El número máximo de resultados que se mostrarán por página.
Una propiedad específica que se incluirá en la respuesta de la cadena.
Define el orden de clasificación de la respuesta. Las opciones válidas son id (predeterminado) y latestMessageTimestamp (que requiere que el campo latestMessageTimestampAfter también esté definido). Si estás filtrando cadenas por associatedContactId, puedes clasificarlas en orden descendente añadiendo el signo "-" delante de la opción de ordenación (por ejemplo, -id o -latestMessageTimestampAfter). De lo contrario, los resultados se mostrarán siempre en orden ascendente.
El estado de las conversaciones asociadas por el que filtrar (OPEN o CLOSED). Se debe proporcionar esta propiedad si incluyes el parámetro de consulta associatedContactId.
CLOSED, OPEN