> 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.

# Workiz

La tua receptionist può aggiungere un chiamante a Workiz come nuovo lead, con i suoi dati di contatto, l'indirizzo del servizio e ciò di cui ha bisogno, così il tuo team può ricontattarlo e programmare il lavoro. L'API di Workiz richiede che il suo segreto sia nel body della richiesta, dove gli strumenti webhook lo esporrebbero all'IA, quindi Reception si collega tramite [Zapier](/docs/it/reception-ai/integrations/zapier).

L'app Workiz di Zapier può creare lead e lavori, ma non può cercare clienti né controllare la tua agenda.

## Prima di iniziare

Zapier si collega a Workiz tramite il tuo token API e il tuo secret API, che richiedono l'add-on Developer API:

1. In Workiz, seleziona **Feature Center** nella barra di navigazione.
2. In **Add-ons**, seleziona **Developer API** e attiva l'interruttore.
3. Apri la pagina **Developer** e copia il token API e il secret API. Zapier richiede entrambi quando colleghi Workiz.

Se non riesci a vedere **Feature Center** o la pagina **Developer**, chiedi all'amministratore dell'account di attivare l'autorizzazione **Account Settings** per il tuo tipo di utente in **Roles & Permissions**.

> **Warning**
>
> Il token API e il secret consentono di accedere al tuo account Workiz. Conservali in modo sicuro e non condividerli.

## Configurazione

### Collega Zapier

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

### Aggiungi l'azione Workiz

Nel tuo server MCP Zapier su [mcp.zapier.com](https://mcp.zapier.com), aggiungi l'azione Workiz **Create Lead** e collega il tuo account. I campi di Zapier non sono nello stesso ordine della pagina **Developer** di Workiz, quindi incolla il token e il secret nei campi corrispondenti.

| Campo                       | Valore                                                                                                                                                                              |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Azione Zapier**           | **Create Lead**                                                                                                                                                                     |
| **Imposta in Zapier**       | La fonte del lavoro, ad esempio `Reception`. Deve esistere già come fonte pubblicitaria in Workiz.                                                                                  |
| **Lascia compilare all'IA** | Nome e cognome, telefono, email, indirizzo del servizio e note sul lead: di cosa ha bisogno il chiamante, quando è disponibile e qualsiasi altra informazione che ti ha comunicato. |
| **Assegna a**               | **Client**                                                                                                                                                                          |

### Assegna lo strumento

In Reception.ai, apri la scheda **Tools** dell'integrazione Zapier, seleziona **Refresh tools** e assegna **Create Lead** al **Client** (receptionist).

### Provalo

[Metti alla prova la tua receptionist](/docs/it/reception-ai/receptionist/testing) come un nuovo chiamante che necessita di una riparazione. Il lead viene visualizzato in Workiz con la tua fonte del lavoro.

> **Tip**
>
> Aggiungi una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) che indichi alla tua receptionist
> di chiedere l'indirizzo completo, incluso il CAP, e un numero di telefono di 10 cifre prima di creare il
> lead.

## Limitazioni

* La tua receptionist non può trovare i clienti esistenti, quindi un chiamante abituale può essere aggiunto come nuovo lead. Filtra per fonte del lavoro in Workiz per esaminare i nuovi lead.
* L'app Workiz di Zapier non può controllare la tua agenda. **Create Job** programma un lavoro in un orario prestabilito e richiede un tipo di lavoro, quindi lascia che se ne occupi il tuo team, a meno che tu non voglia inserire direttamente nel calendario gli orari preferiti dai chiamanti.
* Ogni azione eseguita dalla tua receptionist utilizza task del tuo piano Zapier. Attualmente Zapier conta due task per ogni chiamata riuscita; le chiamate non riuscite non vengono conteggiate. Quando il piano termina, l'azione si interrompe fino al suo ripristino.

## Risoluzione dei problemi

| Problema                                               | Cosa verificare                                                                                                                               |
| ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Create Lead** non viene visualizzato in Reception.ai | Seleziona **Refresh tools** nell'integrazione Zapier dopo aver aggiunto l'azione in Zapier.                                                   |
| L'azione mostra **Changed** e non viene utilizzata     | L'hai modificata in Zapier. Seleziona **Update** nella scheda **Tools**.                                                                      |
| Zapier indica che l'autenticazione non è riuscita      | Il token e il secret potrebbero essere nei campi sbagliati o non essere più validi. Copiali di nuovo dalla pagina **Developer**.              |
| Errore di convalida dei campi da Workiz                | La fonte del lavoro deve corrispondere esattamente a una fonte pubblicitaria in Workiz. I numeri di telefono devono avere 10 cifre e i CAP 5. |