FieldPulse | ElevenLabs Documentation

Con gli strumenti webhook 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 o tramite la chat nell’app e richiedi una chiave API. Ogni strumento qui sotto la invia nell’header della richiesta x-api-key.

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 fingendo di essere un nuovo chiamante che necessita di una riparazione. Il cliente appare in FieldPulse come lead, con il commento della tua receptionist.

Aggiungi una procedura 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.