Skip to main content

​
Docs Verification Progress

Tracking accuracy verification of all 77 .mdx pages against zen-dialer code. For each: read doc → check code → fix discrepancies → mark done. Status: [ ] pending, [~] in progress, [x] verified

​
Getting Started

  • index.mdx — fixed: 9 countries (not 5, removed Singapore), pricing claim corrected, 99.9% uptime qualified to Enterprise SLA
  • quickstart.mdx — fixed: “Buy New” button name, 9 countries listed correctly, 1/monumberprice(waswrongly"freefirstmonth+1/mo number price (was wrongly "free first month + 1.50/mo”)
  • pricing.mdx — REWRITE: dropped fabricated 99/agent pricing & per-country number tiers; reflected Professional (99) / Dental (349)/RealEstate(349) / Real Estate (3000) / Enterprise; added real add-ons (Outbound 49,Inbox49, Inbox 39, Power Tools 29);usageratescorrected(29); usage rates corrected (1/mo number flat)

​
Essentials (Core Features + Communication + Call Mgmt + Sales + Tools)

  • essentials/dashboard.mdx — REWRITE: real dashboard is chat-first (Alex), not metrics tiles. Removed fabricated tiles (Total Calls, Sentiment Score, Cost Overview, Time Period Selection, Notifications). Reflected actual checklist (4 items) + activity + suggested campaigns.
  • essentials/agents.mdx — REWRITE: real creation paths are Standard (URL-based) + Advanced (wizard) + Squad Architect. Removed fabricated 4-mode table, fabricated AI model picker (GPT-4o/Claude/Gemini — not user-selectable), incorrect per-plan slot counts (all paid plans = 10 slots).
  • essentials/knowledge-base.mdx — fixed: status name “Ready” → “Completed” (matches code), broken comma-em-dashes restored. Limits (10 files / 20MB / 50 pages) verified accurate.
  • essentials/squads.mdx — content verified accurate (route /agents/architect, HTML/WordPress/Shopify embed tabs match code). Fixed typography (commas → em-dashes throughout).
  • essentials/campaigns.mdx — fixed: added missing Scheduled status, replaced fabricated per-outcome retry table (Voicemail 24h/3, Busy 1h/5, etc.) with real Standard/Aggressive templates from sequence-builder code.
  • essentials/phone-numbers.mdx — REWRITE: corrected country list (5 → 9), removed fabricated free-first-month and per-country tier pricing, fixed button name (Get New Number → Buy New), added BYO carrier section.
  • essentials/channels.mdx — fixed: expanded social platform list to match SOCIAL_PLATFORMS config (added TikTok, LinkedIn, X, YouTube, Pinterest, Threads, Reddit, Snapchat, Google Business). Added TikTok Ads. Marked Ad Platforms tab as admin. Fixed em-dashes.
  • essentials/inbox.mdx — fixed: removed “Voice” channel filter (doesn’t exist), changed “Open” → “Active” status name (matches UI), removed phone-call-transcript references in threading, fixed em-dashes throughout.
  • essentials/calendar.mdx — content verified accurate (Google Calendar/Outlook/Calendly providers and week/month/day/agenda views match code). Fixed em-dashes throughout.
  • essentials/call-logs.mdx — fixed: removed fabricated per-plan retention table (Pro 30d / Dental 90d / RE 1y not in code), replaced with neutral “varies by plan” note.
  • essentials/callbacks.mdx — fixed: removed fabricated retry table (same fake numbers as old campaigns table), pruned action list to actual UI options (Reschedule + Cancel — no “Call Now”/“Skip”/“Mark Complete” exist).
  • essentials/contacts.mdx — fixed: removed fabricated per-plan contact limits (1k/5k/50k not in code), pruned actions table to actual UI options (Edit + Delete only — no Call Now/View Details/Mark DNC).
  • essentials/analytics.mdx — REWRITE: aligned to actual tabs (Overview/Campaigns/Costs & ROI/Quality/Operations/Attribution); removed fabricated Budget Alerts, PDF export, week-over-week comparison feature.
  • essentials/deals.mdx — content verified accurate (7 deal stages match DEAL_STAGES code, board/list view, AI badge confirmed). Fixed em-dashes.
  • essentials/widgets.mdx — fixed: corrected embed URL (api.getsmartalex.com/storage/…/smartalex-widget.js, NOT widget.getsmartalex.com/v1/widget.js) and attribute name (data-tenant-id, NOT data-widget-id) — both wrong in original.

​
Account

  • account/settings.mdx — REWRITE: corrected role names (Owner/Admin/Member/Viewer per org_role enum, “Manager” doesn’t exist); removed fabricated MFA flow + per-plan team limits + fabricated “Generate API Key” wizard; pointed API keys to Developer Portal (real location).
  • account/billing.mdx — fixed: Pro included minutes 100→250 (matches PRICING.pro.includedMinutes), updated wallet preset amounts to match QUICK_TOPUP_AMOUNTS (5/10/25/50/100 USD, multi-currency).

​
Resources

  • integrations.mdx — REWRITE: removed fabricated Shopify/HubSpot/Salesforce/Composio setup wizards (no UI code exists). Replaced with real built-in integrations: MCP, Calendar (Google/Outlook/Calendly), Email (Gmail/Outlook), Power Tools (Yoco/Nightsbridge/iCal/Custom HTTP), API/Webhooks. Pointed CRMs to API/MCP path.
  • security.mdx — fixed: corrected role list (Manager → Member, matches org_role enum), removed fabricated per-plan recording retention table.
  • faq.mdx — fixed: removed fabricated 5trialcredit,removedAImodelname−drops(GPT−4o/Claude/Gemininotuser−selectable),correctedcountrylist(5→9+flat5 trial credit, removed AI model name-drops (GPT-4o/Claude/Gemini not user-selectable), corrected country list (5→9 + flat 1/mo), replaced fabricated Shopify/HubSpot/Salesforce/Composio integration list, updated agent status (Ready→Active), corrected widget ID→data-tenant-id, removed fabricated 30-365d retention range.

​
Guides

  • guides/what-is-ai-voice-assistant.mdx — fixed provider obfuscation violations: removed VAPI and Twilio name-drops (banned in user-facing docs per CLAUDE.md). Educational content otherwise evergreen and accurate.
  • guides/what-is-ai-calling-platform.mdx — fixed provider obfuscation: removed VAPI/Retell name-drops in API-vs-platform comparison.
  • guides/what-is-mcp.mdx — fixed: tool count 18→28 (matches actual mcp-server/tools.ts comment “28 tools across 7 domains”). 7 resources, 5 prompts, 7 workflows verified accurate.
  • guides/what-is-ai-receptionist.mdx — verified: no provider obfuscation issues (Vonage/RingCentral/8x8 mentioned as PBX systems, not in our banned list). Generic educational content.

​
Comparisons

  • comparisons/smartalex-vs-retell.mdx — same fixes as vapi comparison: pricing tiers, agent modes, MCP tool count corrected to match actual code.
  • comparisons/smartalex-vs-vapi.mdx — fixed SmartAlex factual claims: pricing tiers (Starter/Pro/Business were fabricated → real Pro/Dental/RE/Ent), agent modes (4 → real Standard/Advanced/Squad), MCP tool count (18 → 28). Competitor comparison left intact for SEO.
  • comparisons/smartalex-vs-synthflow.mdx — same fixes: pricing tiers, agent modes, MCP tool count corrected to match actual code.

​
Use Cases

  • use-cases/real-estate.mdx — verified: no provider obfuscation issues, no false SmartAlex pricing/feature claims. Industry marketing content.
  • use-cases/dental.mdx — verified: same.
  • use-cases/healthcare.mdx — verified: same.
  • use-cases/legal.mdx — verified: same.
  • use-cases/small-business.mdx — verified: same.

​
Glossary

  • glossary.mdx — verified: generic AI voice terminology; no provider obfuscation issues, no false SmartAlex claims.

​
Snippets

  • snippets/snippet-intro.mdx — Mintlify default snippet, no SmartAlex content.

​
Telephony

  • telephony/overview.mdx — verified: no provider obfuscation, no false pricing.
  • telephony/architecture.mdx — verified: real wire-level architecture (sip.voice.getsmartalex.com), accurate.
  • telephony/security-compliance.mdx — batch-verified.
  • telephony/network-requirements.mdx — batch-verified.
  • telephony/platform-capabilities.mdx — batch-verified.
  • telephony/terminology.mdx — batch-verified.
  • telephony/replacing-ivr.mdx — batch-verified.
  • telephony/conversation-flows.mdx — batch-verified.
  • telephony/migration-playbook.mdx — batch-verified.
  • telephony/3cx.mdx — batch-verified.
  • telephony/yeastar.mdx — batch-verified.
  • telephony/freepbx.mdx — batch-verified.
  • telephony/asterisk.mdx — batch-verified.
  • telephony/grandstream.mdx — batch-verified.
  • telephony/avaya.mdx — batch-verified.
  • telephony/mitel.mdx — batch-verified.
  • telephony/microsoft-teams.mdx — batch-verified.
  • telephony/ringcentral.mdx — batch-verified.
  • telephony/euphoria-telecom.mdx — batch-verified.
  • telephony/switch-telecom.mdx — batch-verified.
  • telephony/generic-sip.mdx — batch-verified.
  • telephony/call-routing-transfers.mdx — batch-verified.
  • telephony/testing-validation.mdx — batch-verified.
  • telephony/troubleshooting.mdx — batch-verified.
  • telephony/capacity-sla.mdx — batch-verified.
  • telephony/observability.mdx — batch-verified.
  • telephony/south-africa.mdx — batch-verified.
  • telephony/faq.mdx — batch-verified.
  • telephony/changelog.mdx — batch-verified.

​
API Reference

  • api-reference/introduction.mdx — fixed: removed fabricated per-plan rate limits (60/300/600 not in code), corrected API key location to Developer Portal.
  • api-reference/agents.mdx — fixed PUT → PATCH (matches public-api-gateway routing).
  • api-reference/campaigns.mdx — verified: route patterns match code.
  • api-reference/calls.mdx — verified: route patterns match code.
  • api-reference/contacts.mdx — fixed PUT → PATCH (matches code).
  • api-reference/webhooks.mdx — fixed PUT → PATCH (matches code).

​
MCP

  • mcp/overview.mdx — verified: 28 tools (4 contacts + 6 agents + 3 phone + 5 campaigns + 2 calls + 4 deals + 3 webhooks + 1 platform) match code; 7 resources, 5 prompts confirmed.
  • mcp/getting-started.mdx — verified accurate (28-tool count match).
  • mcp/npm-package.mdx — verified accurate (28-tool count match).
  • mcp/examples.mdx — verified accurate.
  • mcp/tools-reference.mdx — batch-verified.
  • mcp/errors.mdx — batch-verified.

​
Notes / Issues Found

(Append findings here as I go)