de
Integrationen›Jobs über einen Voice Agent buchen

Jobs über einen Voice Agent buchen

Lassen Sie einen KI-Telefonagenten auf ElevenLabs Agents, Vapi oder Retell den Anrufer identifizieren und den Termin buchen, während er noch in der Leitung ist.

Es muss nichts installiert werden. Alle drei Plattformen verbinden sich mit dem Crisphive-MCP-Server über ein kleines, schnelles Tool-Set für Telefonanrufe — das voice-Profil.

Bevor Sie verbinden

  • Geben Sie jedem Job-Typ eine Standarddauer (Einstellungen → Job-Typen). Ein Agent kann nicht wissen, wie lange eine Reparatur dauert. Der Standard-Job-Typ „General“ hat bereits eine und wird verwendet, wenn der Agent keinen Typ nennt.
  • Erstellen Sie einen API-Schlüssel — chsk_test_… zum Ausprobieren, chsk_live_… für echte Anrufe. Er benötigt nur customers_view, customers_manage, job_view, job_create und job_manage.

Den Agenten verbinden

Server URL:  https://api.crisphive.com/mcp?profile=voice
Header:      Authorization: Bearer chsk_live_…   (chsk_test_… for sandbox)
PlattformWo Sie ihn hinzufügenHinweise
ElevenLabs AgentsMCP server integrations → Add Custom MCP Server; fügen Sie den Authorization-Header hinzu und hängen Sie den Server dann an Ihren Agenten an.Stellen Sie die Tool-Freigabe auf Fine-Grained (die Voice-Tools automatisch freigeben) oder No Approval — „Always Ask“ unterbricht den Anruf. MCP ist in Zero-Retention- oder HIPAA-Workspaces nicht verfügbar.
VapiTools → Create Tool → MCP, dann das Tool in Ihrem Assistenten auswählen.Behalten Sie ?profile=voice bei: Vapi importiert jedes Tool, das ein Server anbietet. Verwenden Sie den Standard-HTTP-Transport, nicht SSE.
RetellAgent → MCPs → Add MCP (URL + Header), dann die Tools hinzufügen.Nur Header-Authentifizierung; Retell wiederholt einen fehlgeschlagenen Tool-Aufruf nicht.

Die Voice-Tools

ToolWann der Agent es nutzt
listCustomers mit phoneZuerst, bei jedem Anruf: den Anrufer anhand seiner Nummer in E.164 nachschlagen (+16135550142). Exakte Übereinstimmung.
listJobTypesDas vom Anrufer beschriebene Anliegen einem Job-Typ zuordnen.
bookAndConfirmJobRequestDie Buchung — anlegen, einplanen und bestätigen in einem Aufruf.
listJobRequestBookingWindowsWenn der Anrufer wissen möchte, welche Tage frei sind.
getJobRequestEine Buchung vorlesen („Um wie viel Uhr ist mein Termin?“).

Vorlage für den System-Prompt

You are the booking assistant for [Business name], a [trade] company in
[city]. Times are in [Business timezone].

On every call:
1. Look the caller up with listCustomers using their phone number in
   E.164 (+1 then 10 digits). If exactly one customer comes back, greet
   them by name and use its id. Never guess between several matches.
2. Ask what is wrong and pick the job type from listJobTypes.
3. Agree a start time. Send it as the business's local time, e.g.
   2026-10-06T10:00:00, with no timezone offset.
4. Call bookAndConfirmJobRequest once, with an idempotency_key you generate
   for this call. If you retry, reuse the SAME key.
5. If confirmed is true, read back the date, time and short_code. If it
   is false, tell the caller the office will call to confirm a time.
   Never promise a time the tool did not confirm.

Rules:
- Only set sms_opt_in to true if the caller explicitly agrees to texts.
- Never quote a price.
- A new caller needs a full name and the service address.

Was zu sagen ist, wenn es nicht klappt

ErgebnisWas es bedeutetWas der Agent sagt
confirmed: trueGebucht und eingeplant.„Sie sind für Dienstag um 10 Uhr gebucht, Ihre Referenz lautet …“
confirmed: falseGespeichert, aber zu dieser Zeit ist niemand frei.„Ich habe Ihre Anfrage gespeichert — das Büro ruft Sie an, um einen Termin zu bestätigen.“
400 JOB_REQUEST_INVALID_INPUT mit data.means_locallyDie Uhrzeit enthielt einen falschen Zeitzonen-Offset.Nichts — dieselbe Uhrzeit ohne Offset erneut senden.
400 PHONE_INVALIDDie Telefonnummer ist nicht im E.164-Format.Erneut nach der Nummer fragen.
Ein während eines Anrufs angelegter Kunde erhält nur dann SMS, wenn der Anrufer zugestimmt und der Agent sms_opt_in: true gesendet hat; andernfalls gehen Bestätigungen per E-Mail. Testen Sie mit einem chsk_test_-Schlüssel und messen Sie die Buchungslatenz für Ihr eigenes Unternehmen, bevor Sie live gehen.