AI settings, credits and limits

Settings → AI for business admins (the AI service, monthly credits, every feature's switch and availability, usage by feature and by user, the messages AI can show), the super-admin AI pages (credits per subscriber, usage, churn risk and upsell signals), the server settings such as Ai:ApiKey, and the limits of the public help, Bazaar, hotel and school chats.

Open AI settings

Control panel → AI settings (hayaterp.com/settings/ai), or AI settings → on the ✦ AI card in Settings. The workspace sites (hospital, school, hotel…) have the same page. Everyone may look at it; only users with Company, branch and system settings (admin.settings) can change switches and see usage — others read Only an administrator can switch features on or off.

The page header has ✦ Setup assistant (see Setup assistant) and Refresh.

Switch features on or off

Each row of Features has:

• the switch (admins only; it takes effect at once on every screen and phone — a panel disappears, a button hides);
• the name, a badge — AI, Statistics or Statistics + AI (see Statistics and AI write-ups) — and the module;
• one line on what it does;
• whether you can use it now: Available; Partly (Works without the AI write-up: … — the key or credits are missing, the figures still work); Not available with the reason (switched off for the company, needs a module, needs a permission, no AI key, credits used up); or Off.

Find a feature… searches the list, Not available only shows only what cannot run, and each area has All on / All off. Features of modules your subscription does not have are not listed. New companies start with everything on.

Where each one appears and who may use it: AI features by module.

Usage

Pick a Month. The totals are Requests, Credits used (of the limit), Tokens (in / out) and Estimated cost in US dollars (a list-price estimate for your information; you are not billed per request). Below:

• By feature — requests (and how many of them called the AI model), Failed, credits and a share bar. No AI use this month. when empty.
• By user — requests and credits per person.

Statistics features show requests but no credits. Requests from scheduled jobs and the public chats of your business (hotel booking website, school parents) have no user.

AI messages and what to do

Admins who see an AI panel that is switched off get a dashed one-line hint (Switched off for your company.) with a link here, instead of the panel.

End-of-day summary settings

The owner's WhatsApp / SMS / e-mail summary of the day's till sales is set on POS → POS insights → End-of-day summary for the owner (changing it needs admin.settings). See POS.

Super admin: AI credits, usage and signals

On admin.hayaterp.com the menu section AI has three pages, linked by tabs. They are for the Hayat team only.

✦ AI credits (/ai)

• Pick a month; search Subscriber or plan; tick 80% used or more.
• Each subscriber: plan, Used, Limit (marked default when not set), a use bar and %, Left.
• Set limit → a number from 0 to 10,000,000 → Save; Default goes back to the standard 2,000. The new limit applies at once and is logged on the subscription as AI credits changed.
• History opens the last 12 months as bars; a month at or over its limit is red.

✦ AI usage (/ai/usage)

• Totals for the month: requests, credits and estimated cost, plus the public help chat (questions and cost).
• Subscribers, highest credits first; open one to see its features (calls, credits, tokens, Cost (USD)). A by feature, all subscribers table sums them. Search Subscriber or feature.

✦ Churn risk & upsell (/ai/signals) — statistics only, no AI key needed.

• Churn: each active subscriber's Score with Risk (high from 70, medium from 40), Why (the reasons), plan, status, users, Sign-ins (4 wk), Entries (4 wk / before) with the trend, Last sign-in and Paid until. Filter all / medium and high / high. What raises it: nobody signing in for 7, 14 or 30 days; entries down by a quarter or a half, or nothing entered for 2 weeks; suspended or past due, overdue invoices, a cancel request; a trial ending within 7 days with no plan; auto-renew off near the end; a single user.
• Upsell (?tab=upsell): Score, Why, Suggest (the cheapest plan with a higher limit) and Asked for — modules their staff searched for with smart search but do not have — with a link to the subscription. What raises it: users, branches or companies at 80–100% of the plan; invoices at 80% of the monthly limit; searches for missing modules; AI credits at 80%; strong growth; a busy trial; add-on requests.

See also Super-admin panel.

Server settings

For whoever hosts the API (appsettings, user-secrets or environment variables such as Ai__ApiKey):

The help site's ✦ Ask the help widget calls the API from help.hayaterp.com, so that address must be in the API's Cors:Origins; the widget's backend address is in assets/help-config.js (set enabled: false there to hide it).

Unused drafts are deleted after 7 days, usage rows after 400 days and credit rows after 24 months.

Public chats and their limits

Some AI runs for people who are not signed in. Each has its own limits so nobody can run up your credits:

The hotel's 💬 Ask us and the parents' ✦ Ask tab are hidden when the feature is switched off here, when AI is not set up on the server, or when the month's credits are used up. A day's limit does not hide them; they show the message above.