Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Spezifikation für Restaurantreservierungen

Schnittstellenvorgaben für die Integration eines Reservierungsplugins in den Reservierungsablauf von ChatGPT.

Plugins für Restaurantreservierungen in ChatGPT befinden sich derzeit in der Betaphase. Wir testen sie mit zugelassenen Partnerunternehmen. Um Zugang zu beantragen, fülle das Formular aus:

Zugang beantragen

Ziel

ChatGPT soll Plugins von Partnerunternehmen direkt aufrufen können, wenn jemand ein konkretes Vorhaben hat, etwa einen Tisch im Restaurant zu reservieren.

Sobald uns ein Partnerunternehmen einen Feed für die Suche bereitstellt, können wir seine MCP-Server anbinden, damit aus einer Suche eine Reservierung werden kann. Dafür müssen die Plugins einheitliche Vorgaben für den Widget-Namen, den Tool-Namen und die Eingabedaten des Tools einhalten.

Wenn du ein Plugin nach dieser Spezifikation entwickeln möchtest, beantrage den Zugang über das ChatGPT-Formular für Handelsunternehmen.

Reservierungen aus Sicht der Nutzenden

Wer nach Restaurants in der Nähe sucht, sieht auf der Restaurantkarte und in der Seitenleiste die Schaltfläche „Reservieren“. Darüber lässt sich die Oberfläche des Reservierungsdienstes öffnen, den das Restaurant nutzt.

Schaltfläche „Reservieren“ in der Restaurantansicht:

Schaltfläche „Reservieren“ in der Restaurantansicht

Reservierungsdialog, der sich über die Schaltfläche öffnet:

Über die Schaltfläche „Reservieren“ geöffneter Reservierungsdialog

Aktuelle Schnittstellenvorgaben

Für die Reservierungsintegration sind derzeit nur folgende Namen vorgeschrieben:

  • Widget-Name: ui://widget/restaurant-reservation.html
  • Tool-Name: restaurant_reservation

restaurant_reservation muss folgenden Wert setzen:

_meta.ui.resourceUri = "ui://widget/restaurant-reservation.html";

Für jedes Tool, das direkt aus einem Widget aufgerufen wird, musst du folgenden Wert setzen:

_meta["openai/widgetAccessible"] = true;

Eingabedaten für restaurant_reservation

Diese Mindestangaben senden wir bei jedem Aufruf:

{
  "restaurant_id": "string"
}

Möglicherweise senden wir auch die folgenden Daten. Damit kannst du Inhalte im Reservierungsdialog schon vorab anzeigen, etwa um Platzhalter oder Ladeanzeigen zu vermeiden, während die Daten geladen werden:

{
  "restaurant_name": "string",
  "restaurant_image": "string",
  "restaurant_address": {
    "address": "string",
    "city": "string",
    "state": "string",
    "zipcode": "string",
    "country": "string"
  }
}

Anforderungen an den Feed für die Suchintegration

Damit die Schaltfläche „Reservieren“ zum richtigen Reservierungsdienst führt, lesen wir einen Feed mit Geschäftseinträgen der Partnerunternehmen ein.

Zweck und Umfang

Die Spezifikation für den Feed legt Folgendes fest:

  • Welche Geschäftsdaten wir mindestens benötigen, um Einträge abzugleichen und Suchergebnisse zu sortieren.
  • Eine API zum seitenweisen Abruf der Einträge.
  • Wie wir Änderungen erkennen, damit wir den Feed nur bei Bedarf vollständig abrufen.

Geschäftseintrag (Pflichtfelder)

Ein Business-Objekt muss folgende Felder enthalten:

  • id (string): stabile, beim jeweiligen Anbieter eindeutige Kennung.
  • name (string)
  • address (object oder formatierter string)
  • location (object mit Breiten- und Längengrad)
  • phone_number (string, vorzugsweise im E.164-Format)
  • website_url (string, URL)
  • platform_url (string, URL des kanonischen Eintrags auf deiner Plattform)

Empfohlene Mindeststruktur:

{
  "id": "biz_123",
  "name": "Acme Coffee",
  "address": {
    "line1": "123 Market St",
    "line2": "Suite 5",
    "locality": "San Francisco",
    "region": "CA",
    "postal_code": "94105",
    "country": "US",
    "formatted": "123 Market St, Suite 5, San Francisco, CA 94105, US"
  },
  "location": {
    "latitude": 37.793,
    "longitude": -122.396
  },
  "phone_number": "+14155551234",
  "website_url": "https://acmecoffee.example",
  "platform_url": "https://provider.example/biz/biz_123"
}

Wenn die einzelnen Adressbestandteile nicht strukturiert vorliegen, darf address die gesamte Adresse als formatierte Zeichenfolge enthalten. Das Format muss einheitlich und für Menschen gut lesbar sein.

Endpunkt für den seitenweisen Abruf

Beispiel für einen Endpunkt:

  • GET /v1/businesses

Abfrageparameter:

  • Wähle für die Paginierung eine der folgenden Varianten:
  • page + page_size
  • offset + limit
  • oder next_page_token (opakes Token, bevorzugte Variante, sofern unterstützt)
  • changes_token (string, optional): Dient dazu, Änderungen seit dem letzten Synchronisationsstand zu erkennen.

Die Antwort muss Folgendes enthalten:

  • checksum (boolean): Gibt an, ob sich seit dem mit changes_token angegebenen Stand etwas geändert hat. Ohne Token ist der Wert true.
  • businesses (Business[]): Geschäftseinträge der aktuellen Seite.
  • Metadaten zur Paginierung, je nach gewählter Variante:
  • page, page_size, total_pages (optional) oder
  • offset, limit, total (optional) oder
  • next_page_token (string | null)

Beispiel für Anfrage und Antwort

Anfrage:

GET /v1/businesses?page=1&page_size=2&changes_token=sync_2026_03_10

Antwort:

{
  "checksum": true,
  "page": 1,
  "page_size": 2,
  "total_pages": 120,
  "businesses": [
    {
      "id": "biz_123",
      "name": "Acme Coffee",
      "address": {
        "line1": "123 Market St",
        "locality": "San Francisco",
        "region": "CA",
        "postal_code": "94105",
        "country": "US",
        "formatted": "123 Market St, San Francisco, CA 94105, US"
      },
      "location": {
        "latitude": 37.793,
        "longitude": -122.396
      },
      "phone_number": "+14155551234",
      "website_url": "https://acmecoffee.example",
      "platform_url": "https://provider.example/biz/biz_123"
    },
    {
      "id": "biz_124",
      "name": "Golden Diner",
      "address": "200 Howard St, San Francisco, CA 94105, US",
      "location": {
        "latitude": 37.789,
        "longitude": -122.391
      },
      "phone_number": "+14155559876",
      "website_url": "https://goldendiner.example",
      "platform_url": "https://provider.example/biz/biz_124"
    }
  ]
}

So nutzen wir den Feed für die Suche

Wir verwenden den Feed mit den Geschäftseinträgen als Suchindex. Bei jeder Suchanfrage ermitteln wir mögliche Treffer durch einen unscharfen Abgleich des Namens und des Standorts oder der Adresse. Anschließend sortieren wir die Treffer und entfernen Duplikate. Dafür prüfen wir, wie ähnlich sich Namen und Adressen sind, und berücksichtigen zusätzlich Standort, Telefonnummer und URL.

Empfohlene Erweiterungen (derzeit optional)

Damit sich die Reservierung vollständig im Chat abschließen lässt, empfehlen wir, folgende Tools hinzuzufügen:

  • refresh_availability
  • make_reservation
  • reservation_confirmation