· 5 min · TextMeFlow Team

WhatsApp-Terminerinnerungen aus Calendly per Webhook

Calendly schickt eine Bestätigung per E-Mail, sobald jemand einen Termin bucht, und viele Unternehmen belassen es dabei – bis sich die Terminausfälle häufen. WhatsApp wird innerhalb weniger Minuten gelesen und landet nicht im Promotions-Tab. Wenn dein Calendly-Tarif Webhooks unterstützt, brauchst du weder Zapier noch Make als bezahlte Zwischenschicht: Ein kleiner Empfänger plus die TextMeFlow-API genügt für eine Bestätigung im Moment der Buchung und eine Erinnerung am Vortag.

Warum selbst bauen, statt eine App zu nutzen

Ein No-Code-Konnektor funktioniert, bringt aber ein eigenes Abo zusätzlich zu deiner WhatsApp-API-Rechnung mit, und du bist auf dessen Trigger-Logik und Verzögerungsoptionen festgelegt. Calendlys eigene Webhooks direkt mit TextMeFlow zu verbinden kostet nichts über deinen Nachrichtentarif hinaus, und du bestimmst genau, wann die Erinnerung rausgeht, was sie sagt und wie sie je Termintyp personalisiert wird. Für eine Fahrlehrerin, einen Berater oder eine Praxis mit lückenlos gebuchten Calendly-Slots ist das der Unterschied zwischen einer generischen Vorlage und einer Nachricht, die klingt, als wäre sie von Hand getippt.

Schritt 1: den Calendly-Webhook registrieren

Webhook-Abonnements legst du bei Calendly über deren API an (POST /webhook_subscriptions), bezogen auf deine Organisation oder einen einzelnen Nutzer. Abonniere die beiden Ereignisse, die für Erinnerungen zählen:

  • invitee.created → wird bei der Buchung ausgelöst – sende die Bestätigung
  • invitee.canceled → wird bei einer Stornierung ausgelöst – storniere jede geplante Erinnerung

Lass das Abonnement auf einen Endpunkt zeigen, den du kontrollierst, zum Beispiel https://yourapp.com/webhooks/calendly, und bewahre den Signaturschlüssel auf, den Calendly dir gibt: Jede Payload kommt mit einem Calendly-Webhook-Signature-Header an, den du prüfen musst, bevor du dem Body traut – dieselbe Sorgfalt, die TextMeFlow erwartet, wenn du die Signaturen der eigenen ausgehenden Webhooks verifizierst.

Schritt 2: die Buchung empfangen und die Bestätigung senden

Ein minimaler Node-Empfänger für den Bestätigungsteil:

app.post('/webhooks/calendly', express.json(), async (req, res) => {
  const event = req.body;
  if (event.event !== 'invitee.created') return res.status(200).send('ignored');

  const invitee = event.payload;
  const phone = invitee.text_reminder_number; // E.164, wenn SMS-Erinnerungen für den Termintyp aktiviert sind
  if (!phone) return res.status(200).send('no phone, skipped');

  const start = new Date(invitee.event.start_time);
  const when = start.toLocaleString('de-DE', { dateStyle: 'medium', timeStyle: 'short' });

  await sendWhatsApp(phone, `Hallo ${invitee.name}, dein Termin am ${when} ist bestätigt. Antworte mit STOP, um keine Erinnerungen mehr zu erhalten.`);
  res.status(200).send('ok');
});

Calendly liefert im Invitee-Datensatz nur dann eine Telefonnummer mit, wenn für den Termintyp SMS-Erinnerungen aktiviert sind und die Person sie angegeben hat – nicht jede Buchung enthält also eine. Überspring solche Fälle stillschweigend, statt einen Fehler zu werfen; Calendly wiederholt fehlgeschlagene Webhook-Antworten nicht wie Shopify, aber eine Häufung von 5xx-Fehlern kann trotzdem dazu führen, dass das Abonnement markiert wird.

Schritt 3: über die TextMeFlow-API senden

curl -X POST https://api.textmeflow.eu/v1/messages \
  -H "Authorization: Bearer $TEXTMEFLOW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+32470123456",
    "text": "Hallo Sarah, dein Termin am Di., 25. Aug., 14:30 Uhr ist bestätigt. Antworte mit STOP, um dich abzumelden."
  }'

Die Antwort ist ein 202 mit einer message_id, die du zur Calendly-event.uri loggen kannst. Das macht den nächsten Schritt – die Erinnerung – leicht planbar und bei Bedarf stornierbar.

Schritt 4: die Erinnerung am Vortag einplanen

Calendlys Webhook feuert zum Buchungszeitpunkt, nicht am Vortag. Die Erinnerung selbst braucht also einen geplanten Job auf deiner Seite: Speichere Termin und Telefonnummer, sobald invitee.created eintrifft, und lass einen Worker (einen Cronjob, eine Queue mit Verzögerung, was dein Stack schon mitbringt) die Erinnerung 24 Stunden vorher senden. Trifft invitee.canceled ein, bevor dieser Job läuft, markiere den gespeicherten Termin als storniert, damit der Worker ihn überspringt.

Schritt 5: innerhalb der Anti-Spam-Regeln bleiben

Bestätigungen und Erinnerungen sind eine personalisierte Nachricht pro Teilnehmer, kein identischer Inhalt, der an eine Liste gestreut wird – sie lösen deshalb nicht die Broadcast-Erkennung im Risiko-Score von TextMeFlow aus. Zwei Dinge sind bei einem Buchungsablauf trotzdem wichtig:

  1. STOP respektieren. Meldet sich ein Teilnehmer über WhatsApp ab, schreib ihn bei der nächsten Buchung nicht erneut an – TextMeFlow lehnt Sendungen an abgemeldete Empfänger automatisch ab.
  2. Telefonnummer normalisieren. Calendlys Feld text_reminder_number liegt je nach Eingabe nicht zwingend im E.164-Format vor – prüfe und formatiere sie um, bevor du die API aufrufst, sonst schlägt der Versand fehl.

Eine Erinnerung am selben Tag (jemand bucht einen Slot für später heute) ist ein Fall, in dem du die Ruhezeiten-Steuerung mit dem urgent-Flag umgehen möchtest – eine Bestätigung für einen Termin am selben Tag ist zeitkritisch, anders als ein gewöhnlicher Broadcast.

Was du damit gegenüber E-Mail gewinnst

E-Mail-Bestätigungen bleiben ungeöffnet; WhatsApp-Lesebestätigungen kommen über TextMeFlows eigenen Webhook zurück. Du weißt also innerhalb weniger Minuten, ob jemand die Erinnerung wirklich gesehen hat – und kannst ein Ausfallrisiko vor dem Termin erkennen, nicht danach. Dasselbe Muster funktioniert mit jedem Terminplanungstool, das ausgehende Webhooks bietet – Acuity, SimplyBook, ein eigenes Buchungsformular –, Calendly ist nur der häufigste Einstieg für Berater und Dienstleister.

Starte kostenlos mit TextMeFlow – 50 Nachrichten pro Monat, ohne Zeitlimit, genug, um einen kompletten Buchungsbestätigungs-Ablauf auszuprobieren, bevor du dich für einen Tarif entscheidest.

Selbst WhatsApp-Nachrichten per API senden?

Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.

Für immer gratis