Set it up (platform owner)
Open the Platform page and find Included AI.1
Choose the service and model
Pick the AI service and type the exact model name. A small, fast model is usually best for customer chat. With OpenAI-compatible, also fill in the base URL.
2
Paste the API key and save
The key is stored encrypted and is never shown again. Usage is billed to this account.
3
Click Test connection
You should see “Connected. The model replied.” If not, check the key and the model name.
Then give your plans an allowance: in each plan, fill in Included AI per assistant (USD a month). Leave it empty for a plan without AI. An agency on no plan can get an allowance of its own in its edit window.
The allowance is counted at list prices, the same way each assistant’s AI cost is shown. A typical answer costs a fraction of a cent on a small model, so an allowance of a few dollars per assistant covers thousands of answers. Check the Use this month table after the first weeks and adjust.
How fair use works
- Shared by the agency. The agency’s allowance is the per-assistant amount times its assistants (demos aside, at least one). A busy client can use what a quiet one doesn’t.
- Alerts. At 80% and at 100% the agency’s admins get an email. At 100% you get an alert too.
- Over 100%, assistants keep answering. At the Pause at level, included AI pauses until the 1st: the assistants answer with their fallback message, and rules, FAQs and question flows keep working. The hourly channel check shows it as a problem.
- Lifting a pause. A bigger allowance, a bigger plan, or the agency’s own key on an assistant’s AI brain page lifts it straight away.
- Every month, the count starts again on the 1st.
What agencies see
When their plan includes AI:- New assistants start on Included with the plan. Existing ones can be switched on the AI brain page.
- The AI brain page and Settings → Plan show how much of this month’s allowance is used, as a percentage. Agencies never see dollar amounts or your key.
- Voice notes and photos are read by the included AI when its model can do that.
Privacy
Each assistant’s privacy page names the company that really processes the messages: the service you chose for included AI, not “the platform”. If that service processes messages outside the EU, the page says so, as it does for an assistant’s own key.With an AI agent
Platform owners can ask Claude or another AI agent connected to the platform for included_ai (the settings and each agency’s use), and set allowances with save_plan, create_agency and update_agency (ai_allowance_usd). Agency admins see their share used in my_plan. The key itself is entered on the Platform page only.