Wat je kunt vragen

Is er een assistent gekoppeld, dan vraag je in je eigen woorden wat je wilt. De voorbeelden hieronder laten per onderdeel van plnnrly zien wat hij kan. Naast elke vraag staat de operatie die de assistent aanroept, met een link naar de pagina in de API-referentie (in het Engels). Zo zie je precies wat er gebeurt.

De assistent werkt namens jou, dus hij kan alleen wat je rol toestaat.

Mijn werk

Je vraagt	De assistent gebruikt
"Welke werkitems zijn aan mij toegewezen en nog niet klaar?"	GET /work-items met `filter[assignee_id]=me` en `filter[resolved]=false`
"Plaats een reactie bij ACM-12: we wachten nog op de teksten van de klant."	POST /work-items/{work_item}/comments, met `ACM-12` als werkitem
"Zet ACM-12 op Done."	POST /work-items/{work_item}/actions/transition, nadat hij de status Done heeft opgezocht met GET /workflow-statuses. Alleen als je organisatie sprints gebruikt, want de workflowstatussen horen bij sprints.

Tijd

Je vraagt	De assistent gebruikt
"Schrijf voor gisteren anderhalf uur op het project Website: review van het ontwerp."	POST /worklogs met `minutes: 90`, nadat hij het project heeft gevonden met GET /projects
"Hoeveel uur heb ik deze week geschreven?"	GET /worklogs met een periode. Je krijgt je eigen uren, tenzij je iemand anders noemt.
"Start een timer op ACM-12."	POST /timers met `timeable_type: work_item`, nadat hij ACM-12 heeft gelezen met GET /work-items/{work_item} om de id te krijgen

Planning

Je vraagt	De assistent gebruikt
"Wat staat er volgende week in mijn agenda?"	GET /events met `filter[start][gte]` en `filter[start][lte]`. Je krijgt je eigen afspraken.
"Zet donderdag van 14:00 tot 15:00 een review van ACM-12 in mijn agenda."	POST /events

Verlof

Je vraagt	De assistent gebruikt
"Wie is er volgende week afwezig?"	GET /absences met `filter[start]` en `filter[end]`
"Op welke dagen zijn we de rest van dit jaar gesloten?"	GET /free-days met `filter[date][gte]`

Voor afwezigheden heb je het recht Afwezigheden beheren nodig, en voor vrije dagen Bedrijfsbrede vrije dagen beheren.

Drive

Je vraagt	De assistent gebruikt
"Voeg deze vergadernotities toe aan het document Kick-off Acme."	PATCH /drive-documents/{drive_document} met `mode: append`, nadat hij het document heeft gevonden met GET /drive-items
"Vat het document Kick-off Acme samen."	GET /drive-documents/{drive_document}

Met mode: append komen de notities na de bestaande tekst, en verandert er niets aan wat er al stond.

Klanten

Je vraagt	De assistent gebruikt
"Wie zijn de contactpersonen bij Acme?"	GET /customers om Acme te vinden, daarna GET /contacts gefilterd op die klant
"Welke projecten doen we voor Acme?"	GET /projects met `filter[customer_id]`

Facturatie

Alleen als je organisatie facturatie gebruikt.

Je vraagt	De assistent gebruikt
"Welke verkoopfacturen voor Acme zijn nog concept?"	GET /sales-invoices met `filter[status]=draft` en `filter[customer_id]`

Sprints

Alleen als je projecten met sprints werken.

Je vraagt	De assistent gebruikt
"Start de volgende sprint van het project Website."	POST /sprints/{sprint}/actions/start, nadat hij de sprint heeft gevonden met GET /sprints
"Wat staat er nog open in de huidige sprint?"	GET /work-items met `filter[sprint_id]` en `filter[resolved]=false`

Tips

Gebruik de sleutel van een werkitem, zoals ACM-12. De assistent kan die in paden voor werkitems gebruiken, en zoekt zelf het nummer op waar hij dat nodig heeft.
Zeg "mij" of "mijn". De assistent kan dan op jou filteren zonder je naam op te zoeken.
Noem het project of de klant, zodat de assistent niet hoeft te raden.
Vraag de assistent om te laten zien wat hij gaat wijzigen, voordat hij iets schrijft.
Vraag bij lange lijsten om minder rijen of om een samenvatting. Antwoorden hebben een maximale grootte, en de assistent hoort het als een lijst is ingekort.

Wat hij niet doet

Bestanden uploaden, zoals bijlagen of Drive-bestanden.
Iets verwijderen zonder jouw bevestiging en zonder toestemming van je organisatie.
Iets doen wat je rol in plnnrly niet toestaat.

Rechten en veiligheid legt uit hoe dit werkt.