FAQ
This page collects common questions that users may encounter while using VoiceFox. For detailed steps, open the related feature guide.
Account and permissions
Why can I not see or use some features after signing in?
Common causes include missing role permissions, plan limitations, or incomplete workspace configuration. Check the current workspace, account role, and subscription status first.
Do I need a technical integration to use VoiceFox?
No. Most basic workflows can be completed in the workspace, including creating assistants, importing knowledge, testing, and creating outbound tasks. API or Webhook integration is needed only when connecting VoiceFox with CRM, ERP, ticketing, or internal systems.
Assistants and workflows
What is the difference between an assistant and a workflow?
An assistant controls how the AI understands, replies, and collects information. A workflow controls more explicit conversation paths, node transitions, and handoff logic. Start with an assistant for simple scenarios, and add workflows for more complex processes.
Do assistant configuration changes affect running outbound tasks immediately?
Usually no. Existing tasks generally keep the assistant configuration from task creation time. To apply new settings, create a new task or follow the product release mechanism.
Does a published workflow immediately affect linked numbers or tasks?
It depends on the actual binding and release mechanism. Before launching production traffic, validate the workflow with a test number or a small sample task.
Knowledge base
Will knowledge base content be read word for word?
No. The knowledge base provides reference information. The assistant combines prompts, context, and retrieved content to generate answers suitable for voice conversations.
Why can I not create a knowledge base?
Check whether your account has knowledge base management permission, whether the workspace plan includes knowledge base capability, and whether the imported file format is supported.
What should I do if Excel upload fails?
Check file format, headers, blank rows, merged cells, and file size. Use clearly structured tables and avoid mixing multiple business topics in one file.
Testing and launch
How do I know whether a test has passed?
A basic test passes when in-scope questions are answered correctly, out-of-scope questions are not fabricated, handoff works, and call logs contain normal recording, ASR, and analysis results.
Why can I not make calls after creating an assistant?
Common causes include missing line configuration, insufficient balance, or plan permissions. Check subscription and usage, then confirm line status.
What should I check if handoff does not work?
Check the handoff number, business hours, line status, and workflow node conditions. Validate the handoff path with a test number before using it in production tasks.
Data and export
Do debug calls trigger Webhook events?
It depends on the debug method and Webhook configuration. To validate callbacks, use a production task or a supported test method, then check Webhook logs.
Why do AI insights and call logs show different counts?
AI insights may use different statistical scope, time range, processing status, and permission boundaries. Check filters, task scope, and data sync status first.
What should I do if an export stays in progress?
Large exports may take longer. Check whether the selected time range is too large, refresh later, or retry with a smaller range.
Still unresolved
If the issue is still unresolved, follow the checks in Troubleshooting.