Qué puedes pedir

Una vez conectado un asistente, le pides las cosas con tus propias palabras. Los ejemplos de abajo muestran lo que puede hacer en cada área de plnnrly. Junto a cada pregunta está la operación que llama el asistente, con un enlace a su página en la referencia de la API (en inglés), para que veas exactamente qué ocurre.

El asistente trabaja en tu nombre, así que solo puede hacer lo que permite tu rol.

Mi trabajo

Lo que pides	Lo que usa el asistente
«¿Qué elementos de trabajo tengo asignados que aún no estén terminados?»	GET /work-items con `filter[assignee_id]=me` y `filter[resolved]=false`
«Añade un comentario a ACM-12: esperando los textos del cliente.»	POST /work-items/{work_item}/comments, con `ACM-12` como elemento de trabajo
«Mueve ACM-12 a Hecho.»	POST /work-items/{work_item}/actions/transition, después de buscar el estado Hecho con GET /workflow-statuses. Solo si tu organización usa iteraciones, que son las que traen los estados del flujo de trabajo.

Horas

Lo que pides	Lo que usa el asistente
«Registra una hora y media de ayer en el proyecto Website: revisión del diseño.»	POST /worklogs con `minutes: 90`, después de encontrar el proyecto con GET /projects
«¿Cuántas horas he registrado esta semana?»	GET /worklogs con un intervalo de fechas. Devuelve tus propias horas, salvo que nombres a otra persona.
«Inicia un cronómetro en ACM-12.»	POST /timers con `timeable_type: work_item`, después de leer ACM-12 con GET /work-items/{work_item} para obtener su id

Planificación

Lo que pides	Lo que usa el asistente
«¿Qué tengo en el calendario la semana que viene?»	GET /events con `filter[start][gte]` y `filter[start][lte]`. Devuelve tus propios eventos.
«Ponme una revisión de ACM-12 en el calendario el jueves de 14:00 a 15:00.»	POST /events

Ausencias

Lo que pides	Lo que usa el asistente
«¿Quién está ausente la semana que viene?»	GET /absences con `filter[start]` y `filter[end]`
«¿Qué días cerramos en lo que queda de año?»	GET /free-days con `filter[date][gte]`

Las ausencias necesitan el permiso Gestionar ausencias, y los días libres, Gestionar días libres a nivel de empresa.

Drive

Lo que pides	Lo que usa el asistente
«Añade estas notas de la reunión al documento Kick-off Acme.»	PATCH /drive-documents/{drive_document} con `mode: append`, después de encontrar el documento con GET /drive-items
«Resume el documento Kick-off Acme.»	GET /drive-documents/{drive_document}

Con mode: append, las notas se añaden después del texto existente y no cambia nada de lo que ya había.

Clientes

Lo que pides	Lo que usa el asistente
«¿Quiénes son los contactos de Acme?»	GET /customers para encontrar Acme y después GET /contacts filtrado por ese cliente
«¿Qué proyectos llevamos para Acme?»	GET /projects con `filter[customer_id]`

Facturación

Solo si tu organización usa la facturación.

Lo que pides	Lo que usa el asistente
«¿Qué facturas de venta de Acme siguen en borrador?»	GET /sales-invoices con `filter[status]=draft` y `filter[customer_id]`

Iteraciones

Solo si tus proyectos trabajan con iteraciones.

Lo que pides	Lo que usa el asistente
«Inicia la siguiente iteración del proyecto Website.»	POST /sprints/{sprint}/actions/start, después de encontrar la iteración con GET /sprints
«¿Qué queda pendiente en la iteración actual?»	GET /work-items con `filter[sprint_id]` y `filter[resolved]=false`

Consejos

Usa claves como ACM-12. El asistente puede usarlas en las rutas de los elementos de trabajo, y busca él mismo el número cuando lo necesita.
Habla en primera persona («mis horas», «tengo asignados»). El asistente puede filtrar por ti sin buscar tu nombre.
Nombra el proyecto o el cliente, para que el asistente no tenga que adivinarlo.
Pide al asistente que te enseñe lo que va a cambiar antes de que escriba nada.
Para listas largas, pide menos filas o un resumen. Las respuestas tienen un tamaño máximo, y al asistente se le avisa cuando una lista se ha cortado.

Lo que no hará

Subir archivos, como adjuntos o archivos de Drive.
Eliminar nada sin tu confirmación y el permiso de tu organización.
Nada que tu rol no pueda hacer en plnnrly.

Permisos y seguridad explica cómo funciona.