Vai alla navigazione

Asana

Crea attività Asana dalle chiamate e controlla le attività aperte di un progetto.

Il tuo receptionist può trasformare la richiesta di chi chiama in un’attività Asana per il tuo team e informarlo sullo stato di un lavoro. Entrambe le funzioni usano gli strumenti webhook, che chiamano direttamente l’API di Asana. In alternativa, puoi creare attività tramite Zapier. Consigliamo gli strumenti webhook: non richiedono un account Zapier né usano le tue attività Zapier, e ogni richiesta viene inviata direttamente ad Asana.

Prima di iniziare

1

Crea un token di accesso personale

In Asana, apri Le mie impostazioni → App → Gestisci app per sviluppatori e crea un token di accesso personale. Il token può visualizzare e modificare tutto ciò che puoi visualizzare e modificare tu, quindi valuta di crearlo da un account che ha accesso solo al progetto.

2

Trova l’ID del progetto

Apri il progetto nel browser. Il lungo numero dopo /project/ nell’URL è l’ID del progetto.

3

Trova gli ID del workspace e della sezione

Per creare attività con uno strumento webhook, ti servono anche l’ID del workspace in cui si trova il progetto e quello della sezione in cui vengono inserite le nuove attività. Esegui questi comandi in un terminale, sostituendo YOUR_TOKEN e PROJECT_ID:

curl -H "Authorization: Bearer YOUR_TOKEN" "https://app.asana.com/api/1.0/projects/PROJECT_ID?opt_fields=workspace"
curl -H "Authorization: Bearer YOUR_TOKEN" https://app.asana.com/api/1.0/projects/PROJECT_ID/sections

Dal primo, copia il gid in workspace. Dal secondo, copia il gid della sezione desiderata, ad esempio quella denominata To do.

Crea attività con uno strumento webhook (consigliato)

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

CampoValore
Nomecreate_asana_task
Descrizione”Crea un’attività per il team ogni volta che prometti a chi chiama un follow-up o quando chiede qualcosa che il team deve gestire.”
MetodoPOST
URLhttps://app.asana.com/api/1.0/tasks
Header della richiestaAuthorization (Secret): Bearer seguito dal tuo token
Parametri del bodydata (oggetto, obbligatorio), con i campi riportati sotto
Assegna agli agentiReceptionist

Asana si aspetta i campi dell’attività all’interno di un oggetto data. Seleziona Aggiungi campo in data per ciascuno dei seguenti elementi:

  • name (stringa, obbligatorio, dalla conversazione): “Titolo breve con il nome di chi chiama e ciò di cui ha bisogno, ad esempio: Richiama Jane Doe per un preventivo.”
  • notes (stringa, obbligatorio, dalla conversazione): “Il nome e il numero di telefono di chi chiama, nonché i dettagli della sua richiesta.”
  • due_on (stringa, dalla conversazione): “La data entro cui chi chiama ne ha bisogno, nel formato AAAA-MM-GG. Omettilo se non ha fornito una data.”
  • workspace (stringa, valore fisso): l’ID del tuo workspace
  • memberships (array, obbligatorio, dalla conversazione): “Sempre esattamente un elemento.” In Ogni elemento, scegli object e aggiungi due campi:
    • project (stringa, valore fisso): l’ID del tuo progetto
    • section (stringa, valore fisso): l’ID della tua sezione

Il workspace, il progetto e la sezione sono valori fissi, quindi ogni attività viene inserita nella tua sezione anche se l’IA invia altri ID. Asana richiede un workspace, un progetto o un’attività principale per ogni nuova attività; il valore fisso workspace soddisfa questo requisito e memberships inserisce l’attività nel tuo progetto e nella tua sezione. Per assegnare ogni nuova attività alla stessa persona, aggiungi un campo assignee all’interno di data (stringa, valore fisso) impostato sul suo indirizzo email.

Seleziona Abilita, poi testa il tuo receptionist chiedendo di essere richiamato. L’attività viene visualizzata nella sezione.

Crea attività con Zapier

1

Collega Zapier

Se non l’hai ancora fatto, collega Zapier in Reception.ai.

2

Aggiungi l’azione Asana

Nel tuo server MCP Zapier, aggiungi l’azione Asana Crea attività e collega il tuo account Asana. Imposta il workspace e il progetto come valori fissi e lascia che l’IA compili il nome dell’attività, le note e la data di scadenza.

3

Assegna lo strumento

In Reception.ai, apri la scheda Strumenti dell’integrazione Zapier, seleziona Aggiorna strumenti e assegna l’azione Asana al Client (receptionist).

4

Provalo

Testa il tuo receptionist chiedendo di essere richiamato. L’attività viene visualizzata nel progetto.

Controlla le attività aperte di un progetto

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

CampoValore
Nomelist_open_jobs
Descrizione”Elenca i lavori aperti nel nostro progetto. Usalo quando chi chiama chiede informazioni sullo stato del suo lavoro.”
MetodoGET
URLhttps://app.asana.com/api/1.0/projects/PROJECT_ID/tasks
Header della richiestaAuthorization (Secret): Bearer seguito dal tuo token
Parametri querycompleted_since (stringa, valore fisso): now
opt_fields (stringa, valore fisso): name,due_on,assignee.name
Assegna agli agentiReceptionist

Seleziona Abilita.

completed_since=now fa sì che Asana restituisca solo le attività incomplete. Assegna alle attività il nome del cliente, così il tuo receptionist potrà trovare l’attività di chi chiama nell’elenco.

L’elenco include tutte le attività aperte nel progetto, compresi i lavori di altri clienti. Indica al tuo receptionist nelle istruzioni di condividere solo l’attività che corrisponde a chi chiama e di non leggere mai le altre attività.

Risoluzione dei problemi

ProblemaCosa controllare
L’azione Asana non viene visualizzata in Reception.aiSeleziona Aggiorna strumenti nell’integrazione Zapier dopo aver aggiunto azioni in Zapier.
401 da AsanaL’header deve essere Bearer seguito da un token attuale.
400 durante la creazione di un’attivitàVerifica che name, notes, workspace e memberships siano campi all’interno di data e che la sezione appartenga al progetto.
L’attività viene creata ma non è nel progettoControlla gli ID del progetto e della sezione in memberships. Se le attività continuano a essere inserite fuori dal progetto, usa invece l’opzione Zapier.
404 nell’elenco delle attivitàControlla l’ID del progetto e che l’account associato al token possa visualizzare il progetto.
Asana indica che il risultato è troppo grandeI progetti molto grandi richiedono la paginazione, che lo strumento non supporta. Limita il progetto ai lavori attivi.