FieldPulse | ElevenLabs Documentation

Mit den folgenden Webhook-Tools kann Ihre Rezeption Anrufende erkennen, die bereits in FieldPulse sind, neue Anrufende als Leads hinzufügen und beim Kunden einen Kommentar mit deren Anliegen hinterlassen, damit Ihr Team nachfassen kann.

Bevor Sie beginnen

FieldPulse stellt API-Schlüssel auf Anfrage aus. Kontaktieren Sie den FieldPulse-Support unter support@fieldpulse.com oder über den In-App-Chat und bitten Sie um einen API-Schlüssel. Jedes Tool unten sendet ihn im Request-Header x-api-key.

Der API-Schlüssel kann Ihre FieldPulse-Daten lesen und ändern. Bewahren Sie ihn sicher auf und teilen Sie ihn nicht.

Tools erstellen

Gehen Sie für jedes Tool zu Integrations, wählen Sie Add integration, dann Webhook Tool, und setzen Sie Assign to agents auf Receptionist.

Anrufende finden

Feld	Wert
Name	`find_fieldpulse_customer`
Beschreibung	”Sucht anhand des Namens oder der Telefonnummer nach dem Anrufenden in unserer Kundenliste. Verwenden Sie es zu Beginn eines Anrufs wegen eines Auftrags.”
Methode	GET
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`
Request-Header	`x-api-key`: Ihr API-Schlüssel
Abfrageparameter	`search` (string, erforderlich): “Vollständiger Name oder Telefonnummer des Anrufenden.”

Neuen Kunden hinzufügen

Feld	Wert
Name	`create_fieldpulse_customer`
Beschreibung	”Fügt den Anrufenden als neuen Kunden hinzu, wenn `find_fieldpulse_customer` ihn nicht gefunden hat.”
Methode	POST
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`
Request-Header	`x-api-key`: Ihr API-Schlüssel
Body-Parameter	`first_name` (string, erforderlich): “Vorname des Anrufenden.” `last_name` (string, erforderlich): “Nachname des Anrufenden.” `phone` (string, erforderlich): “Telefonnummer des Anrufenden einschließlich Vorwahl.” `email` (string): “E-Mail-Adresse des Anrufenden, falls angegeben.” `status` (string, erforderlich): “Immer der exakte Wert `lead`.” `service_address_1` (string): “Straßenadresse, an der der Auftrag benötigt wird.” `service_address_city` (string): “Ort dieser Adresse.” `service_address_state` (string): “Bundesland.” `service_address_zip_code` (string): “Postleitzahl.”

Anrufdetails protokollieren

Feld	Wert
Name	`add_fieldpulse_comment`
Beschreibung	”Hinterlässt auf dem Kundendatensatz des Anrufenden einen Kommentar zu seinem Anliegen. Verwenden Sie es, sobald Sie die Kunden-ID haben.”
Methode	POST
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments`
Request-Header	`x-api-key`: Ihr API-Schlüssel
Body-Parameter	`commentable_type` (string, erforderlich): “Immer der exakte Wert `customer`.” `commentable_id` (number, erforderlich): “ID des Kunden aus `find_fieldpulse_customer` oder `create_fieldpulse_customer`.” `text` (string, erforderlich): “Anliegen des Anrufenden, seine Verfügbarkeit und wie er erreichbar ist.”

Wählen Sie bei jedem Tool Enable und testen Sie Ihre Rezeption als neuer Anrufer, der eine Reparatur benötigt. Der Kunde erscheint in FieldPulse als Lead mit dem Kommentar Ihrer Rezeption.

Fügen Sie eine Prozedur für neue Aufträge hinzu: Finden Sie den Anrufenden, fügen Sie ihn hinzu, wenn er nicht gefunden wird, und protokollieren Sie dann die Anrufdetails.

Einschränkungen

Aufträge benötigen einen Auftragstyp, einen Status und Abrechnungsdetails aus Ihrem FieldPulse-Konto. Daher erstellt Ihre Rezeption sie nicht. Ihr Team wandelt den Lead in einen Auftrag um.
Ihre Rezeption kann die Verfügbarkeit von Technikern nicht prüfen oder einen Termin buchen.
Webhook-Tools können keine Listen senden. Daher können diese Tools keine Tags oder benutzerdefinierten Felder zu einem Kunden hinzufügen.

Fehlerbehebung

Problem	Prüfen
401 von FieldPulse	Der Header muss `x-api-key` heißen und einen aktuellen Schlüssel enthalten.
400 von FieldPulse	Lesen Sie die Fehlerliste in der Antwort. `status` muss exakt `lead` sein und Telefonnummern müssen gültig sein.
Bekannte Anrufende werden nicht gefunden	FieldPulse gleicht gespeicherte Werte ab. Versuchen Sie es mit dem Namen und der Telefonnummer des Anrufenden.
Der Kommentar wird nicht hinzugefügt	`commentable_id` muss die ID eines bestehenden Kunden sein. Prüfen Sie, ob das Such- oder Erstellungstool zuerst ausgeführt wurde.
429 von FieldPulse	Sie haben das Anfrage-Limit von FieldPulse erreicht. Warten Sie und versuchen Sie es erneut.