Trello | ElevenLabs Documentation

La tua receptionist può aggiungere una scheda a una lista Trello quando chi chiama richiede di essere richiamato, un preventivo o qualsiasi altra cosa su cui il tuo team debba fare follow-up. Uno strumento webhook crea la scheda tramite l’API REST di Trello.

Prima di iniziare

Ottieni una chiave API

Vai al portale di amministrazione Power-Up, crea un Power-Up per il tuo workspace (il nome non è importante), apri la relativa scheda Trello Auth e seleziona Generate a new API key.

Genera un token

Seleziona il link Token accanto alla tua chiave API oppure apri questo URL in un browser sostituendo API_KEY con la tua chiave API:

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Reception&key=API_KEY

Seleziona Allow e copia il token. Può leggere e modificare tutte le bacheche a cui hai accesso, quindi valuta di generarlo da un account che sia membro soltanto della bacheca che ti serve.

Trova l’ID della lista

Apri la bacheca nel browser, aggiungi .json alla fine del suo URL e carica la pagina. Cerca il nome della lista; il valore id accanto a esso è l’ID della lista.

Crea lo strumento webhook

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

Campo	Valore
Nome	`create_trello_card`
Descrizione	”Crea una scheda 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.”
Metodo	POST
URL	`https://api.trello.com/1/cards?idList=LIST_ID`
Header della richiesta	`Authorization`: `OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"`
Parametri del body	`name` (stringa, obbligatorio): “Titolo breve con il nome di chi chiama e ciò di cui ha bisogno, ad esempio: Richiama Jane Doe per un preventivo.” `desc` (stringa, obbligatorio): “Il nome di chi chiama, il numero di telefono e i dettagli della richiesta.”
Assegna agli agenti	Receptionist

Inserisci ?idList=LIST_ID direttamente nel campo URL, sostituendolo con l’ID della tua lista. Non aggiungere idList come parametro query: i parametri query vengono compilati dall’IA, mentre il testo nell’URL viene inviato esattamente come scritto.

Trello accetta anche la chiave e il token nell’URL, come &key=API_KEY&token=TOKEN. Funziona ugualmente, ma l’header evita che siano inclusi nell’URL. Se li inserisci nell’URL, tratta l’intero URL come un segreto.

Seleziona Abilita, poi testa la tua receptionist chiedendo di essere richiamato. La scheda appare in fondo alla lista.

Risoluzione dei problemi

Problema	Cosa controllare
Trello restituisce 401	Controlla l’header: la chiave e il token devono essere entrambi tra virgolette doppie, separati da una virgola e uno spazio. Rigenera il token se è stato revocato.
`invalid value for idList`	L’ID della lista nell’URL non è corretto. Usa l’`id` della lista, non quello della bacheca.
Trello restituisce 404 o nessun accesso	L’utente del token deve essere membro della bacheca.
La receptionist non crea mai schede	Assicurati che la descrizione dello strumento indichi le situazioni in cui deve crearne una.