> 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

Med [webhook-verktygen](/docs/sv/reception-ai/integrations/webhooks) nedan kan din receptionist känna igen uppringare som redan finns i FieldPulse, lägga till nya uppringare som leads och lämna en kommentar på kunden om vad de behöver, så att ditt team kan följa upp.

## Innan du börjar

FieldPulse utfärdar API-nycklar på begäran. Kontakta FieldPulses support på [support@fieldpulse.com](mailto:support@fieldpulse.com) eller via chatten i appen och be om en API-nyckel. Alla verktyg nedan skickar den i begärandehuvudet `x-api-key`.

> **Warning**
>
> API-nyckeln kan läsa och ändra dina data i FieldPulse. Förvara den säkert och dela den inte.

## Skapa verktygen

För varje verktyg går du till **Integrations**, väljer **Add integration**, väljer **Webhook Tool** och ställer in **Assign to agents** på **Receptionist**.

### Hitta en uppringare

| Fält                 | Värde                                                                                                            |
| -------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Namn**             | `find_fieldpulse_customer`                                                                                       |
| **Beskrivning**      | "Hitta uppringaren i vår kundlista efter namn eller telefonnummer. Använd det i början av ett samtal om arbete." |
| **Metod**            | GET                                                                                                              |
| **URL**              | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`                                         |
| **Begärandehuvuden** | `x-api-key`: din API-nyckel                                                                                      |
| **Frågeparametrar**  | `search` (string, krävs): "Uppringarens fullständiga namn eller telefonnummer."                                  |

### Lägg till en ny kund

| Fält                   | Värde                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Namn**               | `create_fieldpulse_customer`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **Beskrivning**        | "Lägg till uppringaren som en ny kund när `find_fieldpulse_customer` inte hittade dem."                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Metod**              | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **URL**                | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Begärandehuvuden**   | `x-api-key`: din API-nyckel                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Brödtextparametrar** | `first_name` (string, krävs): "Uppringarens förnamn."  `last_name` (string, krävs): "Uppringarens efternamn."  `phone` (string, krävs): "Uppringarens telefonnummer, inklusive riktnummer."  `email` (string): "Uppringarens e-postadress, om de uppgav en."  `status` (string, krävs): "Alltid exakt värdet `lead`."  `service_address_1` (string): "Gatuadressen där arbetet behövs."  `service_address_city` (string): "Staden för den adressen."  `service_address_state` (string): "Delstaten."  `service_address_zip_code` (string): "Postnumret." |

### Logga samtalsuppgifterna

| Fält                   | Värde                                                                                                                                                                                                                                                                                      |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Namn**               | `add_fieldpulse_comment`                                                                                                                                                                                                                                                                   |
| **Beskrivning**        | "Lämna en kommentar i uppringarens kundpost om vad de behöver. Använd det när du har deras kund-id."                                                                                                                                                                                       |
| **Metod**              | POST                                                                                                                                                                                                                                                                                       |
| **URL**                | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments`                                                                                                                                                                                                                    |
| **Begärandehuvuden**   | `x-api-key`: din API-nyckel                                                                                                                                                                                                                                                                |
| **Brödtextparametrar** | `commentable_type` (string, krävs): "Alltid exakt värdet `customer`."  `commentable_id` (number, krävs): "Kundens id, från `find_fieldpulse_customer` eller `create_fieldpulse_customer`."  `text` (string, krävs): "Vad uppringaren behöver, när de är tillgängliga och hur man når dem." |

Välj **Enable** för varje verktyg och [testa sedan din receptionist](/docs/sv/reception-ai/receptionist/testing) som en ny uppringare som behöver en reparation. Kunden visas i FieldPulse som ett lead, med din receptionists kommentar.

> **Tip**
>
> Lägg till en [procedur](/docs/sv/reception-ai/receptionist/rules-and-procedures) för nya arbeten: hitta
> uppringaren, lägg till dem om de inte hittas och logga sedan samtalsuppgifterna.

## Begränsningar

* Jobb behöver en jobbtyp, en status och faktureringsuppgifter från ditt FieldPulse-konto, så din receptionist skapar dem inte. Ditt team omvandlar leadet till ett jobb.
* Din receptionist kan inte kontrollera teknikers tillgänglighet eller boka en tid.
* Webhook-verktyg kan inte skicka listor, så de här verktygen kan inte lägga till taggar eller anpassade fält för en kund.

## Felsökning

| Problem                      | Kontrollera                                                                                                               |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| 401 från FieldPulse          | Rubriken måste heta `x-api-key` och innehålla en aktuell nyckel.                                                          |
| 400 från FieldPulse          | Läs fellistan i svaret. `status` måste vara exakt `lead`, och telefonnummer måste vara giltiga.                           |
| Kända uppringare hittas inte | FieldPulse matchar det som är sparat. Testa uppringarens namn och telefonnummer.                                          |
| Kommentaren läggs inte till  | `commentable_id` måste vara id:t för en befintlig kund. Kontrollera att verktyget för att hitta eller skapa kördes först. |
| 429 från FieldPulse          | Du har nått FieldPulses gräns för begäranden. Vänta och försök igen.                                                      |