meetergo mit dem IONOS KI-Telefonassistenten verbinden

Der IONOS KI-Telefonassistent kann deine Rufnummer entgegennehmen, verstehen, was die anrufende Person möchte, und während des Gesprächs über REST-APIs mit externen Systemen kommunizieren. Mit ein paar Konfigurationsschritten verbindest du ihn mit meetergo, sodass der Assistent in Echtzeit deine Verfügbarkeit prüft und Termine bucht — ganz ohne E-Mail-Adresse.

API-Integrationen sind auf den IONOS-Tarifen KI-Telefonassistent L und KI-Telefonassistent All-Flat Advanced verfügbar. Auf meetergo-Seite brauchst du einen Personal Access Token und mindestens eine Terminseite.

Nutze für diese Integration einen Personal Access Token, keinen Platform-API-Schlüssel. Wenn du unsicher bist, welchen der beiden du in der Hand hast, lies Welchen Zugang brauche ich?.

Was du damit erreichst

Sobald die Integration läuft, kann der Assistent:

Anrufenden die freien Zeiten für eine bestimmte Terminseite in den nächsten Tagen nennen
Name und Telefonnummer der Anrufenden im Gespräch erfragen
Eine bestätigte Buchung direkt aus dem Anruf in meetergo anlegen
Eine SMS-Bestätigung auslösen statt einer E-Mail (Telefonnummern lassen sich am Telefon deutlich besser aufnehmen als E-Mail-Adressen)

Bevor du startest

Du brauchst:

Einen IONOS-Tarif, der API-Integrationen unterstützt (KI-Telefonassistent L oder All-Flat Advanced)
Einen meetergo Personal Access Token — wie du einen erstellst, erfährst du unter Personal Access Token
Deine meetergo User-ID, die du über GET https://api.meetergo.com/v4/user/me abfragen kannst
Die Terminseiten-ID, auf die der Assistent buchen soll (sichtbar in der URL, wenn du eine Terminseite bearbeitest: https://my.meetergo.com/meeting-types/{meetingTypeId}/edit)
Die Telefon-Only-Buchung für diese Terminseite aktiviert, damit der Assistent ohne E-Mail buchen kann

Unser ausführliches Entwickler-Rezept — inklusive Beispielcode und Gesprächsablauf — findest du unter developer.meetergo.com/developer-docs/recipes/voice-ai-bot. Dieser Artikel zeigt dir die konkreten Werte, die du im IONOS-Dialog einfügen musst.

Schritt 1 — Terminseite in meetergo vorbereiten

Der Telefonassistent sollte auf eine eigene Terminseite buchen, damit er dein normales Buchungsformular nicht stört.

Öffne Terminseiten in deinem meetergo-Dashboard
Lege eine neue Terminseite an (z. B. Telefon-Beratung) oder wähle eine bestehende
Kopiere die Terminseiten-ID aus der URL — du brauchst sie später in der IONOS-Anfrage
Öffne Erweitert → Kern-Buchungseinstellungen und aktiviere die Telefon-Only-Buchung, damit der Assistent ohne E-Mail-Adresse buchen darf
Richte einen Workflow mit dem Auslöser Buchungsbestätigung und der Aktion SMS an Teilnehmer senden ein — so erhält die anrufende Person eine Bestätigung, obwohl keine E-Mail verschickt wird

Ohne aktivierte Telefon-Only-Buchung lehnt meetergo die Anfrage mit 400 Bad Request ab, weil der Teilnehmer keine E-Mail-Adresse hat.

Schritt 2 — meetergo-Zugangsdaten besorgen

Erzeuge einen Personal Access Token unter Integrationen & Apps und speichere ihn sicher ab — er wird nur ein einziges Mal angezeigt
Rufe GET https://api.meetergo.com/v4/user/me mit diesem Token als Bearer-Header auf und notiere das id-Feld — diesen Wert trägst du später in jeden IONOS-Request als x-meetergo-api-user-id-Header ein

Schritt 3 — Integrationen in IONOS anlegen

Öffne im IONOS-Kontrollbereich Menü → KI-Telefonassistent → API-Integrationen und klicke auf + Integration hinzufügen. Du legst zwei Integrationen an: eine zur Verfügbarkeitsprüfung und eine zum Buchen.

Jede IONOS-Integration besteht aus zwei JSON-Blöcken:

Parameters (JSON Schema) — die Informationen, die der Assistent vom Anrufer erfragen muss, bevor die Anfrage gesendet wird
Request Definition (HAR JSON) — der eigentliche HTTP-Call; {{ variableName }}-Platzhalter werden zur Laufzeit durch die gesammelten Parameter ersetzt

Nutze am besten den Experten-Modus (oben rechts im Integrations-Dialog), damit du die Snippets unten direkt einfügen kannst.

Gib deinen Personal Access Token oder deine User-ID niemals in ein externes LLM ein, wenn du die "LLM-gestützte Einrichtung" verwendest. Trage geheime Daten ausschließlich im IONOS-Dialog ein.

Integration A — Verfügbarkeit prüfen

Name: check_meetergo_availability

Beschreibung (sagt dem Assistenten, wann er das Tool nutzen soll):

Rufe dieses Tool auf, um freie Termine in meetergo zwischen zwei Daten abzufragen. Nutze es, sobald die anrufende Person einen Termin wünscht, damit du in Echtzeit Vorschläge machen kannst. Gib Datumswerte immer im Format YYYY-MM-DD an und frage maximal 14 Tage im Voraus ab.

Parameter (JSON Schema):

{
  "type": "object",
  "properties": {
    "startDate": {
      "type": "string",
      "description": "Erster zu prüfender Tag im Format YYYY-MM-DD (z. B. 2026-05-01)."
    },
    "endDate": {
      "type": "string",
      "description": "Letzter zu prüfender Tag im Format YYYY-MM-DD. Maximal 14 Tage nach startDate."
    }
  },
  "required": ["startDate", "endDate"]
}

Request Definition (HAR JSON):

{
  "method": "GET",
  "url": "https://api.meetergo.com/v4/booking-availability?meetingTypeId=YOUR_MEETING_TYPE_ID&start={{ startDate }}&end={{ endDate }}",
  "headers": [
    { "name": "Authorization", "value": "Bearer YOUR_API_KEY" },
    { "name": "x-meetergo-api-user-id", "value": "YOUR_USER_ID" },
    { "name": "Content-Type", "value": "application/json" }
  ]
}

Ersetze die drei Platzhalter durch deine echten Werte:

YOUR_MEETING_TYPE_ID — die Terminseite aus Schritt 1
YOUR_API_KEY — der Personal Access Token aus Schritt 2
YOUR_USER_ID — die id, die /v4/user/me zurückgibt

Integration B — Termin buchen

Name: book_meetergo_appointment

Beschreibung:

Rufe dieses Tool auf, sobald die anrufende Person einen der von check_meetergo_availability zurückgegebenen Zeitpunkte ausgewählt hat. Bestätige die Auswahl immer mündlich, bevor du das Tool aufrufst. Die Telefonnummer muss im internationalen E.164-Format vorliegen (z. B. +491701234567).

Parameter (JSON Schema):

{
  "type": "object",
  "properties": {
    "startTime": {
      "type": "string",
      "description": "ISO-8601-Zeitstempel des gewählten Slots, z. B. 2026-05-02T09:30:00.000Z. Muss einer der Slots sein, die check_meetergo_availability zurückgegeben hat."
    },
    "callerName": {
      "type": "string",
      "description": "Vollständiger Name der anrufenden Person."
    },
    "callerPhone": {
      "type": "string",
      "description": "Telefonnummer der anrufenden Person im E.164-Format, z. B. +491701234567."
    }
  },
  "required": ["startTime", "callerName", "callerPhone"]
}

Request Definition (HAR JSON):

{
  "method": "POST",
  "url": "https://api.meetergo.com/v4/booking",
  "headers": [
    { "name": "Authorization", "value": "Bearer YOUR_API_KEY" },
    { "name": "x-meetergo-api-user-id", "value": "YOUR_USER_ID" },
    { "name": "Content-Type", "value": "application/json" }
  ],
  "postData": {
    "mimeType": "application/json",
    "text": "{\"meetingTypeId\":\"YOUR_MEETING_TYPE_ID\",\"start\":\"{{ startTime }}\",\"phoneOnlyBooking\":true,\"attendees\":[{\"fullname\":\"{{ callerName }}\",\"phone\":\"{{ callerPhone }}\"}]}"
  }
}

Klicke für jede Integration auf Übernehmen und anschließend oben im Dialog auf Änderungen speichern.

Schritt 4 — End-to-End testen

Rufe deine IONOS-Nummer an und bitte um einen Termin an einem bestimmten Tag
Der Assistent sollte dir echte Slots vorlesen — die kommen live aus meetergo
Bestätige einen der Slots; der Assistent fragt deinen Namen und deine Telefonnummer ab
Lege auf und öffne die Terminübersicht — die neue Buchung sollte sofort erscheinen
Prüfe dein Telefon auf die SMS-Bestätigung aus dem Workflow, den du in Schritt 1 angelegt hast

Fehlerbehebung

Der Assistent sagt "Keine Termine verfügbar"

Prüfe, ob die Terminseite für die abgefragten Tage überhaupt Verfügbarkeiten hat
Achte darauf, dass der Zeitraum in der Zukunft liegt und nicht mehr als 14 Tage umfasst
Kontrolliere, dass die meetingTypeId in der URL mit der Terminseite übereinstimmt

meetergo antwortet mit `400 Bad Request`

Die Telefon-Only-Buchung muss für die Terminseite aktiviert sein
Die Telefonnummer muss im E.164-Format vorliegen (beginnt mit + und Ländervorwahl)
Der angefragte start-Zeitpunkt muss einer der zuvor gelieferten Slots sein

meetergo antwortet mit `401 Unauthorized`

Der Personal Access Token fehlt, ist abgelaufen oder wurde widerrufen
Der x-meetergo-api-user-id-Header passt nicht zum Besitzer des Tokens

Der Assistent beendet den Anruf abrupt

IONOS legt auf, sobald ein API-Endpunkt einen Fehler liefert. Wiederhole den Testanruf, schau dir im IONOS-Anrufprotokoll die HTTP-Antwort an und beseitige die Ursache in meetergo (meist fehlt die Telefon-Only-Buchung oder die Terminseiten-ID stimmt nicht).

FAQ

Kann der Assistent bestehende Buchungen stornieren oder verschieben?

Das oben beschriebene Rezept deckt nur das Abfragen der Verfügbarkeit und das Anlegen neuer Buchungen ab. Für Stornierungen und Verschiebungen gibt es eigene meetergo-Endpunkte — wenn du die Integration erweitern möchtest, meldet sich unser Support gerne bei dir.

Kann ein Assistent auf mehrere Terminseiten buchen?

Ja. Lege je Terminseite eine eigene IONOS-Integration an (z. B. Beratung vs. Support-Call), vergib pro Tool einen eindeutigen Namen und eine klare Beschreibung — das LLM wählt anhand des Gesprächsinhalts automatisch das passende Tool.

Berechnet meetergo extra für telefonische Buchungen?

Nein. Über die API erstellte Buchungen zählen genauso wie Buchungen über deine normalen Buchungslinks. Dein IONOS-Tarif sowie eventuelle SMS-Kosten aus deinem Workflow werden separat abgerechnet.

Passende Artikel