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 nurcustomers_view,customers_manage,job_view,job_createundjob_manage.
Den Agenten verbinden
Server URL: https://api.crisphive.com/mcp?profile=voice Header: Authorization: Bearer chsk_live_… (chsk_test_… for sandbox)
| Plattform | Wo Sie ihn hinzufügen | Hinweise |
|---|---|---|
| ElevenLabs Agents | MCP 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. |
| Vapi | Tools → 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. |
| Retell | Agent → MCPs → Add MCP (URL + Header), dann die Tools hinzufügen. | Nur Header-Authentifizierung; Retell wiederholt einen fehlgeschlagenen Tool-Aufruf nicht. |
Die Voice-Tools
| Tool | Wann der Agent es nutzt |
|---|---|
listCustomers mit phone | Zuerst, bei jedem Anruf: den Anrufer anhand seiner Nummer in E.164 nachschlagen (+16135550142). Exakte Übereinstimmung. |
listJobTypes | Das vom Anrufer beschriebene Anliegen einem Job-Typ zuordnen. |
bookAndConfirmJobRequest | Die Buchung — anlegen, einplanen und bestätigen in einem Aufruf. |
listJobRequestBookingWindows | Wenn der Anrufer wissen möchte, welche Tage frei sind. |
getJobRequest | Eine 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
| Ergebnis | Was es bedeutet | Was der Agent sagt |
|---|---|---|
confirmed: true | Gebucht und eingeplant. | „Sie sind für Dienstag um 10 Uhr gebucht, Ihre Referenz lautet …“ |
confirmed: false | Gespeichert, 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_locally | Die Uhrzeit enthielt einen falschen Zeitzonen-Offset. | Nichts — dieselbe Uhrzeit ohne Offset erneut senden. |
400 PHONE_INVALID | Die 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.