> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Xero

La tua receptionist può verificare se un chiamante è già un contatto nella tua organizzazione Xero e aggiungere i nuovi chiamanti come contatti, così saranno pronti quando invierai un preventivo o una fattura. L'API di Xero accetta solo token di accesso OAuth che scadono ogni 30 minuti, quindi gli strumenti webhook non possono connettersi direttamente. Reception si connette tramite [Zapier](/docs/it/reception-ai/integrations/zapier).

> **Warning**
>
> Xero contiene i tuoi dati finanziari. Non aggiungere azioni che creano o inviano fatture, conti,
> pagamenti o note di credito. Un chiamante potrebbe indurre la receptionist a usare l'importo o il
> destinatario sbagliato. Crea tu stesso le fatture in Xero.

## Configurazione

### Connetti Zapier

Se non l'hai ancora fatto, connetti [Zapier](/docs/it/reception-ai/integrations/zapier) in Reception.ai.

### Aggiungi le azioni Xero

Nel tuo server MCP Zapier su [mcp.zapier.com](https://mcp.zapier.com), aggiungi le [azioni seguenti](#actions) dall'app **Xero** e accedi a Xero quando Zapier lo richiede. Per ogni campo, imposta un valore fisso oppure lascia che lo compili l'IA, come indicato.

Le azioni possono fare tutto ciò che può fare l'utente Xero con cui accedi. Valuta di usare un utente dedicato con il ruolo minimo necessario per gestire i contatti.

### Assegna gli strumenti

In Reception.ai, apri la scheda **Tools** dell'integrazione Zapier, seleziona **Refresh tools** e assegna ogni azione a **Client** (receptionist).

### Provala

[Metti alla prova la tua receptionist](/docs/it/reception-ai/receptionist/testing) come un cliente esistente che comunica il nome della propria azienda, poi come un nuovo chiamante. Il nuovo contatto appare in **Contacts** in Xero.

## Azioni

### Trova il chiamante

| Campo                       | Valore                                                                            |
| --------------------------- | --------------------------------------------------------------------------------- |
| **Azione Zapier**           | **Find Contact**                                                                  |
| **Imposta in Zapier**       | **Organization**: la tua organizzazione Xero. Cerca in base al nome del contatto. |
| **Lascia compilare all'IA** | Il nome del contatto: il nome dell'azienda del chiamante o il suo nome completo.  |
| **Assegna a**               | **Client**                                                                        |

Xero trova i contatti in base al nome o al numero di conto, non al numero di telefono, quindi la receptionist deve chiedere il nome a cui è intestato l'account.

### Aggiungi il chiamante

| Campo                       | Valore                                                                                                                                               |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Azione Zapier**           | **Find or Create Contact**                                                                                                                           |
| **Imposta in Zapier**       | **Organization** e ricerca in base al nome del contatto. Lascia vuoti i codici conto, il numero fiscale, il conto bancario e i termini di pagamento. |
| **Lascia compilare all'IA** | **Contact Name**, nome, cognome ed email della persona principale, numero di telefono e indirizzo.                                                   |
| **Assegna a**               | **Client**                                                                                                                                           |

Usa **Find or Create Contact**, non **Create/Update Contact**. **Create/Update Contact** modifica un contatto già esistente, quindi un chiamante che fornisce il nome di un altro cliente potrebbe sovrascriverne il numero di telefono o l'email.

> **Tip**
>
> Aggiungi una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) affinché la receptionist chieda
> il nome dell'azienda del chiamante e lo cerchi prima di aggiungere un contatto.

> **Warning**
>
> **Find Contact** restituisce tutto ciò che è salvato nel contatto. Aggiungi una
> [regola](/docs/it/reception-ai/receptionist/rules-and-procedures) che dica alla receptionist di non
> leggere mai al chiamante i dettagli, i saldi o le fatture di un contatto e di usarli solo per
> riconoscere il chiamante.

## Limitazioni

* La receptionist non può cercare i chiamanti in base al numero di telefono. Ha bisogno del nome esatto con cui il contatto è salvato in Xero.
* La receptionist non può creare fatture o preventivi. Raccogli i dettagli durante la chiamata e crea tu stesso la fattura a partire dal contatto.
* Ogni azione eseguita dalla receptionist usa attività del tuo piano Zapier. Al momento Zapier conta due attività per ogni chiamata riuscita; le chiamate non riuscite non vengono conteggiate. Quando il piano si esaurisce, le azioni si interrompono fino al ripristino.

## Risoluzione dei problemi

| Problema                                           | Cosa verificare                                                                                                         |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Un'azione Xero non appare in Reception.ai          | Seleziona **Refresh tools** nell'integrazione Zapier dopo aver aggiunto le azioni in Zapier.                            |
| Un'azione mostra **Changed** e non viene usata     | L'hai modificata in Zapier. Seleziona **Update** nella scheda **Tools**.                                                |
| I chiamanti conosciuti non vengono trovati         | Xero abbina il nome del contatto così come è salvato. Chiedi al chiamante il nome dell'azienda riportato sulle fatture. |
| I contatti finiscono nell'organizzazione sbagliata | Imposta **Organization** come valore fisso in Zapier.                                                                   |
| Zapier smette di connettersi a Xero                | Riconnetti il tuo account Xero in Zapier. Xero interrompe le connessioni non usate per molto tempo.                     |