Skip to navigation

Todoist

Zet verzoeken van bellers om in Todoist-taken met een webhooktool.

Je receptionist kan een taak toevoegen aan Todoist wanneer een beller om een terugbelverzoek, een offerte of iets anders vraagt waarop je moet terugkomen. Een webhooktool maakt de taak via de API van Todoist.

Voordat je begint

1

Kopieer je API-token

Open in Todoist Settings → Integrations → Developer en kopieer je API token. Hiermee krijg je volledige toegang tot je Todoist-account, dus houd het geheim.

2

Zoek de project-ID

Open het project in de Todoist-webapp. De ID is het laatste deel van de URL, na het laatste streepje: in app.todoist.com/app/project/callbacks-6Jf8VQXxpwv56VQ7 is dat 6Jf8VQXxpwv56VQ7. Sla dit over om taken aan je Inbox toe te voegen.

Maak de webhooktool

Ga naar Integrations, selecteer Add integration en kies Webhook Tool.

VeldWaarde
Naamcreate_todoist_task
Beschrijving”Maak een taak voor het team wanneer je de beller een follow-up belooft, of wanneer de beller om iets vraagt dat het team moet afhandelen.”
MethodePOST
URLhttps://api.todoist.com/api/v1/tasks
RequestheadersAuthorization: Bearer gevolgd door je API-token
Bodyparameterscontent (string, vereist): “Korte titel met de naam van de beller en wat diegene nodig heeft, bijvoorbeeld: Bel Jane Doe terug over een offerte.”
description (string, vereist): “De naam en het telefoonnummer van de beller, en de details van het verzoek.”
due_string (string): “Wanneer je moet opvolgen, in gewone taal, bijvoorbeeld: morgen om 10.00 uur. Laat dit weg als de beller niets heeft gezegd.”
project_id (string, vereist): “Altijd de exacte waarde PROJECT_ID.”
Toewijzen aan agentsReceptionist

Vervang PROJECT_ID door je project-ID of verwijder project_id om taken aan je Inbox toe te voegen.

Selecteer Enable en test je receptionist door om een terugbelverzoek voor morgen te vragen. De taak verschijnt in het project met een vervaldatum.

Problemen oplossen

ProbleemWat je moet controleren
Todoist geeft 401 terugDe headerwaarde moet Bearer gevolgd door het token zijn. Kopieer het opnieuw als je het hebt gereset.
Todoist geeft 400 of 404 terugControleer de project-ID en of de URL https://api.todoist.com/api/v1/tasks is. Oudere handleidingen gebruiken het eerdere adres /rest/v2/.
Taken hebben de verkeerde vervaldatumTodoist leest due_string in de tijdzone van je account. Controleer dit onder Settings → General.
De receptionist maakt nooit takenZorg dat de beschrijving van de tool de situaties noemt waarin deze een taak moet maken.