/deals/tasksListar tareas de la cuenta
Todas las tareas que tiene pendientes la cuenta, en todos los deals, empezando por las más próximas.
GET https://api.getincloud.ai/v1/deals/tasksTodas las tareas que tiene pendientes la cuenta, en todos los deals, empezando por las más próximas.
Una tarea es una nota de un deal que incluye una fecha dueAt, por lo que este endpoint es la
lectura a nivel de cuenta de los mismos documentos que GET /deals/{dealId}/notes devuelve para un
solo deal. Las notas sin fecha de vencimiento nunca se incluyen.
Por defecto solo se devuelven las pendientes. Envía done=true para incluir también las tareas ya completadas.
from y to son instantes absolutos, de modo que quien llama decide qué significan "hoy",
"mañana" o "vencidas" en su propia zona horaria: las vencidas se obtienen con to=<now>, y
un día corresponde a los límites de ese día en la zona horaria de quien lee.
La respuesta incluye las tareas y sus deals padre como dos listas unidas por el id deal
de la tarea, de modo que un deal con varias tareas se envía una sola vez.
Los agentes con acceso restringido reciben solo las tareas de sus propios deals, siguiendo las mismas reglas de visibilidad
del tablero y de la bandeja de entrada. Para esos usuarios el filtro se aplica después de cortar
la página, por lo que una página puede devolver menos filas que limit mientras páginas posteriores
aún contienen tareas: sigue paginando hasta que una página llegue vacía.
Prueba este endpoint en el probador de API en vivo
>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y prueba la API en vivo con el probador con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.
Autenticación
Envía tu API key en el encabezado Token en cada petición.
Parámetros
| Campo | Dónde | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
from | query | string | No | Solo tareas que vencen en este instante o después (ISO 8601) format: date-time |
to | query | string | No | Solo tareas que vencen en este instante o antes (ISO 8601). Las vencidas se obtienen solo con este parámetro, establecido en el momento actual format: date-time |
done | query | boolean | No | Incluir tareas completadas. Por defecto false: solo lo que aún está pendiente |
device | query | string | No | Solo tareas de los deals de este número de WhatsApp minLength: 24 · maxLength: 24 · pattern: ^[a-f0-9]{24}$ |
deals | query | string | No | Solo tareas de estos deals, como lista separada por comas o como parámetro repetido, hasta 100. Responde a "cuáles de estas tarjetas tienen algo pendiente" para los deals que se muestran actualmente en pantalla |
limit | query | number | No | Máximo de resultados, por defecto 50, máximo 200 minimum: 1 · maximum: 200 |
skip | query | number | No | Omitir N resultados minimum: 0 · maximum: 10000 |
Respuestas
| Código | Descripción |
|---|---|
200 | Tareas pendientes, de la más próxima a la más lejana, con sus deals padre |
400 | Ventana de fechas o ID de dispositivo no válidos |
401 | No autorizado: token de API no válido o ausente |
403 | Faltan los permisos requeridos |
404 | Recurso no encontrado |
409 | Conflicto |
429 | Demasiadas solicitudes: inténtalo de nuevo más tarde |
500 | Error inesperado |
501 | No implementado |
503 | Servicio no disponible temporalmente: inténtalo de nuevo más tarde |