> 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. # FieldPulse Con gli [strumenti webhook](/docs/it/reception-ai/integrations/webhooks) qui sotto, la tua receptionist può riconoscere i chiamanti già presenti in FieldPulse, aggiungere i nuovi chiamanti come lead e lasciare un commento sul cliente con ciò di cui hanno bisogno, così il tuo team può ricontattarli. ## Prima di iniziare FieldPulse rilascia le chiavi API su richiesta. Contatta l'assistenza FieldPulse all'indirizzo [support@fieldpulse.com](mailto:support@fieldpulse.com) o tramite la chat nell'app e richiedi una chiave API. Ogni strumento qui sotto la invia nell'header della richiesta `x-api-key`. > **Warning** > > La chiave API può leggere e modificare i tuoi dati FieldPulse. Conservala in modo sicuro e non condividerla. ## Crea gli strumenti Per ogni strumento, vai su **Integrazioni**, seleziona **Aggiungi integrazione**, scegli **Strumento webhook** e imposta **Assegna agli agenti** su **Receptionist**. ### Trova un chiamante | Campo | Valore | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `find_fieldpulse_customer` | | **Descrizione** | "Trova il chiamante nel nostro elenco clienti in base al nome o al numero di telefono. Usalo all'inizio di una chiamata relativa a un lavoro." | | **Metodo** | GET | | **URL** | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers` | | **Header della richiesta** | `x-api-key`: la tua chiave API | | **Parametri query** | `search` (stringa, obbligatorio): "Il nome completo o il numero di telefono del chiamante." | ### Aggiungi un nuovo cliente | Campo | Valore | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Nome** | `create_fieldpulse_customer` | | **Descrizione** | "Aggiungi il chiamante come nuovo cliente quando `find_fieldpulse_customer` non lo trova." | | **Metodo** | POST | | **URL** | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers` | | **Header della richiesta** | `x-api-key`: la tua chiave API | | **Parametri body** | `first_name` (stringa, obbligatorio): "Il nome del chiamante." `last_name` (stringa, obbligatorio): "Il cognome del chiamante." `phone` (stringa, obbligatorio): "Il numero di telefono del chiamante, incluso il prefisso." `email` (stringa): "L'indirizzo email del chiamante, se lo ha fornito." `status` (stringa, obbligatorio): "Sempre l'esatto valore `lead`." `service_address_1` (stringa): "L'indirizzo dove è necessario il lavoro." `service_address_city` (stringa): "La città di quell'indirizzo." `service_address_state` (stringa): "Lo stato." `service_address_zip_code` (stringa): "Il codice postale." | ### Registra i dettagli della chiamata | Campo | Valore | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `add_fieldpulse_comment` | | **Descrizione** | "Lascia un commento nel record cliente del chiamante con ciò di cui ha bisogno. Usalo quando hai il suo ID cliente." | | **Metodo** | POST | | **URL** | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments` | | **Header della richiesta** | `x-api-key`: la tua chiave API | | **Parametri body** | `commentable_type` (stringa, obbligatorio): "Sempre l'esatto valore `customer`." `commentable_id` (numero, obbligatorio): "L'ID del cliente, da `find_fieldpulse_customer` o `create_fieldpulse_customer`." `text` (stringa, obbligatorio): "Di cosa ha bisogno il chiamante, quando è disponibile e come contattarlo." | Seleziona **Abilita** su ogni strumento, poi [testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) fingendo di essere un nuovo chiamante che necessita di una riparazione. Il cliente appare in FieldPulse come lead, con il commento della tua receptionist. > **Tip** > > Aggiungi una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) per i nuovi lavori: trova il > chiamante, aggiungilo se non viene trovato, quindi registra i dettagli della chiamata. ## Limitazioni * I lavori richiedono un tipo di lavoro, uno stato e dettagli di fatturazione dal tuo account FieldPulse, quindi la tua receptionist non li crea. Il tuo team trasforma il lead in un lavoro. * La tua receptionist non può verificare la disponibilità dei tecnici né fissare un appuntamento. * Gli strumenti webhook non possono inviare elenchi, quindi non possono aggiungere tag o campi personalizzati a un cliente. ## Risoluzione dei problemi | Problema | Cosa verificare | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | | 401 da FieldPulse | L'header deve chiamarsi `x-api-key` e contenere una chiave attuale. | | 400 da FieldPulse | Leggi l'elenco degli errori nella risposta. `status` deve essere esattamente `lead` e i numeri di telefono devono essere validi. | | I chiamanti noti non vengono trovati | FieldPulse confronta i dati memorizzati. Prova il nome del chiamante oltre al suo numero di telefono. | | Il commento non viene aggiunto | `commentable_id` deve essere l'ID di un cliente esistente. Verifica che lo strumento di ricerca o creazione sia stato eseguito prima. | | 429 da FieldPulse | Hai raggiunto il limite di richieste di FieldPulse. Attendi e riprova. |