> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Trello

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](/docs/it/reception-ai/integrations/webhooks) crea la scheda tramite l'API REST di Trello.

## Prima di iniziare

### Ottieni una chiave API

Vai al [portale di amministrazione Power-Up](https://trello.com/apps/admin), 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.

> **Note**
>
> 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](/docs/it/reception-ai/receptionist/testing) 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.                                                                        |