Sorhage Solutions API

Die zentralen Tools der KI-Telefon- und WhatsApp-Agenten. Jede Funktion gibt es genau einmal, für alle Hotels.

Aufbau

In ElevenLabs einrichten

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:

  1. Typ: Webhook, Methode POST.
  2. URL: die volle Adresse, die unten bei jedem Tool steht, zum Beispiel https://api.sorhage.dev/v1/tools/pms/3rpms/get_availability.
  3. Header: genau einer. Typ Secret, Name X-Sorhage-Auth, Secret SORHAGE_TOOL_AUTH_FLOTTE.
  4. Felder im Body: wie unten bei „Felder“. Die vier system__…-Felder als Dynamic Variable mit gleichem Namen anlegen; ElevenLabs füllt sie selbst.
  5. Name: wie die Adresse, 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.

Verwaltung

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.

Absicherung

  1. Ein Key. Header X-Sorhage-Auth, in ElevenLabs als Secret hinterlegt. Ohne ihn antwortet die API mit 401.
  2. Agent-ID. system__agent_id setzt ElevenLabs selbst, nicht das Sprachmodell. Daraus ergibt sich das Hotel. Unbekannte Agenten bekommen 403.
  3. Laufendes Gespräch. Die API prüft bei ElevenLabs, dass system__conversation_id gerade läuft und zu diesem Agenten gehört. Sonst 403.
  4. PMS des Hauses. Das PMS in der Adresse ist nur Wegweiser. Maßgeblich ist der hinterlegte Zugang des Hotels.

Antworten

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).

Fehlercodes

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

PMS-Tools: 3RPMS

POST/v1/tools/pms/3rpms/create_reservationpms_3rpms_create_reservation

Book exactly one room in the hotel's booking system.

https://api.sorhage.dev/v1/tools/pms/3rpms/create_reservation

Felder
FeldTypBedeutung
check_in_datestringPflichtArrival date, format YYYY-MM-DD, e.g. 2026-12-03.
check_out_datestringPflichtDeparture date, format YYYY-MM-DD, e.g. 2026-12-05.
guestsintegerPflichtNumber of guests as an integer, e.g. 2.
room_category_idstringPflichtcategory_id of the chosen category from pms_3rpms_get_availability, unchanged, e.g. 402.
breakfastbooleanPflichttrue only if the guest explicitly wants breakfast, otherwise false.
last_namestringPflichtGuest's last name as understood, e.g. Beispiel.
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
emailstringoptionalEmail address, e.g. anna@example.org. Omit if not given.
phonestringoptionalCallback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit.
booker_first_namestringoptionalOnly if the caller books for someone else: the caller's first name. Otherwise omit.
booker_last_namestringoptionalOnly if the caller books for someone else: the caller's last name. Otherwise omit.
booking_typestring · private | businessoptionalprivate or business. Set business only if the caller mentions a company or a business trip; otherwise omit.
company_namestringoptionalCompany name for business bookings, e.g. ACME GmbH. Otherwise omit.
notesstringoptionalAdditional details for the hotel team in one or two sentences. Omit if none.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/pms/3rpms/find_reservationpms_3rpms_find_reservation

Find an existing reservation and verify the caller.

https://api.sorhage.dev/v1/tools/pms/3rpms/find_reservation

Felder
FeldTypBedeutung
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
last_namestringoptionalGuest's last name as understood, e.g. Beispiel.
reservation_numberstringoptionalThe hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/pms/3rpms/get_access_codepms_3rpms_get_access_code

Give the caller their personal access code for the house or room door.

https://api.sorhage.dev/v1/tools/pms/3rpms/get_access_code

Felder
FeldTypBedeutung
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
last_namestringoptionalGuest's last name as understood, e.g. Beispiel.
reservation_numberstringoptionalThe hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/pms/3rpms/get_availabilitypms_3rpms_get_availability

Check live room availability and prices for a stay.

https://api.sorhage.dev/v1/tools/pms/3rpms/get_availability

Felder
FeldTypBedeutung
check_in_datestringPflichtArrival date, format YYYY-MM-DD, e.g. 2026-12-03.
check_out_datestringPflichtDeparture date, format YYYY-MM-DD, e.g. 2026-12-05.
guestsintegerPflichtNumber of guests as an integer, e.g. 2.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}

Standardtools

POST/v1/tools/booking_changestd_booking_change

Pass a change request for an existing booking to the hotel.

https://api.sorhage.dev/v1/tools/booking_change

Felder
FeldTypBedeutung
last_namestringPflichtGuest's last name as understood, e.g. Beispiel.
requested_changestringPflichtThe requested change in one sentence, e.g. extend the stay by one night.
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
reservation_numberstringoptionalThe hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown.
check_in_datestringoptionalArrival date, format YYYY-MM-DD, e.g. 2026-12-03.
booking_typestring · private | businessoptionalprivate or business. Set business only if the caller mentions a company or a business trip; otherwise omit.
company_namestringoptionalCompany name for business bookings, e.g. ACME GmbH. Otherwise omit.
emailstringoptionalEmail address, e.g. anna@example.org. Omit if not given.
phonestringoptionalCallback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit.
notesstringoptionalAdditional details for the hotel team in one or two sentences. Omit if none.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/callbackstd_callback

Record a callback request for the hotel team.

https://api.sorhage.dev/v1/tools/callback

Felder
FeldTypBedeutung
last_namestringPflichtGuest's last name as understood, e.g. Beispiel.
requeststringPflichtThe caller's request in one clear sentence.
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
phonestringoptionalCallback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit.
callback_datestringoptionalRequested callback date, format YYYY-MM-DD. Omit for as soon as possible.
callback_timestringoptionalRequested callback time, format HH:MM, e.g. 15:30. Omit for as soon as possible.
notesstringoptionalAdditional details for the hotel team in one or two sentences. Omit if none.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/event_requeststd_event_request

Pass an event or celebration request to the hotel team.

https://api.sorhage.dev/v1/tools/event_request

Felder
FeldTypBedeutung
last_namestringPflichtGuest's last name as understood, e.g. Beispiel.
requeststringPflichtThe caller's request in one clear sentence.
event_typestringPflichtType of event, e.g. Hochzeit, Tagung, Geburtstag.
event_datestringPflichtDate of the event, format YYYY-MM-DD, e.g. 2027-06-12.
guestsintegerPflichtNumber of guests as an integer, e.g. 2.
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
event_timestringoptionalStart time of the event, format HH:MM, e.g. 18:00. Omit if not stated.
emailstringoptionalEmail address, e.g. anna@example.org. Omit if not given.
phonestringoptionalCallback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit.
notesstringoptionalAdditional details for the hotel team in one or two sentences. Omit if none.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/invoicestd_invoice

Pass an invoice or accounting request to the hotel team.

https://api.sorhage.dev/v1/tools/invoice

Felder
FeldTypBedeutung
last_namestringPflichtGuest's last name as understood, e.g. Beispiel.
requeststringPflichtThe caller's request in one clear sentence.
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
reservation_numberstringoptionalThe hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown.
invoice_numberstringoptionalInvoice number if the caller has one. Otherwise omit.
check_in_datestringoptionalArrival date, format YYYY-MM-DD, e.g. 2026-12-03.
booking_typestring · private | businessoptionalprivate or business. Set business only if the caller mentions a company or a business trip; otherwise omit.
company_namestringoptionalCompany name for business bookings, e.g. ACME GmbH. Otherwise omit.
billing_addressstringoptionalBilling address if the caller gives one. Otherwise omit.
emailstringoptionalEmail address, e.g. anna@example.org. Omit if not given.
phonestringoptionalCallback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit.
notesstringoptionalAdditional details for the hotel team in one or two sentences. Omit if none.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/lost_itemstd_lost_item

Report a lost item to the hotel team.

https://api.sorhage.dev/v1/tools/lost_item

Felder
FeldTypBedeutung
last_namestringPflichtGuest's last name as understood, e.g. Beispiel.
requeststringPflichtThe caller's request in one clear sentence.
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
phonestringoptionalCallback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit.
notesstringoptionalAdditional details for the hotel team in one or two sentences. Omit if none.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/maintenancestd_maintenance

Report a technical problem in a room to the hotel team.

https://api.sorhage.dev/v1/tools/maintenance

Felder
FeldTypBedeutung
requeststringPflichtThe caller's request in one clear sentence.
room_numberstringPflichtRoom number as stated, e.g. 207.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "status": "success",
  "reference": "A1B2C3D4",
  "request_id": "mock-0000",
  "message": "Instandhaltungsticket aufgenommen und an das Team weitergeleitet."
}
POST/v1/tools/messagestd_message

Pass a general message from the caller to the hotel team.

https://api.sorhage.dev/v1/tools/message

Felder
FeldTypBedeutung
last_namestringPflichtGuest's last name as understood, e.g. Beispiel.
requeststringPflichtThe caller's request in one clear sentence.
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
phonestringoptionalCallback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit.
notesstringoptionalAdditional details for the hotel team in one or two sentences. Omit if none.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/parking_requeststd_parking_request

Pass a parking space request to the hotel.

https://api.sorhage.dev/v1/tools/parking_request

Felder
FeldTypBedeutung
last_namestringPflichtGuest's last name as understood, e.g. Beispiel.
check_in_datestringPflichtArrival date, format YYYY-MM-DD, e.g. 2026-12-03.
check_out_datestringPflichtDeparture date, format YYYY-MM-DD, e.g. 2026-12-05.
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
license_platestringoptionalVehicle license plate, e.g. HF-AB 123. Omit if not stated.
reservation_numberstringoptionalThe hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown.
phonestringoptionalCallback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit.
notesstringoptionalAdditional details for the hotel team in one or two sentences. Omit if none.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/room_cancellationstd_room_cancellation

Pass a cancellation request for an existing booking to the hotel.

https://api.sorhage.dev/v1/tools/room_cancellation

Felder
FeldTypBedeutung
last_namestringPflichtGuest's last name as understood, e.g. Beispiel.
check_in_datestringPflichtArrival date, format YYYY-MM-DD, e.g. 2026-12-03.
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
reservation_numberstringoptionalThe hotel's reservation number, e.g. 524301. Booking portal numbers do not count. Omit if unknown.
reasonstringoptionalReason for the cancellation if the caller gives one. Otherwise omit.
booking_typestring · private | businessoptionalprivate or business. Set business only if the caller mentions a company or a business trip; otherwise omit.
company_namestringoptionalCompany name for business bookings, e.g. ACME GmbH. Otherwise omit.
emailstringoptionalEmail address, e.g. anna@example.org. Omit if not given.
phonestringoptionalCallback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit.
notesstringoptionalAdditional details for the hotel team in one or two sentences. Omit if none.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/room_requeststd_room_request

Pass a non-binding room request to the hotel.

https://api.sorhage.dev/v1/tools/room_request

Felder
FeldTypBedeutung
last_namestringPflichtGuest's last name as understood, e.g. Beispiel.
check_in_datestringPflichtArrival date, format YYYY-MM-DD, e.g. 2026-12-03.
check_out_datestringPflichtDeparture date, format YYYY-MM-DD, e.g. 2026-12-05.
first_namestringoptionalGuest's first name, e.g. Anna. Omit if not given.
guestsintegeroptionalNumber of guests as an integer, e.g. 2.
roomsintegeroptionalNumber of rooms as an integer, e.g. 1. Omit if not stated.
room_typestringoptionalRequested room category in the caller's words, e.g. Doppelzimmer. Omit if not stated.
booking_typestring · private | businessoptionalprivate or business. Set business only if the caller mentions a company or a business trip; otherwise omit.
company_namestringoptionalCompany name for business bookings, e.g. ACME GmbH. Otherwise omit.
billing_addressstringoptionalBilling address if the caller gives one. Otherwise omit.
emailstringoptionalEmail address, e.g. anna@example.org. Omit if not given.
phonestringoptionalCallback number, only if the caller states one that differs from the calling number, e.g. +491701234567. Otherwise omit.
notesstringoptionalAdditional details for the hotel team in one or two sentences. Omit if none.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}

Anruf-Tools

POST/v1/tools/telephony/emergency_contacttelephony_emergency_contact

Connect the caller to the emergency contact of the hotel.

https://api.sorhage.dev/v1/tools/telephony/emergency_contact

Felder
FeldTypBedeutung
summarystringoptionalOne sentence on why the caller is being connected. Omit if unclear.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/telephony/transfer_1telephony_transfer_1

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

Felder
FeldTypBedeutung
summarystringoptionalOne sentence on why the caller is being connected. Omit if unclear.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/telephony/transfer_2telephony_transfer_2

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

Felder
FeldTypBedeutung
summarystringoptionalOne sentence on why the caller is being connected. Omit if unclear.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/telephony/transfer_3telephony_transfer_3

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

Felder
FeldTypBedeutung
summarystringoptionalOne sentence on why the caller is being connected. Omit if unclear.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}
POST/v1/tools/telephony/transfer_4telephony_transfer_4

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

Felder
FeldTypBedeutung
summarystringoptionalOne sentence on why the caller is being connected. Omit if unclear.
system__agent_idstringPflichtElevenLabs agent id. Set by the platform, never by the language model. Identifies the hotel.
system__conversation_idstringPflichtElevenLabs conversation id. The call must belong to a running conversation of this agent.
system__caller_idstringPflichtCalling number as delivered by the platform.
system__called_numberstringoptionalCalled number as delivered by the platform.
Beispielantwort
{
  "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."
}

Verwaltung

GET/v1/admin/agentslist_agents

Alle zugeordneten Agenten mit Hotel und Status.

PUT/v1/admin/agents/{agent_id}put_agent

Agent einem Hotel zuordnen. Ab dann werden seine Tool-Aufrufe angenommen (nur in einem laufenden Gespräch).

Felder
FeldTypBedeutung
hotelstringPflichtKurzname des Hotels (slug).
write_mode_capstring · disabled | dry_run | liveoptional
allowed_functionsarrayoptionalStandard ["*"] = alle Tools.
notestringoptional
DELETE/v1/admin/agents/{agent_id}disable_agent

Agent abschalten. Der Eintrag bleibt, die Historie bleibt lesbar.

GET/v1/admin/callslist_calls

Letzte Tool-Aufrufe: Zeit, Agent, Tool, Ergebnis, Dauer. Ohne Gästedaten.

GET/v1/admin/hotelslist_hotels

Alle Hotels mit Status, PMS-Zugang (ohne Schlüssel) und zugeordneten Agenten.

GET/v1/admin/hotels/{slug}get_hotel

Ein Hotel vollständig: Einstellungen, PMS-Zugang (ohne Schlüssel), Agenten.

PUT/v1/admin/hotels/{slug}put_hotel

Hotel anlegen oder ändern. Ein neues Hotel startet im Probemodus (dry_run): es wird nichts verschickt.

Felder
FeldTypBedeutung
namestringoptionalAnzeigename, z. B. ART Hotel Braun. Pflicht beim Anlegen.
statusstring · active | pausedoptionalpaused = alle Tool-Aufrufe werden abgelehnt.
timezonestringoptionalStandard Europe/Berlin.
POST/v1/admin/hotels/{slug}/checkcheck_hotel

Prüft den PMS-Zugang live und vergleicht Kategorien und Raten mit den Einstellungen.

GET/v1/admin/hotels/{slug}/configget_hotel_config

Einstellungen eines Hotels lesen (Empfänger, SMS-Texte, Raten, Zugangscode-Regeln).

PATCH/v1/admin/hotels/{slug}/configpatch_hotel_config

Einstellungen in Teilen ändern. Objekte werden zusammengeführt, Listen und Werte ersetzt, null entfernt einen Eintrag. Ungültiges wird abgelehnt, nichts wird gespeichert.

Felder
FeldTypBedeutung
notificationsobjectoptionalz. B. {"email_to": ["team@hotel.de"], "mode": "live"}
PUT/v1/admin/hotels/{slug}/configput_hotel_config

Einstellungen vollständig ersetzen.

PUT/v1/admin/hotels/{slug}/pms_connectionput_pms_connection

PMS-Zugang hinterlegen. Der Schlüssel wird verschlüsselt gespeichert und nie zurückgegeben; ohne api_key bleibt der gespeicherte erhalten.

Felder
FeldTypBedeutung
pms_typestringPflichtz. B. 3rpms
endpointstringPflichthttps-Adresse des PMS, z. B. https://www.3rpms.de/graphql
api_keystringoptionalPMS-Schlüssel. Nur schreiben.
write_modestring · disabled | dry_run | liveoptionaldry_run = Buchungen simuliert.

Gesprächsbeginn

POST/v1/initiationconversation_initiation

Optional ElevenLabs conversation initiation webhook: the start variables of the hotel (e.g. first_message).

Felder
FeldTypBedeutung
agent_idstringPflicht
conversation_idstringoptional

Betrieb

GET/healthhealth

Liveness check.

Erzeugt aus den Tool-Definitionen (scripts/openapi.py). Version 1.0.0 · 29 Adressen