> 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

Met de onderstaande [webhooktools](/docs/nl/reception-ai/integrations/webhooks) kan je receptionist bellers herkennen die al in FieldPulse staan, nieuwe bellers als leads toevoegen en een opmerking bij de klant achterlaten over wat ze nodig hebben, zodat je team kan opvolgen.

## Voordat je begint

FieldPulse geeft API-sleutels op aanvraag uit. Neem contact op met de support van FieldPulse via [support@fieldpulse.com](mailto:support@fieldpulse.com) of via de chat in de app en vraag om een API-sleutel. Elke onderstaande tool verstuurt deze in de requestheader `x-api-key`.

> **Warning**
>
> De API-sleutel kan je FieldPulse-gegevens lezen en wijzigen. Bewaar deze veilig en deel hem niet.

## Maak de tools

Ga voor elke tool naar **Integrations**, selecteer **Add integration**, kies **Webhook Tool** en stel **Assign to agents** in op **Receptionist**.

### Een beller zoeken

| Veld                | Waarde                                                                                                                |
| ------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Naam**            | `find_fieldpulse_customer`                                                                                            |
| **Beschrijving**    | "Zoek de beller in onze klantenlijst op naam of telefoonnummer. Gebruik dit aan het begin van een gesprek over werk." |
| **Methode**         | GET                                                                                                                   |
| **URL**             | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`                                              |
| **Requestheaders**  | `x-api-key`: je API-sleutel                                                                                           |
| **Queryparameters** | `search` (string, vereist): "De volledige naam of het telefoonnummer van de beller."                                  |

### Een nieuwe klant toevoegen

| Veld               | Waarde                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Naam**           | `create_fieldpulse_customer`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Beschrijving**   | "Voeg de beller als nieuwe klant toe wanneer `find_fieldpulse_customer` deze niet heeft gevonden."                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Methode**        | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **URL**            | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Requestheaders** | `x-api-key`: je API-sleutel                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **Bodyparameters** | `first_name` (string, vereist): "De voornaam van de beller."  `last_name` (string, vereist): "De achternaam van de beller."  `phone` (string, vereist): "Het telefoonnummer van de beller, inclusief netnummer."  `email` (string): "Het e-mailadres van de beller, als die dit heeft gegeven."  `status` (string, vereist): "Altijd exact de waarde `lead`."  `service_address_1` (string): "Het straatadres waar het werk nodig is."  `service_address_city` (string): "De plaats van dat adres."  `service_address_state` (string): "De staat."  `service_address_zip_code` (string): "De postcode." |

### De gespreksgegevens vastleggen

| Veld               | Waarde                                                                                                                                                                                                                                                                                                                |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Naam**           | `add_fieldpulse_comment`                                                                                                                                                                                                                                                                                              |
| **Beschrijving**   | "Laat een opmerking achter in het klantrecord van de beller over wat die nodig heeft. Gebruik dit zodra je de klant-id hebt."                                                                                                                                                                                         |
| **Methode**        | POST                                                                                                                                                                                                                                                                                                                  |
| **URL**            | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments`                                                                                                                                                                                                                                               |
| **Requestheaders** | `x-api-key`: je API-sleutel                                                                                                                                                                                                                                                                                           |
| **Bodyparameters** | `commentable_type` (string, vereist): "Altijd exact de waarde `customer`."  `commentable_id` (number, vereist): "De id van de klant, uit `find_fieldpulse_customer` of `create_fieldpulse_customer`."  `text` (string, vereist): "Wat de beller nodig heeft, wanneer die beschikbaar is en hoe je die kunt bereiken." |

Selecteer **Enable** voor elke tool en [test je receptionist](/docs/nl/reception-ai/receptionist/testing) als een nieuwe beller die een reparatie nodig heeft. De klant verschijnt in FieldPulse als lead, met de opmerking van je receptionist.

> **Tip**
>
> Voeg een [procedure](/docs/nl/reception-ai/receptionist/rules-and-procedures) toe voor nieuw werk: zoek de
> beller, voeg deze toe als die niet wordt gevonden en leg daarna de gespreksgegevens vast.

## Beperkingen

* Vacatures hebben een functietype, een status en factureringsgegevens uit je FieldPulse-account nodig, dus je receptionist maakt ze niet aan. Je team zet de lead om in een vacature.
* Je receptionist kan de beschikbaarheid van technici niet controleren of een tijd boeken.
* Webhooktools kunnen geen lijsten versturen, dus deze tools kunnen geen tags of aangepaste velden aan een klant toevoegen.

## Problemen oplossen

| Probleem                             | Wat je moet controleren                                                                                             |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| 401 van FieldPulse                   | De header moet `x-api-key` heten en een actuele sleutel bevatten.                                                   |
| 400 van FieldPulse                   | Lees de foutenlijst in de response. `status` moet exact `lead` zijn en telefoonnummers moeten geldig zijn.          |
| Bekende bellers worden niet gevonden | FieldPulse vergelijkt met de opgeslagen gegevens. Probeer zowel de naam als het telefoonnummer van de beller.       |
| De opmerking wordt niet toegevoegd   | `commentable_id` moet de id van een bestaande klant zijn. Controleer of de zoek- of maakt-tool eerst is uitgevoerd. |
| 429 van FieldPulse                   | Je hebt de requestlimiet van FieldPulse bereikt. Wacht en probeer het opnieuw.                                      |