Help
AI Zeny Help
Setup and troubleshooting, from registration to your first API answer.
29 pages
Getting started
Create your organizationRegister your organization for the AI Zeny free trial: the details you enter and what happens next.
Getting started
Verify your email and WhatsAppConfirm the six-digit codes sent to your email address and your WhatsApp number so your AI Zeny workspace opens.
Getting started
The eight onboarding stepsThe order of setup from registration to your first answer: install, enrol, Pusher, connection, BUSY company and mode.
Getting started
Choose Local or Cloud modeHow AI Zeny Local mode and Cloud mode differ, which plans include them, and where your scripts run in both.
Windows app
Install the Windows appInstall AI Zeny for Windows on the PC that holds your BUSY data, including the Windows prompts to expect.
Windows app
The Windows unknown-publisher warningWhy Windows warns about the AI Zeny installer, and what to check and choose before you run it.
Windows app
Enrol this PCLink the PC to your AI Zeny organization with a one-time enrollment code created in the portal.
Windows app
Create the local unlock password or PINThe password or PIN that unlocks AI Zeny on your PC: how it differs from your portal password and what to do if you forget it.
Pusher
Create your own Pusher Channels appCreate the Pusher Channels app your AI Zeny organization uses to reach your PC, and find its app ID, key, secret and cluster.
Pusher
Enter and test Pusher credentialsEnter your Pusher app ID, cluster, key and secret in the AI Zeny portal, save them and test the saved configuration.
Pusher
Pusher connection statesWhat the connection states in the AI Zeny portal and the Windows app mean.
BUSY connection
Connect a BUSY company on the PCAdd a BUSY company in AI Zeny for Windows: company code, allowed financial years, SQL Server or Access, and the connection test.
BUSY connection
SQL Server and Microsoft Access companiesWhat the PC needs to read a BUSY company kept on SQL Server or in Microsoft Access, including the 64-bit Access ODBC driver.
BUSY connection
Financial years and company codesHow AI Zeny writes BUSY financial years and company codes in the Windows app and in API requests.
Modes and Cloud
How Cloud synchronization worksWhat Cloud mode stores, how often it synchronizes and what a Cloud-mode answer reflects.
Modes and Cloud
What happens when the PC is offWhich AI Zeny requests still work when the PC that holds your BUSY data is switched off.
AI agent, scripts and posting
Preview, test and activate a scriptHow AI Zeny scripts go from inactive to active, and why preview and test runs have real effects.
AI agent, scripts and posting
Why an inactive script cannot be calledWhy the API refuses to run a script until you activate it, and who can activate one.
AI agent, scripts and posting
Authorize a voucher postingHow a voucher reaches BUSY through AI Zeny: preview, validation and your authorization, and what to do if a posting fails.
API tokens
Create an API tokenCreate an AI Zeny API token in the portal, limit it to selected companies, set an expiry and store it safely.
API tokens
Rotate a token with an overlapReplace an AI Zeny API token without downtime by choosing how long the old token keeps working.
API tokens
Revoke a tokenStop an AI Zeny API token immediately when a system no longer needs it or it may have leaked.
Portal and account
Reset your portal passwordReset a forgotten AI Zeny portal password with a one-time code on your email or WhatsApp, or change it while signed in.
Portal and account
Change your login emailChange the email address you sign in with; the new address is confirmed with a code first.
Troubleshooting
DEVICE_OFFLINE: the PC is not connectedWhat the AI Zeny API error DEVICE_OFFLINE (503) means and how to get the PC answering again.
Troubleshooting
RELAY_TIMEOUT: the PC did not answer in timeWhat the AI Zeny API error RELAY_TIMEOUT (504) means and how to avoid it.
Troubleshooting
RESPONSE_TOO_LARGE: the answer is over 2 MiBWhat the AI Zeny API error RESPONSE_TOO_LARGE (502) means and how to request less data.
Troubleshooting
PUSHER_NOT_CONFIGURED or PUSHER_UNAVAILABLEWhat the AI Zeny API errors PUSHER_NOT_CONFIGURED (409) and PUSHER_UNAVAILABLE (503) mean and how to fix them.
Troubleshooting
COMPANY_NOT_ALLOWED: outside the token’s scopeWhat the AI Zeny API error COMPANY_NOT_ALLOWED (403) means and how to fix a token’s company scope.
Categories
- Getting started — Registration, verification, the onboarding steps and choosing a mode. (4 articles)
- Windows app — Installing AI Zeny for Windows, the publisher warning, enrolment and the local unlock. (4 articles)
- Pusher — Your organization’s own Pusher Channels app, its credentials and connection states. (3 articles)
- BUSY connection — Adding a BUSY company on the PC, company codes and financial years. (3 articles)
- Modes and Cloud — Local mode, Cloud mode and what happens when the PC is off. (2 articles)
- AI agent, scripts and posting — Testing and activating scripts, and authorizing voucher postings. (3 articles)
- API tokens — Creating, rotating and revoking the tokens your systems use. (3 articles)
- Portal and account — Your password and your login email address. (2 articles)
- Troubleshooting — What common API errors mean and what to do about them. (5 articles)