Vai alla navigazione

Todoist

Trasforma le richieste dei chiamanti in attività Todoist con uno strumento webhook.

La tua receptionist può aggiungere un’attività a Todoist quando chi chiama richiede di essere richiamato, un preventivo o qualsiasi altra cosa su cui fare follow-up. Uno strumento webhook crea l’attività tramite l’API di Todoist.

Prima di iniziare

1

Copia il tuo token API

In Todoist, apri Impostazioni → Integrazioni → Sviluppatore e copia il tuo token API. Consente l’accesso completo al tuo account Todoist, quindi trattalo come un segreto.

2

Trova l’ID del progetto

Apri il progetto nell’app web di Todoist. L’ID è l’ultima parte dell’URL, dopo l’ultimo trattino: in app.todoist.com/app/project/callbacks-6Jf8VQXxpwv56VQ7, è 6Jf8VQXxpwv56VQ7. Salta questo passaggio per aggiungere attività alla tua Posta in arrivo.

Crea lo strumento webhook

Vai a Integrazioni, seleziona Aggiungi integrazione e scegli Strumento webhook.

CampoValore
Nomecreate_todoist_task
Descrizione”Crea un’attività per il team ogni volta che prometti a chi chiama un follow-up o quando chi chiama richiede qualcosa di cui il team deve occuparsi.”
MetodoPOST
URLhttps://api.todoist.com/api/v1/tasks
Header della richiestaAuthorization: Bearer seguito dal tuo token API
Parametri del bodycontent (stringa, obbligatorio): “Titolo breve con il nome di chi chiama e ciò di cui ha bisogno, ad esempio: Richiama Jane Doe per un preventivo.”
description (stringa, obbligatorio): “Il nome di chi chiama, il numero di telefono e i dettagli della richiesta.”
due_string (stringa): “Quando effettuare il follow-up, in linguaggio naturale, ad esempio: domani alle 10:00. Omettilo se chi chiama non lo ha indicato.”
project_id (stringa, obbligatorio): “Sempre il valore esatto PROJECT_ID.”
Assegna agli agentiReceptionist

Sostituisci PROJECT_ID con l’ID del tuo progetto oppure rimuovi project_id per aggiungere attività alla tua Posta in arrivo.

Seleziona Abilita, poi testa la tua receptionist chiedendo di essere richiamato domani. L’attività appare nel progetto con una data di scadenza.

Risoluzione dei problemi

ProblemaCosa controllare
Todoist restituisce 401Il valore dell’header deve essere Bearer seguito dal token. Copialo di nuovo se lo reimposti.
Todoist restituisce 400 o 404Controlla l’ID del progetto e che l’URL sia https://api.todoist.com/api/v1/tasks. Le guide meno recenti usano il precedente indirizzo /rest/v2/.
Le attività hanno la data di scadenza errataTodoist interpreta due_string nel fuso orario del tuo account. Controllalo in Impostazioni → Generali.
La receptionist non crea mai attivitàAssicurati che la descrizione dello strumento indichi le situazioni in cui deve crearne una.