Troubleshooting

Plugin lässt sich nicht aktivieren

Symptom: «Fatal error» oder weisse Seite bei Aktivierung.

• Free-ZIP: Darf keinen Ordner pro/ enthalten (WordPress.org-Build).
• Pro-ZIP: Nur ein KITech-Buchungsplugin gleichzeitig — kein zweites Plugin mit identischen KITech_*-Klassen.
• Speicher: PHP memory_limit mindestens 128M.
• Debug: In wp-config.php kurz WP_DEBUG_LOG aktivieren und wp-content/debug.log prüfen.

Shortcode / Formular fehlt

• Shortcode: [meetflow_booking] (Legacy: [kitech_booking]).
• Block-Editor: Block «Shortcode» verwenden, nicht als Plaintext in HTML-Block.
• Theme muss wp_footer() laden (JavaScript für Slots).
• Konsole (F12): Fehler bei /wp-json/meetflow/v1/timeslots?

Keine Zeitslots / «No available time slots»

• Geschäftszeiten: MeetFlow → Einstellungen → Allgemein — Wochentag aktiviert?
• MeetFlow → Kalender: Tag nicht gesperrt?
• Datum in der Zukunft, Zeitzone WordPress korrekt?
• Termindauer passt in den konfigurierten Block (z. B. 15 Min in 09:00–12:00).
• REST testen: /wp-json/meetflow/v1/timeslots?date=2026-07-15

E-Mail & ICS

• Free: Mails via wp_mail — SMTP-Plugin empfohlen (FluentSMTP, WP Mail SMTP).
• Tab «E-Mail»: Benachrichtigungs-Adresse, Verteiler, Admin-Kopie, Erinnerungen, Texte anpassen (Free & Pro).
• Verteiler: mehrere Adressen kommagetrennt — erhalten Admin-Kopien und Erinnerungs-Kopien.
• Spam: SPF/DKIM der Absender-Domain prüfen.
• Keine Mail: Server mail() / SMTP-Log prüfen, Test mit «E-Mail senden» im SMTP-Plugin.

Pro / Lizenz

• Free muss aktiv sein, dann Pro-ZIP mit pro/ installieren.
• MeetFlow → License → Key eingeben → «Activate».
• Domain-Limit: Lizenz nur für registrierte Domain(s) — Inhaber-Domain prüfen.
• API erreichbar: api.kitech.ai (Firewall/Outbound HTTPS).
• Tabs Video Conference / SMS erscheinen erst bei gültiger Pro-Lizenz.

OAuth / Redirect URI mismatch

• Redirect-URL exakt aus MeetFlow → Video Conference kopieren.
• Parameter auth=zoom|google|webex|microsoft muss übereinstimmen.
• Kein Slash am Ende hinzufügen/entfernen.
• Google: Authorized redirect URIs in Cloud Console eintragen.
• Zoom: App muss «Activated» sein, korrekte Scopes.
• Nach Fehler: Disconnect → Credentials speichern → erneut Connect.

Meeting-Link wird nicht erstellt

• Pro-Lizenz aktiv?
• Provider als «Active provider» gewählt und verbunden (grüner Status)?
• Testbuchung im Admin unter MeetFlow → Buchungen — Spalte Meeting-URL?
• Teams: Admin consent erteilt? Zoom: Pro-Account?

SMS / Twilio

• Tab SMS Reminder: sms_reminder_enabled oder sms_on_booking aktiv?
• Twilio SID, Token, Absender-Nummer (+E.164) korrekt.
• Twilio Console → Logs: Fehlercode 21211 = ungültige Nummer.
• Custom API: URL in custom_sms_api_url erreichbar?

WhatsApp Webhook

• Nur Lizenz «5 Lizenzen» / Agentur.
• Webhook: https://IHRE-DOMAIN/wp-json/meetflow/v1/whatsapp/webhook
• Verify Token in MeetFlow = Meta Developer Console.
• Permalinks nicht «Einfach» — sonst 404 auf REST.

REST API 404 / JSON-Fehler

• Permalinks neu speichern.
• Security-Plugin blockiert /wp-json/? Whitelist setzen.
• Test: GET /wp-json/meetflow/v1/timeslots?date=2026-08-01

Cache & Theme-Konflikte

• Mit Standard-Theme (Twenty Twenty-Four) testen.
• Page-Builder: Shortcode in native WP-Seite einbetten.
• Minify/Combine JS deaktivieren für Admin- und Frontend-Scripts.