Die zentralen Tools der KI-Telefon- und WhatsApp-Agenten. Jede Funktion gibt es genau einmal, für alle Hotels.
/v1/tools/pms/<pms>/<funktion>, zum Beispiel /v1/tools/pms/3rpms/get_availability. Gleiche Funktionen heißen in jedem PMS gleich./v1/tools/<funktion>, zum Beispiel /v1/tools/message. Sie leiten ein Anliegen an das Hotelteam weiter.pms_3rpms_get_availability, std_message.snake_case, Datum YYYY-MM-DD, Uhrzeit HH:MM.Die 13 Tools sind im ElevenLabs-Konto bereits zentral angelegt. Ein Agent bekommt sie über seine Action Cards, es wird nichts neu angelegt. Für ein neues Tool gilt:
POST.https://api.sorhage.dev/v1/tools/pms/3rpms/get_availability.X-Sorhage-Auth, Secret SORHAGE_TOOL_AUTH_FLOTTE.system__…-Felder als Dynamic Variable mit gleichem Namen anlegen; ElevenLabs füllt sie selbst.pms_<pms>_<funktion> oder std_<funktion>.Damit ein Agent die Tools nutzen darf, muss er einem Hotel zugeordnet sein (Verwaltung: PUT /v1/admin/agents/{agent_id}). Ein Webhook beim Gesprächsbeginn ist nicht nötig.
Unter /v1/admin lassen sich Hotels, Einstellungen, PMS-Zugänge und Agenten lesen und ändern, ohne Veröffentlichung. Die Oberfläche dazu liegt unter /admin. Header X-Sorhage-Admin-Key, ein eigener Schlüssel, den kein Agent kennt. PMS-Schlüssel können gesetzt, aber nie ausgelesen werden.
X-Sorhage-Auth, in ElevenLabs als Secret hinterlegt. Ohne ihn antwortet die API mit 401.system__agent_id setzt ElevenLabs selbst, nicht das Sprachmodell. Daraus ergibt sich das Hotel. Unbekannte Agenten bekommen 403.system__conversation_id gerade läuft und zu diesem Agenten gehört. Sonst 403.Jede Antwort ist flach und für das Sprachmodell geschrieben: status (success oder error), bei Fehlern error als Code, immer message mit dem nächsten Schritt für den Agenten und request_id für die Nachverfolgung.
Fehler, auf die der Agent reagieren kann, kommen mit HTTP 200. Echte Fehlercodes gibt es nur, wenn der Aufruf nicht berechtigt ist (401, 403), die Adresse nicht existiert (404) oder das Limit erreicht ist (429).
missing_fields invalid_dates pms_error pms_not_connected pms_mismatch pms_function_unavailable no_config notification_failed no_availability category_not_found category_not_allowed category_priceless max_occupancy_exceeded room_unavailable category_restricted min_stay max_stay rate_plan_missing booking_disabled booking_failed booking_in_progress booking_unknown not_found ambiguous ambiguous_name cancelled rate_limited internal_error
Book exactly one room in the hotel's booking system.
https://api.sorhage.dev/v1/tools/pms/3rpms/create_reservation
| Feld | Typ | Bedeutung | |
|---|---|---|---|
check_in_date | string | Pflicht | Arrival date, format YYYY-MM-DD, e.g. 2026-12-03. |
check_out_date | string | Pflicht | Departure date, format YYYY-MM-DD, e.g. 2026-12-05. |
guests | integer | Pflicht | Number of guests as an integer, e.g. 2. |
room_category_id | string | Pflicht | category_id of the chosen category from pms_3rpms_get_availability, unchanged, e.g. 402. |
breakfast | boolean | Pflicht | true only if the guest explicitly wants breakfast, otherwise false. |
last_name | string | Pflicht | Guest's last name as understood, e.g. Beispiel. |
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
email | string | optional | Email address, e.g. anna@example.org. Omit if not given. |
phone | string | optional | Callback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit. |
booker_first_name | string | optional | Only if the caller books for someone else: the caller's first name. Otherwise omit. |
booker_last_name | string | optional | Only if the caller books for someone else: the caller's last name. Otherwise omit. |
booking_type | string · private | business | optional | private or business. Set business only if the caller mentions a company or a business trip; otherwise omit. |
company_name | string | optional | Company name for business bookings, e.g. ACME GmbH. Otherwise omit. |
notes | string | optional | Additional details for the hotel team in one or two sentences. Omit if none. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "booking_unknown",
"request_id": "mock-0000",
"message": "Der Ausgang der Buchung ist UNKLAR. Bestätige KEINE Buchung und KEINE Reservierungsnummer und sage auch nicht, dass die Buchung fehlgeschlagen ist. Sage, dass das Team die Reservierung prüft und sich meldet, und nimm einen Rückruf auf. Lege KEINE neue Reservierung an."
}Find an existing reservation and verify the caller.
https://api.sorhage.dev/v1/tools/pms/3rpms/find_reservation
| Feld | Typ | Bedeutung | |
|---|---|---|---|
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
last_name | string | optional | Guest's last name as understood, e.g. Beispiel. |
reservation_number | string | optional | The hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "success",
"matches": [
{
"guest_name": "Jonas Kestner",
"reservation_number": "500100",
"room_number": "207",
"category_name": "Standard-Einzelzimmer",
"check_in_date": "2026-11-19",
"check_out_date": "2026-11-20",
"access_code": "4729",
"access_code_exists": true
}
],
"access_code_available": true,
"verified_by": "reservation_number",
"request_id": "mock-0000",
"message": "Buchung gefunden: Jonas Kestner, Reservierungsnummer 500100. Anreise ist heute. Zimmer 207. Der Anrufer gilt damit als bestätigt. Der persönliche Zugangscode lautet 4 7 2 9. Nenne ihn Ziffer für Ziffer, langsam."
}Give the caller their personal access code for the house or room door.
https://api.sorhage.dev/v1/tools/pms/3rpms/get_access_code
| Feld | Typ | Bedeutung | |
|---|---|---|---|
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
last_name | string | optional | Guest's last name as understood, e.g. Beispiel. |
reservation_number | string | optional | The hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "success",
"access_code_available": true,
"access_code": "4729",
"guest_name": "Jonas Kestner",
"reservation_number": "500100",
"room_number": "207",
"check_in_date": "2026-11-19",
"check_out_date": "2026-11-20",
"verified_by": "reservation_number",
"request_id": "mock-0000",
"message": "Buchung gefunden: Jonas Kestner, Reservierungsnummer 500100. Anreise ist heute. Zimmer 207. Der Anrufer gilt damit als bestätigt. Der persönliche Zugangscode lautet 4 7 2 9. Nenne ihn Ziffer für Ziffer, langsam."
}Check live room availability and prices for a stay.
https://api.sorhage.dev/v1/tools/pms/3rpms/get_availability
| Feld | Typ | Bedeutung | |
|---|---|---|---|
check_in_date | string | Pflicht | Arrival date, format YYYY-MM-DD, e.g. 2026-12-03. |
check_out_date | string | Pflicht | Departure date, format YYYY-MM-DD, e.g. 2026-12-05. |
guests | integer | Pflicht | Number of guests as an integer, e.g. 2. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "no_availability",
"info_only_categories": [],
"nights": 2,
"request_id": "mock-0000",
"message": "Für diesen Zeitraum ist telefonisch nichts buchbar. Sage das offen und biete an, einen anderen Zeitraum oder eine andere Personenzahl zu prüfen. Erfinde KEINE Alternative."
}Pass a change request for an existing booking to the hotel.
https://api.sorhage.dev/v1/tools/booking_change
| Feld | Typ | Bedeutung | |
|---|---|---|---|
last_name | string | Pflicht | Guest's last name as understood, e.g. Beispiel. |
requested_change | string | Pflicht | The requested change in one sentence, e.g. extend the stay by one night. |
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
reservation_number | string | optional | The hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown. |
check_in_date | string | optional | Arrival date, format YYYY-MM-DD, e.g. 2026-12-03. |
booking_type | string · private | business | optional | private or business. Set business only if the caller mentions a company or a business trip; otherwise omit. |
company_name | string | optional | Company name for business bookings, e.g. ACME GmbH. Otherwise omit. |
email | string | optional | Email address, e.g. anna@example.org. Omit if not given. |
phone | string | optional | Callback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit. |
notes | string | optional | Additional details for the hotel team in one or two sentences. Omit if none. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "notification_failed",
"request_id": "mock-0000",
"message": "Die Meldung konnte wegen eines technischen Fehlers nicht an das Team übermittelt werden. Sage dem Gast offen, dass die Übermittlung nicht bestätigt werden konnte, und folge der vorgesehenen Fehlerbehandlung."
}Record a callback request for the hotel team.
https://api.sorhage.dev/v1/tools/callback
| Feld | Typ | Bedeutung | |
|---|---|---|---|
last_name | string | Pflicht | Guest's last name as understood, e.g. Beispiel. |
request | string | Pflicht | The caller's request in one clear sentence. |
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
phone | string | optional | Callback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit. |
callback_date | string | optional | Requested callback date, format YYYY-MM-DD. Omit for as soon as possible. |
callback_time | string | optional | Requested callback time, format HH:MM, e.g. 15:30. Omit for as soon as possible. |
notes | string | optional | Additional details for the hotel team in one or two sentences. Omit if none. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "notification_failed",
"request_id": "mock-0000",
"message": "Die Meldung konnte wegen eines technischen Fehlers nicht an das Team übermittelt werden. Sage dem Gast offen, dass die Übermittlung nicht bestätigt werden konnte, und folge der vorgesehenen Fehlerbehandlung."
}Pass an event or celebration request to the hotel team.
https://api.sorhage.dev/v1/tools/event_request
| Feld | Typ | Bedeutung | |
|---|---|---|---|
last_name | string | Pflicht | Guest's last name as understood, e.g. Beispiel. |
request | string | Pflicht | The caller's request in one clear sentence. |
event_type | string | Pflicht | Type of event, e.g. Hochzeit, Tagung, Geburtstag. |
event_date | string | Pflicht | Date of the event, format YYYY-MM-DD, e.g. 2027-06-12. |
guests | integer | Pflicht | Number of guests as an integer, e.g. 2. |
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
event_time | string | optional | Start time of the event, format HH:MM, e.g. 18:00. Omit if not stated. |
email | string | optional | Email address, e.g. anna@example.org. Omit if not given. |
phone | string | optional | Callback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit. |
notes | string | optional | Additional details for the hotel team in one or two sentences. Omit if none. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "notification_failed",
"request_id": "mock-0000",
"message": "Die Meldung konnte wegen eines technischen Fehlers nicht an das Team übermittelt werden. Sage dem Gast offen, dass die Übermittlung nicht bestätigt werden konnte, und folge der vorgesehenen Fehlerbehandlung."
}Pass an invoice or accounting request to the hotel team.
https://api.sorhage.dev/v1/tools/invoice
| Feld | Typ | Bedeutung | |
|---|---|---|---|
last_name | string | Pflicht | Guest's last name as understood, e.g. Beispiel. |
request | string | Pflicht | The caller's request in one clear sentence. |
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
reservation_number | string | optional | The hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown. |
invoice_number | string | optional | Invoice number if the caller has one. Otherwise omit. |
check_in_date | string | optional | Arrival date, format YYYY-MM-DD, e.g. 2026-12-03. |
booking_type | string · private | business | optional | private or business. Set business only if the caller mentions a company or a business trip; otherwise omit. |
company_name | string | optional | Company name for business bookings, e.g. ACME GmbH. Otherwise omit. |
billing_address | string | optional | Billing address if the caller gives one. Otherwise omit. |
email | string | optional | Email address, e.g. anna@example.org. Omit if not given. |
phone | string | optional | Callback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit. |
notes | string | optional | Additional details for the hotel team in one or two sentences. Omit if none. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "notification_failed",
"request_id": "mock-0000",
"message": "Die Meldung konnte wegen eines technischen Fehlers nicht an das Team übermittelt werden. Sage dem Gast offen, dass die Übermittlung nicht bestätigt werden konnte, und folge der vorgesehenen Fehlerbehandlung."
}Report a lost item to the hotel team.
https://api.sorhage.dev/v1/tools/lost_item
| Feld | Typ | Bedeutung | |
|---|---|---|---|
last_name | string | Pflicht | Guest's last name as understood, e.g. Beispiel. |
request | string | Pflicht | The caller's request in one clear sentence. |
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
phone | string | optional | Callback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit. |
notes | string | optional | Additional details for the hotel team in one or two sentences. Omit if none. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "notification_failed",
"request_id": "mock-0000",
"message": "Die Meldung konnte wegen eines technischen Fehlers nicht an das Team übermittelt werden. Sage dem Gast offen, dass die Übermittlung nicht bestätigt werden konnte, und folge der vorgesehenen Fehlerbehandlung."
}Report a technical problem in a room to the hotel team.
https://api.sorhage.dev/v1/tools/maintenance
| Feld | Typ | Bedeutung | |
|---|---|---|---|
request | string | Pflicht | The caller's request in one clear sentence. |
room_number | string | Pflicht | Room number as stated, e.g. 207. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "success",
"reference": "A1B2C3D4",
"request_id": "mock-0000",
"message": "Instandhaltungsticket aufgenommen und an das Team weitergeleitet."
}Pass a general message from the caller to the hotel team.
https://api.sorhage.dev/v1/tools/message
| Feld | Typ | Bedeutung | |
|---|---|---|---|
last_name | string | Pflicht | Guest's last name as understood, e.g. Beispiel. |
request | string | Pflicht | The caller's request in one clear sentence. |
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
phone | string | optional | Callback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit. |
notes | string | optional | Additional details for the hotel team in one or two sentences. Omit if none. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "notification_failed",
"request_id": "mock-0000",
"message": "Die Meldung konnte wegen eines technischen Fehlers nicht an das Team übermittelt werden. Sage dem Gast offen, dass die Übermittlung nicht bestätigt werden konnte, und folge der vorgesehenen Fehlerbehandlung."
}Pass a parking space request to the hotel.
https://api.sorhage.dev/v1/tools/parking_request
| Feld | Typ | Bedeutung | |
|---|---|---|---|
last_name | string | Pflicht | Guest's last name as understood, e.g. Beispiel. |
check_in_date | string | Pflicht | Arrival date, format YYYY-MM-DD, e.g. 2026-12-03. |
check_out_date | string | Pflicht | Departure date, format YYYY-MM-DD, e.g. 2026-12-05. |
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
license_plate | string | optional | Vehicle license plate, e.g. HF-AB 123. Omit if not stated. |
reservation_number | string | optional | The hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown. |
phone | string | optional | Callback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit. |
notes | string | optional | Additional details for the hotel team in one or two sentences. Omit if none. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "notification_failed",
"request_id": "mock-0000",
"message": "Die Meldung konnte wegen eines technischen Fehlers nicht an das Team übermittelt werden. Sage dem Gast offen, dass die Übermittlung nicht bestätigt werden konnte, und folge der vorgesehenen Fehlerbehandlung."
}Pass a cancellation request for an existing booking to the hotel.
https://api.sorhage.dev/v1/tools/room_cancellation
| Feld | Typ | Bedeutung | |
|---|---|---|---|
last_name | string | Pflicht | Guest's last name as understood, e.g. Beispiel. |
check_in_date | string | Pflicht | Arrival date, format YYYY-MM-DD, e.g. 2026-12-03. |
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
reservation_number | string | optional | The hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown. |
reason | string | optional | Reason for the cancellation if the caller gives one. Otherwise omit. |
booking_type | string · private | business | optional | private or business. Set business only if the caller mentions a company or a business trip; otherwise omit. |
company_name | string | optional | Company name for business bookings, e.g. ACME GmbH. Otherwise omit. |
email | string | optional | Email address, e.g. anna@example.org. Omit if not given. |
phone | string | optional | Callback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit. |
notes | string | optional | Additional details for the hotel team in one or two sentences. Omit if none. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "notification_failed",
"request_id": "mock-0000",
"message": "Die Meldung konnte wegen eines technischen Fehlers nicht an das Team übermittelt werden. Sage dem Gast offen, dass die Übermittlung nicht bestätigt werden konnte, und folge der vorgesehenen Fehlerbehandlung."
}Pass a non-binding room request to the hotel.
https://api.sorhage.dev/v1/tools/room_request
| Feld | Typ | Bedeutung | |
|---|---|---|---|
last_name | string | Pflicht | Guest's last name as understood, e.g. Beispiel. |
check_in_date | string | Pflicht | Arrival date, format YYYY-MM-DD, e.g. 2026-12-03. |
check_out_date | string | Pflicht | Departure date, format YYYY-MM-DD, e.g. 2026-12-05. |
first_name | string | optional | Guest's first name, e.g. Anna. Omit if not given. |
guests | integer | optional | Number of guests as an integer, e.g. 2. |
rooms | integer | optional | Number of rooms as an integer, e.g. 1. Omit if not stated. |
room_type | string | optional | Requested room category in the caller's words, e.g. Doppelzimmer. Omit if not stated. |
booking_type | string · private | business | optional | private or business. Set business only if the caller mentions a company or a business trip; otherwise omit. |
company_name | string | optional | Company name for business bookings, e.g. ACME GmbH. Otherwise omit. |
billing_address | string | optional | Billing address if the caller gives one. Otherwise omit. |
email | string | optional | Email address, e.g. anna@example.org. Omit if not given. |
phone | string | optional | Callback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit. |
notes | string | optional | Additional details for the hotel team in one or two sentences. Omit if none. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "error",
"error": "notification_failed",
"request_id": "mock-0000",
"message": "Die Meldung konnte wegen eines technischen Fehlers nicht an das Team übermittelt werden. Sage dem Gast offen, dass die Übermittlung nicht bestätigt werden konnte, und folge der vorgesehenen Fehlerbehandlung."
}Connect the caller to the emergency contact of the hotel.
https://api.sorhage.dev/v1/tools/telephony/emergency_contact
| Feld | Typ | Bedeutung | |
|---|---|---|---|
summary | string | optional | One sentence on why the caller is being connected. Omit if unclear. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "success",
"target": "emergency",
"request_id": "mock-0000",
"message": "Der Verbindungsversuch zum Notfallkontakt läuft. Sage dem Anrufer in einem kurzen Satz, dass du ihn jetzt verbindest, und sprich danach nicht weiter."
}Connect the caller to a person at the hotel (destination 1; the action card says who that is).
https://api.sorhage.dev/v1/tools/telephony/transfer_1
| Feld | Typ | Bedeutung | |
|---|---|---|---|
summary | string | optional | One sentence on why the caller is being connected. Omit if unclear. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "success",
"target": "transfer_1",
"request_id": "mock-0000",
"message": "Der Verbindungsversuch läuft. Sage dem Anrufer in einem kurzen Satz, dass du ihn jetzt verbindest, und sprich danach nicht weiter."
}Connect the caller to a person at the hotel (destination 2; the action card says who that is).
https://api.sorhage.dev/v1/tools/telephony/transfer_2
| Feld | Typ | Bedeutung | |
|---|---|---|---|
summary | string | optional | One sentence on why the caller is being connected. Omit if unclear. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "success",
"target": "transfer_2",
"request_id": "mock-0000",
"message": "Der Verbindungsversuch läuft. Sage dem Anrufer in einem kurzen Satz, dass du ihn jetzt verbindest, und sprich danach nicht weiter."
}Connect the caller to a person at the hotel (destination 3; the action card says who that is).
https://api.sorhage.dev/v1/tools/telephony/transfer_3
| Feld | Typ | Bedeutung | |
|---|---|---|---|
summary | string | optional | One sentence on why the caller is being connected. Omit if unclear. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "success",
"target": "transfer_3",
"request_id": "mock-0000",
"message": "Der Verbindungsversuch läuft. Sage dem Anrufer in einem kurzen Satz, dass du ihn jetzt verbindest, und sprich danach nicht weiter."
}Connect the caller to a person at the hotel (destination 4; the action card says who that is).
https://api.sorhage.dev/v1/tools/telephony/transfer_4
| Feld | Typ | Bedeutung | |
|---|---|---|---|
summary | string | optional | One sentence on why the caller is being connected. Omit if unclear. |
system__agent_id | string | Pflicht | ElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel. |
system__conversation_id | string | Pflicht | ElevenLabs conversation id. The call must belong to a running conversation of this agent. |
system__caller_id | string | Pflicht | Calling number as delivered by the platform. |
system__called_number | string | optional | Called number as delivered by the platform. |
{
"status": "success",
"target": "transfer_4",
"request_id": "mock-0000",
"message": "Der Verbindungsversuch läuft. Sage dem Anrufer in einem kurzen Satz, dass du ihn jetzt verbindest, und sprich danach nicht weiter."
}Alle zugeordneten Agenten mit Hotel und Status.
Agent einem Hotel zuordnen. Ab dann werden seine Tool-Aufrufe angenommen (nur in einem laufenden Gespräch).
| Feld | Typ | Bedeutung | |
|---|---|---|---|
hotel | string | Pflicht | Kurzname des Hotels (slug). |
write_mode_cap | string · disabled | dry_run | live | optional | |
allowed_functions | array | optional | Standard ["*"] = alle Tools. |
note | string | optional |
Agent abschalten. Der Eintrag bleibt, die Historie bleibt lesbar.
Letzte Tool-Aufrufe: Zeit, Agent, Tool, Ergebnis, Dauer. Ohne Gästedaten.
Alle Hotels mit Status, PMS-Zugang (ohne Schlüssel) und zugeordneten Agenten.
Ein Hotel vollständig: Einstellungen, PMS-Zugang (ohne Schlüssel), Agenten.
Hotel anlegen oder ändern. Ein neues Hotel startet im Probemodus (dry_run): es wird nichts verschickt.
| Feld | Typ | Bedeutung | |
|---|---|---|---|
name | string | optional | Anzeigename, z. B. ART Hotel Braun. Pflicht beim Anlegen. |
status | string · active | paused | optional | paused = alle Tool-Aufrufe werden abgelehnt. |
timezone | string | optional | Standard Europe/Berlin. |
Prüft den PMS-Zugang live und vergleicht Kategorien und Raten mit den Einstellungen.
Einstellungen eines Hotels lesen (Empfänger, SMS-Texte, Raten, Zugangscode-Regeln).
Einstellungen in Teilen ändern. Objekte werden zusammengeführt, Listen und Werte ersetzt, null entfernt einen Eintrag. Ungültiges wird abgelehnt, nichts wird gespeichert.
| Feld | Typ | Bedeutung | |
|---|---|---|---|
notifications | object | optional | z. B. {"email_to": ["team@hotel.de"], "mode": "live"} |
Einstellungen vollständig ersetzen.
PMS-Zugang hinterlegen. Der Schlüssel wird verschlüsselt gespeichert und nie zurückgegeben; ohne api_key bleibt der gespeicherte erhalten.
| Feld | Typ | Bedeutung | |
|---|---|---|---|
pms_type | string | Pflicht | z. B. 3rpms |
endpoint | string | Pflicht | https-Adresse des PMS, z. B. https://www.3rpms.de/graphql |
api_key | string | optional | PMS-Schlüssel. Nur schreiben. |
write_mode | string · disabled | dry_run | live | optional | dry_run = Buchungen simuliert. |
Optional ElevenLabs conversation initiation webhook: the start variables of the hotel (e.g. first_message).
| Feld | Typ | Bedeutung | |
|---|---|---|---|
agent_id | string | Pflicht | |
conversation_id | string | optional |
Liveness check.
Erzeugt aus den Tool-Definitionen (scripts/openapi.py). Version 1.0.0 · 29 Adressen