FieldPulse | ElevenLabs Documentation

Met de onderstaande webhooktools 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 of via de chat in de app en vraag om een API-sleutel. Elke onderstaande tool verstuurt deze in de requestheader x-api-key.

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 als een nieuwe beller die een reparatie nodig heeft. De klant verschijnt in FieldPulse als lead, met de opmerking van je receptionist.

Voeg een procedure 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.