Loading documentation...
Diagnose and resolve common operational errors based on real application states.
Problem: Adding a custom domain under Agency or Website Widget fails with:
TXT verification record not found. Expected record: "operator-verify=..."
Causes & Solutions:
1. DNS Propagation Delay: DNS TXT records can take 5 to 60 minutes to propagate globally. Wait 15 minutes and click Verify again.
2. Incorrect Host Record: Ensure the TXT record is placed at the exact root or subdomain hostname configured in Operator.
3. Record Value: Verify the record string begins with operator-verify= followed by your exact token.
Problem: Phone calls receive a hangup message or WhatsApp messages return HTTP 401 Unauthorized.
Causes & Solutions:
1. Twilio Auth Token Mismatch: Check that TWILIO_AUTH_TOKEN in your .env matches the exact token in your Twilio Console for that Account SID.
2. Proxy Host Headers: If deployed behind a reverse proxy or cloud load balancer, verify that x-forwarded-host and x-forwarded-proto are preserved.
3. Meta Webhook Secret: Ensure META_APP_SECRET matches your Meta App Secret in Developer Settings.
Problem: Website Import returns *"We couldn't crawl this webpage"* or blocks ingestion.
Causes & Solutions:
1. SSRF Rejection: Operator strictly blocks localhost (127.0.0.1), internal IPs (192.168.x), and non-public hostnames for security.
2. Cloudflare / Bot Protection: If your website has strict anti-bot shields (e.g., Cloudflare Under Attack mode), the crawler may be blocked. Temporarily allowlist the Operator server user agent or upload documents via PDF/DOCX instead.
3. Deep SPA JavaScript: Pages that require client-side execution to render text should be uploaded as PDF or Markdown text.
Problem: AI tells callers *"There are no available slots"* even though you appear free.
Causes & Solutions:
1. Operating Hours Closed: Check Profile > Operating Hours to verify that day is not marked closed: true.
2. Staff Schedule Missing: Verify that at least one staff member certified for that service has an active schedule in Staff > Rostering (/staff).
3. Buffer Times Overlap: Check if pre- or post-service buffer times (e.g., 30 min buffer) overlap adjacent appointments.
4. Notice Hours: Verify the booking time does not violate the minimum advance notice rule (e.g., 2 hours).
Problem: Messages or calls are paused with status UPGRADE_REQUIRED.
Solution:
Navigate to Billing (/billing) and review your active usage counters. If you have reached your monthly conversation or voice minute quota, click Upgrade Plan to switch to Professional or Business tier.