> 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 Mit den folgenden [Webhook-Tools](/docs/de/reception-ai/integrations/webhooks) 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](mailto: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`. > **Warning** > > 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](/docs/de/reception-ai/receptionist/testing) als neuer Anrufer, der eine Reparatur benötigt. Der Kunde erscheint in FieldPulse als Lead mit dem Kommentar Ihrer Rezeption. > **Tip** > > Fügen Sie eine [Prozedur](/docs/de/reception-ai/receptionist/rules-and-procedures) 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. |