AgentclicAgentclic
Crear token
Secciones

Contactos

Listar contactos

GET/clients/{clientId}/contacts

Contactos del CRM de un cliente, con los mismos filtros que el panel.

Devuelve los contactos por páginas: primero los que tienen actividad más reciente y después el resto por fecha de alta, igual que la lista del panel.

Para pedir la página siguiente, envía el valor de nextCursor en cursor. total solo viene en la primera página.

Autenticación

Cabecera Authorization: Bearer ack_live_…. Permiso necesario: contacts:read (o el de escritura). Cada llamada correcta consume créditos (créditos y límites).

Parámetros de la ruta

clientIduuidobligatorio

Id del cliente (ver «Listar clientes»).

Parámetros de consulta

limitinteger

Contactos por página, de 1 a 100. Por defecto, 50.

cursorstring

Valor de nextCursor de la página anterior.

qstring

Busca en nombre, email y teléfono.

stagesstring

Ids de etapa separados por comas. «none» = sin etapa.

channelsstring

Orígenes separados por comas (widget, whatsapp, instagram, telegram, meta_lead, api, manual…).

fromdate-time

Alta desde esta fecha (ISO 8601).

todate-time

Alta hasta esta fecha (ISO 8601).

Respuestas

200Correcto. Consume créditos.
401UNAUTHORIZED · Falta el token o no es válido.
401TOKEN_REVOKED · El token se ha revocado.
401TOKEN_EXPIRED · El token ha caducado.
403PLAN_REQUIRED · La cuenta no tiene el plan Agentes ilimitados.
402NO_CREDITS · No quedan créditos en la cuenta.
429RATE_LIMITED · Más de 60 llamadas por minuto con el mismo token.
403FORBIDDEN_SCOPE · El token no tiene el permiso necesario.
404NOT_FOUND · El cliente no existe, no es tuyo o el token está limitado a otro cliente.
422VALIDATION_ERROR · Algún parámetro no es válido.

Las respuestas de error no consumen créditos.