Skip to main content
GET
Get timeline of activities for a contact (across all clients)

Authorizations

Authorization
string
header
required

Token de sesión Better Auth para rutas de backoffice; las rutas de portal usan su token propio.

Path Parameters

contactId
string
required

Contact UUID

Query Parameters

activity_type_id
number

Filter by activity type

contact_id
string

Filtrar por contacto

date_from
string

Filter activities from this date

Example:

"2026-01-01"

date_to
string

Filter activities until this date

Example:

"2026-12-31"

include_emails
boolean
default:true

Incluir emails en el timeline (default: true)

group_threads
boolean
default:true

Agrupar emails por thread_id cuando tienen conversaciones (default: true)

whatsapp_gap_hours
number
default:0

WhatsApp: split conversations into sessions when gap >= N hours (0 = no split). Default: 24.

Response

200 - application/json

Timeline items (activities only) sorted by date DESC

item_type
enum<string>
required

Tipo de item: activity, visit, task, ticket_comment (comentario de un ticket vinculado al negocio) o fiscal_event (evento fiscal de la factura)

Available options:
activity,
visit,
task,
ticket_comment,
fiscal_event
date
string<date-time>
required

Fecha del evento (para ordenamiento)

client_id
object | null
required

ID del cliente

activity_id
string

ID de la actividad (si item_type = activity)

contact_id
object

ID del contacto asociado

opportunity_id
object

ID de la oportunidad asociada

occurred_at
object

Fecha/hora efectiva de la actividad

website_form_submission_id
object

ID del formulario web asociado

activity_type_id
number

ID del tipo de actividad

activity_type_name
string

Nombre del tipo de actividad

content
string

Contenido de la actividad o tarea

files_count
number

Cantidad de archivos adjuntos

contact_name
object

Nombre del contacto

participants
array

Contactos participantes de la actividad

created_by
object | null

ID del usuario autor de la actividad

created_by_name
object

Nombre del creador

edited_at
object | null

Última edición del contenido por su autor

editable
boolean

El usuario actual puede editar el contenido (autor de un registro manual)

external_source
object

Fuente externa (outlook, whatsapp, etc.)

external_id
object

ID externo en el sistema de origen

websiteFormSubmission
object

Datos estructurados del formulario web asociado

emailMeta
object

Metadatos de correo asociados a la actividad

whatsappMeta
object

Metadatos de WhatsApp asociados a la actividad

visit_detail_id
string

ID de la visita (si item_type = visit)

visit_date
object

Fecha de la visita

description
object

Descripción de la visita

visit_type_name
object

Tipo de visita

visit_status_name
object

Estado de la visita

technician_name
object

Nombre del técnico

address
object

Dirección de la visita

task_id
string

ID de la tarea

task_status
string

Estado de la tarea

assigned_to_name
object

Nombre del responsable asignado

assigned_to_id
object

ID del responsable asignado

task_due_date
object

Vencimiento de la tarea

task_completed_at
object

Cuándo se completó la tarea

task_priority
object

Prioridad de la tarea: low, medium o high

task_version
number

Versión de la tarea para editarla

ticket_comment_id
string

ID del comentario (si item_type = ticket_comment)

comment_visibility
enum<string>

Nota interna o respuesta al cliente del ticket vinculado

Available options:
internal,
external
fiscal_event_id
string

ID del evento de la factura, o <documento>:intercambio / <documento>:aceptacion si sale del documento tributario (si item_type = fiscal_event)

fiscal_event_type
string

Tipo del evento de la factura (dte_emitted, sii_accepted, payment_received, email_sent…) o dte_intercambio_sent / dte_acceptance

fiscal_acceptance_status
enum<string> | null

Aceptación comercial del receptor en dte_acceptance

Available options:
TACIT,
EXPRESS,
CLAIMED
fiscal_recipient
object | null

Casilla de intercambio en dte_intercambio_sent

origin
object

Registro donde ocurrió (timeline del negocio): el negocio o un ticket vinculado

isThread
boolean
default:false

Indica si este item es un thread agrupado de emails

threadCount
number

Cantidad de mensajes en el thread (cuando isThread = true)

threadMessages
array

Array de actividades que forman parte del thread (cuando isThread = true)

threadType
enum<string>

Tipo de hilo agrupado

Available options:
email,
whatsapp