TattooTermine Integrations

Записи через ChatGPT і Claude

Адміністратор календаря Studio або Studio Pro може підключити асистента. Знайдіть TattooTermine у каталозі асистента, натисніть «Підключити», увійдіть у TattooTermine та оберіть підкалендарі. Дозвольте створювати записи, якщо плануєте записувати клієнтів із чату.

Наприклад, попросіть записати Алекса на 60-хвилинну консультацію в п’ятницю о 14:00. Асистент врахує часовий пояс календаря. TattooTermine перевірить накладки й налаштовані перерви перед збереженням. Посилання в чаті відкриє створений запис.

Керуйте доступом у налаштуваннях календаря в розділі «Інтеграції». Там можна відключити ChatGPT або Claude. Політика конфіденційності

Termine über ChatGPT und Claude buchen

Administratoren eines Kalenders mit Studio oder Studio Pro können den Assistenten verbinden. Suchen Sie TattooTermine im Verzeichnis des Assistenten, wählen Sie „Verbinden“, melden Sie sich bei TattooTermine an und wählen Sie die Unterkalender aus. Erlauben Sie das Erstellen von Terminen, wenn Sie aus dem Chat buchen möchten.

Bitten Sie den Assistenten zum Beispiel, Alex am Freitag um 14:00 Uhr für eine 60-minütige Beratung einzutragen. Der Assistent verwendet die Zeitzone des Kalenders. TattooTermine prüft Überschneidungen und konfigurierte Pausen. Über den Link im Chat öffnen Sie den gespeicherten Termin.

Die Verbindung können Sie in den Kalender-Einstellungen unter „Integrationen“ trennen. Datenschutzerklärung

Book appointments from ChatGPT and Claude

A TattooTermine calendar administrator on Studio or Studio Pro can connect an assistant. Find TattooTermine in the assistant’s directory, select Connect, sign in to TattooTermine and choose the subcalendars to share. Allow appointment creation to book from the chat.

Try asking the assistant to book Alex for a 60-minute consultation on Friday at 14:00. It will use the calendar’s time zone. TattooTermine checks for scheduling conflicts and configured breaks before saving. The assistant can link to the saved appointment.

Disconnect ChatGPT or Claude at any time in Integrations in your calendar settings. Privacy policy · Contact support

API та вебхуки

У налаштуваннях календаря відкрийте «Інтеграції», виберіть підкалендарі й збережіть ключ. Якщо вказали HTTPS-адресу, збережіть також секрет підпису та натисніть «Надіслати тест». Результат з’явиться в журналі доставок.

API повертає ID, час і статус записів, включно з повтореннями. Для вебхука дані запису можна звірити через API за полем target. Якщо змінено серію, перечитайте потрібний період. Повідомлення можуть прийти повторно або в іншій послідовності, тому зберігайте deliveryId і звіряйте поточний стан.

API und Webhooks

Öffnen Sie „Integrationen“ in den Kalendereinstellungen, wählen Sie die Unterkalender aus und speichern Sie den API-Schlüssel. Bei einer HTTPS-Webhook-Adresse speichern Sie auch das Signaturgeheimnis. Verwenden Sie „Test senden“ und prüfen Sie das Zustellprotokoll.

Die API liefert Kennung, Zeit und Status einschließlich Wiederholungen. Gleichen Sie Webhook-Änderungen über target ab. Bei Serienänderungen lesen Sie den relevanten Zeitraum erneut. Zustellungen können wiederholt oder in anderer Reihenfolge eintreffen. Speichern Sie deliveryId und prüfen Sie den aktuellen Stand.

API and webhooks

Open Integrations in calendar settings, select subcalendars and save the API key. For an HTTPS webhook, save the signing secret, send a test and check the delivery history.

The API returns event identifiers, times and status, including recurring occurrences. Match a webhook to events using target. For a series change, read the affected window again. Messages can be repeated or arrive out of order. Deduplicate on deliveryId and check the current API state.

Read calendar data

curl -H "Authorization: Bearer $TATTOOTERMINE_API_KEY" \
  "https://app.tattootermine.com/api/integrations/v1/calendars"

curl -H "Authorization: Bearer $TATTOOTERMINE_API_KEY" \
  "https://app.tattootermine.com/api/integrations/v1/events?from=2026-12-01T00:00:00Z&to=2026-12-08T00:00:00Z"

Dates are UTC and the end is exclusive. Use windows of up to 31 days. Narrow the window if the API returns 422. On 429, wait for Retry-After seconds. Studio allows 60 requests per minute per key and Studio Pro allows 240.

For the current state of one record, pass the JSON target from a response or webhook as a URL-encoded query value.

curl --get -H "Authorization: Bearer $TATTOOTERMINE_API_KEY" \
  --data-urlencode 'target={"kind":"appointment","appointmentId":"event-id"}' \
  "https://app.tattootermine.com/api/integrations/v1/event"

A missing, removed or out-of-scope event returns 404. Use a range to reconcile changes to a whole series.

target is { "kind": "appointment", "appointmentId": "…" } or { "kind": "occurrence", "seriesId": "…", "originalStartsAt": "…" }. Events include calendarIds, startsAt, endsAt, status and allDay. All-day records include local calendar dates with an exclusive end date. A record assigned to several subcalendars is visible when the connection has access to all its assignments.

Receive webhooks

Supported types are event.created, event.rescheduled, event.cancelled, event.removed and test. A removal also covers a record moving outside the connection’s scope. A record entering the scope is reported as created. scope indicates one event (single), a series from a date (future, with from), or the whole series (all).

{
  "version": 1,
  "deliveryId": "delivery-uuid",
  "changeId": "change-uuid",
  "type": "event.rescheduled",
  "calendarId": "studio-calendar-id",
  "subcalendarIds": ["selected-subcalendar-id"],
  "target": { "kind": "appointment", "appointmentId": "event-id" },
  "scope": "single",
  "occurredAt": "2026-12-01T10:00:00.000Z"
}

Compute HMAC-SHA256 over timestamp + "." + rawBody using the signing secret. Read the Unix timestamp from X-TattooTermine-Timestamp, require it to be within five minutes, and compare the hex digest against X-TattooTermine-Signature (prefix v1=) with a constant-time comparison. Verify the raw bytes before parsing JSON. The X-TattooTermine-Delivery header matches deliveryId.

Return 2xx after accepting the message. Network failures, 408, 425, 429 and server errors can be retried. Redirects are rejected. Delivery history is available for seven days on Studio and 30 days on Studio Pro.