Troubleshooting
Find the message you see, then follow the fix. Messages are shown as the app words them.
Sign-in
| Message or symptom | Fix |
|---|---|
| Google sign-in failed. Please try again. | Try again. Check that pop-ups and third-party sign-in are not blocked in your browser |
| You are sent back to the sign-in page | Your session expired (sessions last seven days) or you were signed out. Sign in again |
| You land on the setup page | Finish the setup questions, or select Skip for now on step 1 |
Connecting Odoo
| Message or symptom | Fix |
|---|---|
| Please select an Odoo server from the navbar before sending a message. | Select a server on the start screen (Select Odoo Server) or add one with Connect Odoo |
| Could not authenticate with the Odoo server. Please check the URL, database, username, and password. | Check each value. Make sure the user can sign in to that database in Odoo |
| Invalid URL. Include http:// or https:// | Add the scheme to the URL |
| Invalid server URL: URL hostname is not allowed | Assista X refuses localhost and internal hostnames |
| Invalid server URL: URL resolves to a private/reserved IP address | Use a public address. Private ranges such as 10.x.x.x, 172.16-31.x.x and 192.168.x.x are refused |
| Invalid server URL: URL must use http or https scheme | Use https:// (or http://) |
| You have reached the server limit (N) for your current plan. Please upgrade to add more servers. | Delete a server you do not use, or move to a plan with more servers. See Plans and billing |
| The Database dropdown is empty, or you see "Database list disabled on server", "Could not reach Odoo server" or "Odoo server returned non-JSON response" | Your server does not offer a database list to Assista X. Type the database name |
| Could not fetch locale from Odoo. Check server connection. / Could not fetch locale options. Check server connection. | The server could not be reached at that moment. Check the connection, then select Refresh from Odoo again |
| Failed to save server / Failed to delete server / Failed to activate server | Try again. If it repeats, contact support |
Version problems: Assista X supports Odoo 16 and later. See Settings > About in Odoo for your version.
AI provider errors
| Message | Fix |
|---|---|
| Configuration Error: The AI service API key is missing or invalid. Please check your settings. | Add or correct your key in Settings > Provider and select Save Changes |
| Authentication failed with the AI provider. Your API key may have been revoked or is no longer valid. Please update your API key in Settings. | Create a new key with your provider and save it |
| I couldn't access the requested AI model. It may be unavailable or misconfigured. | Pick another model from the model dropdown in the chat box |
| Your API key has reached its credit limit. Please top up your account or update your API key in Settings. | Add credit with your provider, or use another key |
| I've hit a rate limit with the AI provider. Please wait a moment or check your credits. | Wait a moment and retry |
| Your request is too large for this model's token limit. Please try a shorter conversation, switch to a model with a higher context limit, or upgrade your API plan. | Start a new chat, narrow the question, or choose a model with a larger context window |
| I'm having trouble connecting to the AI service. Please check your internet connection or try again later. | Check your connection and retry |
| The AI model provider is temporarily unavailable. This is common with free-tier models. Please try again in a moment or switch to a different model. | Retry, or switch models |
| Response timed out. Please try again. | The model stopped responding for about a minute. Retry, or switch models |
| I've reached my thinking limit for this request without finding a complete answer. Please try breaking your question down into smaller, more specific steps. | Split the question into smaller steps |
Plan errors
| Message | Fix |
|---|---|
| You don't currently have a plan or your current plan does not support BYOK. | Your plan does not include your own key. Select View Plans in the message |
| No AI models available for your current plan. Please upgrade your subscription. | Check your plan under Settings > Billing & Usage |
| Model '...' is not available in your current plan. Available models: ... | Choose one of the models listed in the message |
| Your AI access key is not yet provisioned. Please complete onboarding or contact support. | Finish setup, or contact support |
The answer is not what you expected
| Symptom | What to check |
|---|---|
| Fewer records than in Odoo | Your Odoo access rights and record rules decide what you can see. Assista X says when some records may be restricted. Compare with what the same Odoo user sees in Odoo |
| "You don't have permission to access this [record/model]. This restriction is configured in Odoo by your administrator" | Your Odoo user cannot read it. Ask your administrator to change your access. Assista X will not work around it |
| "I'm not able to work around Odoo's access restrictions" | You asked for a workaround to restricted data. This is refused on purpose |
| A message that a module does not seem to be installed | The module is missing in that Odoo database. Your administrator can install it from Settings > Apps in Odoo |
| Wrong period or "no records" | State the period and year. Assista X assumes the current year if you give none |
| Numbers use the wrong currency or date style | Set Currency, Language and Date Format in the server settings, or select Refresh from Odoo |
| Only 25 rows in a table | Tables show 25 rows at most. Ask to filter further, or to see more |
| "I don't have access to that information" | Assista X has no data source for that question |
| "I'm only able to help with business and Odoo-related tasks. Please keep the conversation professional." | The message was treated as off-topic or abusive |
| Answers are too short, or too long | Switch Analytical mode on for analyst-style answers, or off for quick lookups |
Settings and general errors
| Message | Fix |
|---|---|
| Failed to save settings. Please try again. | Retry. Check your connection |
| Generation stopped | You pressed stop. Ask again |
| Failed to generate share link / Failed to revoke share | Retry from the Share Chat window |
| Failed to delete chat | Retry, or reload the page |
Voice
| Message | Fix |
|---|---|
| Microphone access denied | Allow the microphone for the site in your browser settings |
| No microphone button | Your browser does not support speech recognition. Use a browser that does |
| Something went wrong (overlay) | Tap the overlay to start again |
| Could not transcribe audio. Please try again. | Repeat the question |
| Audio file exceeds 25MB limit. | Use shorter recordings |
| OpenRouter API key not provisioned for voice features. | Check your provider settings. See Voice |
Google integration
| Message or symptom | Fix |
|---|---|
| Failed to initiate Google connection | Try again from Settings > Integrations |
| Failed to disconnect Google | Try again |
| Calendar or email actions fail after you changed permissions | Disconnect, then connect again and tick the permissions you need |
| An email card shows Connect to Send | Connect Google first. See Google integration |
| An email card shows Email Failed | Try again, or reconnect Google |
Reports
| Message | Fix |
|---|---|
| Failed to load report / Failed to save report | Retry. Reopen the report from the Reports tab |
| PDF generation failed / Image export failed / HTML export failed | Retry, or choose another download format |
| Template name is required | Enter a name for the template |
| Failed to save template / Failed to load report templates | Retry |
Still stuck?
See Support. Include your Odoo version, what you asked, and the exact message you saw. You can also use Contact Us in the app.