Terminart-ID finden
Finden Sie Ihre Terminart-ID für API-Integrationen, Webhooks und erweiterte Konfigurationen
Die Terminart-ID ist eine eindeutige Kennung für jede Ihrer Terminarten. Sie benötigen sie beim Einrichten von API-Integrationen, Konfigurieren von Webhooks oder Verwenden erweiterter Funktionen.
Wo Sie die Terminart-ID finden
Methode 1: URL-Leiste (Am einfachsten)
Die Terminart-ID ist in der Adressleiste Ihres Browsers sichtbar, wenn Sie eine Terminart bearbeiten.
- Gehen Sie zu Terminarten
- Klicken Sie auf eine Terminart, um sie zu bearbeiten
- Schauen Sie auf die URL in Ihrem Browser:
https://app.meetergo.com/meeting-types/edit/abc12345-6789-def0-1234-567890abcdef
└──────────────────────────────────────┘
Das ist Ihre Terminart-ID
Die ID ist die Zeichenkette nach /edit/ – typischerweise im UUID-Format wie abc12345-6789-def0-1234-567890abcdef.
Methode 2: Buchungs-Weiterleitungsparameter
Bei Verwendung von Weiterleitungs-URLs nach der Buchung hängt meetergo automatisch die Terminart-ID an:
https://ihreseite.de/danke?meetingTypeId=abc12345-6789-def0-1234-567890abcdef
Wenn Sie eine Weiterleitungs-URL eingerichtet haben, prüfen Sie die übergebenen Parameter, um Ihre ID zu finden.
Methode 3: API-Antwort
Beim Abrufen von Terminarten über die API enthält jede Terminart ihre ID:
{
"id": "abc12345-6789-def0-1234-567890abcdef",
"name": "30-Minuten-Beratung",
"duration": 30,
...
}
Siehe API-Dokumentation für Details.
Methode 4: Webhook-Payloads
Bei Buchungen enthalten Webhook-Payloads die Terminart-ID:
{
"event": "booking_created",
"data": {
"meetingTypeId": "abc12345-6789-def0-1234-567890abcdef",
"appointmentId": "...",
...
}
}
Wann Sie die Terminart-ID benötigen
API-Integrationen
Beim Erstellen von Buchungen über die API:
curl -X POST "https://api.meetergo.com/v4/booking" \
-H "Content-Type: application/json" \
-d '{
"meetingTypeId": "abc12345-6789-def0-1234-567890abcdef",
"start": "2025-01-15T10:00:00Z",
"attendee": { ... }
}'
Webhook-Konfiguration
Webhooks nach Terminart filtern:
app.post('/webhook', (req, res) => {
const { meetingTypeId } = req.body.data;
if (meetingTypeId === 'abc12345-...') {
// Bestimmte Terminart behandeln
}
});
Slack-Integration
Beim Zuordnen von Terminarten zu Slack-Kanälen referenzieren Sie Terminart-IDs in Ihrer Konfiguration.
Benutzerdefinierte Integrationen
Verwenden Sie die ID, um:
- Buchungen pro Terminart zu verfolgen
- Benachrichtigungen unterschiedlich zu routen
- Benutzerdefinierte Dashboards zu erstellen
- Zapier-Workflows zu erstellen
ID-Format
Terminart-IDs in meetergo sind UUIDs (Universally Unique Identifiers):
- Format:
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx - Beispiel:
abc12345-6789-def0-1234-567890abcdef - Immer Kleinbuchstaben und Zahlen
- 36 Zeichen insgesamt (einschließlich Bindestriche)
Tipps
IDs sicher aufbewahren
Obwohl Terminart-IDs nicht so sensibel wie API-Schlüssel sind, vermeiden Sie es, sie öffentlich zu teilen, wenn Ihre Terminarten privat sind.
IDs ändern sich nicht
Einmal erstellt, ändert sich die ID einer Terminart nie – auch wenn Sie die Terminart umbenennen oder ihre Einstellungen ändern.
Sorgfältig kopieren
Beim Kopieren aus der URL-Leiste stellen Sie sicher, dass Sie die vollständige ID ohne nachfolgende Schrägstriche oder Query-Parameter erfassen.
FAQ
Kann ich meine Terminart-ID anpassen?
Nein, IDs werden automatisch generiert und können nicht geändert werden.
Behält das Löschen und Neuerstellen einer Terminart dieselbe ID?
Nein, eine neue Terminart erhält eine neue ID. Aktualisieren Sie alle Integrationen, wenn Sie eine Terminart neu erstellen.
Ist die Terminart-ID dasselbe wie der Buchungslink-Slug?
Nein, der Buchungslink-Slug (z.B. /ihrname/beratung) unterscheidet sich von der internen ID. Der Slug ist lesbar für Menschen; die ID ist für Systemzwecke.
Verwandte Artikel
War dieser Artikel hilfreich?
Lass uns wissen, ob dieser Artikel deine Fragen beantwortet hat.