Troubleshooting

Plugin cannot be activated

Symptom: «Fatal error» or white screen on activation.

• Free ZIP: Must not contain a pro/ folder (WordPress.org build).
• Pro ZIP: Only one KITech booking plugin at a time — no second plugin with identical KITech_* classes.
• Memory: PHP memory_limit at least 128M.
• Debug: Enable WP_DEBUG_LOG in wp-config.php and check wp-content/debug.log.

Shortcode / form missing

• Shortcode: [meetflow_booking] (legacy: [kitech_booking]).
• Block editor: use the «Shortcode» block, not plain text in an HTML block.
• Theme must load wp_footer() (JavaScript for slots).
• Console (F12): errors on /wp-json/meetflow/v1/timeslots?

No time slots / «No available time slots»

• Business hours: MeetFlow → Settings → General — weekday enabled?
• MeetFlow → Calendar: day not blocked?
• Date in the future, WordPress timezone correct?
• Booking duration fits in the configured block (e.g. 15 min in 09:00–12:00).
• Test REST: /wp-json/meetflow/v1/timeslots?date=2026-07-15

Email & ICS

• Free: emails via wp_mail — SMTP plugin recommended (FluentSMTP, WP Mail SMTP).
• Settings → Email: notification address, distribution list, admin copy, reminders (Free & Pro).
• Distribution list: comma-separated addresses — receive admin copies and reminder copies.
• Spam: check SPF/DKIM for sender domain.
• No mail: check server mail() / SMTP log, test with «Send email» in SMTP plugin.

Pro / license

• Free must be active, then install Pro ZIP with pro/ folder.
• MeetFlow → License → enter key → «Activate».
• Domain limit: license only for registered domain(s) — check holder domain.
• API reachable: api.kitech.ai (firewall/outbound HTTPS).
• Video Conference / SMS tabs appear only with valid Pro license.

OAuth / Redirect URI mismatch

• Copy redirect URL exactly from MeetFlow → Video Conference.
• Parameter auth=zoom|google|webex|microsoft must match.
• Do not add/remove trailing slash.
• Google: enter Authorized redirect URIs in Cloud Console.
• Zoom: app must be «Activated», correct scopes.
• After error: Disconnect → save credentials → Connect again.

Meeting link not created

• Pro license active?
• Provider selected as «Active provider» and connected (green status)?
• Test booking in admin under MeetFlow → Bookings — Meeting URL column?
• Teams: admin consent granted? Zoom: Pro account?

SMS / Twilio

• SMS Reminder tab: sms_reminder_enabled or sms_on_booking active?
• Twilio SID, token, sender number (+E.164) correct.
• Twilio Console → Logs: error code 21211 = invalid number.
• Custom API: URL in custom_sms_api_url reachable?

WhatsApp webhook

• Requires «5 Sites» or Agency license.
• Webhook: https://YOUR-DOMAIN/wp-json/meetflow/v1/whatsapp/webhook
• Verify Token in MeetFlow = Meta Developer Console.
• Permalinks not «Plain» — otherwise REST 404.

REST API 404 / JSON errors

• Re-save permalinks.
• Security plugin blocking /wp-json/? Add whitelist.
• Test: GET /wp-json/meetflow/v1/timeslots?date=2026-08-01

Cache & theme conflicts

• Test with default theme (Twenty Twenty-Four).
• Page builder: embed shortcode in native WP page.
• Disable minify/combine JS for admin and frontend scripts.
• Design tweaks: Settings → Design → Custom CSS instead of patching theme files (Free & Pro).

Translations / wrong language

Symptom: MeetFlow stays English or shows mixed languages.

• Site language: Settings → General → Site Language.
• Admin language: Users → Profile → Language (overrides in wp-admin).
• Polylang/WPML: Place shortcode on the correct language page; switch language and reload.
• Loco Translate: text domain kitech-meetflow — clear cache after edits.
• Old ZIP: Free/Pro 2.2.9+ includes complete languages/*.mo (de, fr, it).
• Pro uses the same free core — no separate Pro translation pack.

Details: Documentation — languages