Vai alla navigazione

ClickUp

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

Il tuo receptionist può creare un’attività ClickUp per il tuo team quando chi chiama richiede di essere ricontattato, un preventivo o qualsiasi altra cosa che richieda un follow-up. Uno strumento webhook aggiunge l’attività a un elenco.

Prima di iniziare

1

Crea un token API personale

In ClickUp, seleziona il tuo avatar, apri Settings → Apps e, in API Token, seleziona Generate. Il token inizia con pk_. Agisce per tuo conto e non scade mai, quindi trattalo come un segreto. Valuta di generarlo da un account che abbia accesso solo all’elenco.

2

Trova l’ID dell’elenco

Apri l’elenco nel browser. Il numero dopo /li/ nell’URL è l’ID dell’elenco.

Crea lo strumento webhook

Vai a Integrations, seleziona Add integration e scegli Webhook Tool.

CampoValore
Nomecreate_clickup_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.clickup.com/api/v2/list/LIST_ID/task
Header della richiestaAuthorization: il tuo token, senza Bearer davanti
Parametri del bodyname (stringa, obbligatorio): “Titolo breve con il nome di chi chiama e ciò di cui ha bisogno, ad esempio: Ricontatta Jane Doe per un preventivo.”
description (stringa, obbligatorio): “Il nome, il numero di telefono e i dettagli della richiesta di chi chiama.”
priority (numero): “1 per urgente, 2 per alta, 3 per normale, 4 per bassa. Usa 1 solo per le emergenze.”
Assegna agli agentiReceptionist

Seleziona Enable, poi testa il tuo receptionist chiedendo di essere ricontattato. L’attività apparirà nell’elenco.

Lo strumento non include date di scadenza e assegnatari. ClickUp accetta le date di scadenza come timestamp Unix in millisecondi, che il tuo receptionist non può calcolare in modo affidabile durante una chiamata, e gli assegnatari come elenco di ID utente, che gli strumenti webhook non possono inviare. Usa un’automazione ClickUp sull’elenco per assegnare le nuove attività e impostare una data di scadenza, oppure instrada l’attività tramite Zapier.

Risoluzione dei problemi

ProblemaCosa controllare
ClickUp restituisce 401L’header deve essere Authorization con il solo token pk_, senza Bearer.
ClickUp restituisce 404 o un errore dell’elencoControlla l’ID dell’elenco nell’URL e che l’utente associato al token possa vedere l’elenco.
L’attività non ha prioritàLa priorità deve essere un numero da 1 a 4. Omettila se la richiesta di chi chiama non è urgente.
Il receptionist non crea mai attivitàAssicurati che la descrizione dello strumento indichi le situazioni in cui deve crearne una.