# Zybots

Zybots is a website-trained AI assistant platform for teams that need grounded answers, lead capture, analytics, omnichannel deployment, and enterprise-grade workspace control.

Public URLs:

- Marketing site: https://www.zybots.ai
- Dashboard app: https://app.zybots.ai
- Widget runtime: https://widget.zybots.ai
- Developer API docs: https://app.zybots.ai/developers/api
- Public API OpenAPI spec: https://app.zybots.ai/api/public/v1/openapi.json
- Platform API OpenAPI spec: https://app.zybots.ai/api/openapi.json
- English blog index: https://www.zybots.ai/en/blog
- Romanian blog index: https://www.zybots.ai/ro/blog

## Marketing Pages

- [Home](https://www.zybots.ai/en): Main English landing page for website-trained AI agents.
- [Products](https://www.zybots.ai/en/products): Platform product hub covering the AI chat widget, omnichannel AI, AI Actions, lead capture, knowledge base, and analytics.
- [Solutions](https://www.zybots.ai/en/solutions): Use-case and industry solution hub for support, sales, bookings, ecommerce, healthcare, education, and travel.
- [Pricing](https://www.zybots.ai/en/pricing): Plan limits, feature comparison, add-ons, and billing positioning.

## Legal and Policy Pages

English legal URLs:

- [Legal Notice](https://www.zybots.ai/en/legal-notice): Company operator details for GLOSOFT SOLUTIONS SRL, registered office, Trade Register number, VAT / Tax ID, competent authority / country of registration, economic operator, website, platform, and support contact.
- [Terms & Conditions](https://www.zybots.ai/en/terms-and-conditions): Service scope, account rules, monthly and yearly subscriptions, automatic renewal, cancellation, failed payments, invoices, VAT/taxes, refunds, EU digital-service withdrawal language, service availability, AI output disclaimer, account deletion, acceptable use, suspension, and legal contacts.
- [Disclaimer](https://www.zybots.ai/en/disclaimer): Website and platform limitation notice covering general information only, AI output limitations, no professional advice, high-risk use cases, customer content responsibilities, end-user AI disclosure, third-party integrations, marketing claims, demos, testimonials, brand non-affiliation, documentation limits, availability, and relationship with other legal documents.
- [Privacy Policy](https://www.zybots.ai/en/privacy-policy): Controller GLOSOFT SOLUTIONS SRL, privacy contacts, ANSPDCP supervisory authority, legal bases, retention periods, processors/sub-processors, international transfers, children, and widget end-user notice.
- [Cookie Policy](https://www.zybots.ai/en/cookie-policy): Cookie/storage categories, consent controls, Cookie Settings link, and a cookie table for CookieScript, Google Tag Manager, Google Analytics 4, Meta Pixel, and Zybots widget storage.
- [GDPR Policy](https://www.zybots.ai/en/gdpr-compliance-policy): GDPR roles, lawful bases, categories of processed data, data subject rights, retention, international transfers, security, and customer responsibilities.
- [Data Processing Agreement](https://www.zybots.ai/en/data-processing-agreement): Full DPA forming part of the Terms when Zybots processes Personal Data on behalf of a customer, covering definitions, controller/processor/subprocessor roles, subject matter, processing duration, customer instructions, customer and processor obligations, confidentiality, security measures, breach notification, data subject requests, compliance assistance, subprocessors, international transfers, AI/model providers, AI output responsibility, special categories of data, deletion/return, audits, records, DPIA support, government requests, changes, liability, termination, processing details, technical and organizational measures, subprocessors, transfer addendum, and optional Enterprise terms.
- [AI Transparency Notice](https://www.zybots.ai/en/ai-transparency-notice): AI assistant disclosure, customer disclosure responsibilities, accuracy limits, high-risk decision warnings, lawful knowledge-source configuration, human review, and restrictions on unauthorized impersonation of real persons, officials, medical staff, lawyers, or official representatives.
- [Acceptable Use Policy](https://www.zybots.ai/en/acceptable-use-policy): Prohibits spam, phishing, malware, abusive scraping, unlawful content, unauthorized sensitive-data processing, and automated high-risk misuse.
- [Refund & Cancellation Policy](https://www.zybots.ai/en/refund-cancellation-policy): Cancellation before renewal, already-started billing periods generally non-refundable, refund exceptions, failed payments, upgrades/downgrades, invoices, VAT/taxes, and 5-10 business day refund review.
- [DSA Notice & Action](https://www.zybots.ai/en/dsa-notice-and-action): Authority and user points of contact, illegal content/abuse report requirements, suspension/removal handling, appeal contact process, moderation rules, and accepted DSA communication languages: Romanian and English.
- [ANPC / SAL](https://www.zybots.ai/en/anpc-sal): Romanian and EU consumer alternative dispute resolution information, including ANPC/SAL and Consumer Redress in the EU context.

Romanian legal URLs:

- [Informații legale](https://www.zybots.ai/ro/informatii-legale): Date operator, GLOSOFT SOLUTIONS SRL, sediu social, CUI/TVA, Trade Register, autoritate competenta / tara de inregistrare, operator economic, website, platformă și contact.
- [Termeni și condiții](https://www.zybots.ai/ro/termeni-si-conditii): Termeni serviciu, abonamente lunare/anuale, reînnoire automată, anulare, plăți eșuate, facturi, TVA/taxe, rambursări, retragere pentru servicii digitale, disponibilitate, disclaimer AI, ștergere cont, utilizare acceptabilă, suspendare și contacte.
- [Disclaimer](https://www.zybots.ai/ro/disclaimer): Notificare în română despre limitări generale, output AI, lipsa consultanței profesionale, cazuri high-risk, responsabilitatea clientului pentru conținut, informarea utilizatorilor finali, integrări terțe, afirmații de marketing, demo-uri, testimoniale, lipsa afilierii cu branduri terțe, documentație și disponibilitate.
- [Politica de confidențialitate](https://www.zybots.ai/ro/politica-de-confidentialitate): Operator GLOSOFT SOLUTIONS SRL, contacte privacy, ANSPDCP, temeiuri legale, retenție, procesatori/subprocesatori, transferuri internaționale, copii și informarea vizitatorilor widgetului.
- [Politica cookie](https://www.zybots.ai/ro/politica-cookie): Categorii cookie/storage, modificarea consimțământului, Cookie Settings și tabel cu CookieScript, GTM, GA4, Meta Pixel și storage-ul widgetului Zybots.
- [Politica GDPR](https://www.zybots.ai/ro/politica-gdpr): Roluri GDPR, temeiuri legale, categorii de date, drepturi, retenție, transferuri, securitate și responsabilități ale clientului.
- [Acord de prelucrare a datelor](https://www.zybots.ai/ro/acord-prelucrare-date): DPA complet în română, parte din Termeni când Zybots prelucrează Date Personale în numele clientului, cu roluri operator/persoană împuternicită/subprocesator, obiect, durată, instrucțiuni, obligații, confidențialitate, securitate, breșe, cereri ale persoanelor vizate, subprocesatori, transferuri, furnizori AI/model, categorii speciale, ștergere/returnare, audituri, evidențe, DPIA, solicitări guvernamentale, modificări, răspundere, încetare și anexe.
- [Notă de transparență AI](https://www.zybots.ai/ro/nota-de-transparenta-ai): Informare despre asistenți AI, responsabilitatea clienților pentru disclosure, limite de acuratețe, decizii high-risk, configurare legală și interdicția de chatboturi care pretind fără autorizare că sunt persoane reale, funcționari publici, personal medical, avocați sau reprezentanți oficiali.
- [Politica de utilizare acceptabilă](https://www.zybots.ai/ro/politica-utilizare-acceptabila): Interzice spam, phishing, malware, scraping abuziv, conținut ilegal, date sensibile fără bază legală și decizii automate high-risk neconforme.
- [Politica de rambursare și anulare](https://www.zybots.ai/ro/politica-rambursare-anulare): Anulare, reînnoire, rambursări, plăți eșuate, upgrade/downgrade, facturi, TVA/taxe și analiza solicitărilor de rambursare în 5-10 zile lucrătoare.
- [DSA notificare conținut ilegal](https://www.zybots.ai/ro/dsa-notificare-continut-ilegal): Puncte de contact pentru autorități și utilizatori, raportare abuz/conținut ilegal, informații necesare, suspendare/eliminare, apel, reguli de moderare și limbi acceptate DSA: română și engleză.
- [ANPC / SAL](https://www.zybots.ai/ro/anpc-sal): Informații pentru soluționarea alternativă a litigiilor prin resurse ANPC/SAL și context Consumer Redress in the EU.

## Product Pages

- [AI Chat Widget](https://www.zybots.ai/en/products/ai-chat-widget): Website AI chat widget for instant answers, lead capture, bookings, and visitor conversion.
- [Omnichannel AI](https://www.zybots.ai/en/products/omnichannel-ai): One AI assistant across website chat, WhatsApp, Instagram, and Messenger.
- [AI Actions](https://www.zybots.ai/en/products/ai-actions): Connected actions for Shopify, WooCommerce, Stripe, Calendly, Cal.com, Slack, Zendesk, Web Search, and REST APIs.
- [Lead Capture](https://www.zybots.ai/en/products/lead-capture): Capture, qualify, and route visitor interest from AI conversations.
- [Knowledge Base](https://www.zybots.ai/en/products/knowledge-base): Train AI on website pages, sitemap content, documents, FAQs, Q&A pairs, text sources, and corrections.
- [Analytics](https://www.zybots.ai/en/products/analytics): Track conversations, leads, common questions, channel activity, and assistant performance.

## Solution Pages

- [AI Chatbot Customer Support Agent](https://www.zybots.ai/en/solutions/ai-chatbot-customer-support-agent): Support automation for repetitive customer questions from trusted content.
- [AI Chatbot Sales Agent](https://www.zybots.ai/en/solutions/ai-chatbot-sales-agent): Sales assistant for lead qualification, offer explanation, contact capture, and conversion.
- [AI Chatbot Appointment Booking Agent](https://www.zybots.ai/en/solutions/ai-chatbot-appointment-booking-agent): Booking assistant for meetings, demos, consultations, appointments, Calendly, and Cal.com.
- [AI Chatbot Ecommerce Assistant](https://www.zybots.ai/en/solutions/ai-chatbot-ecommerce-assistant): Ecommerce assistant for product questions, orders, delivery, returns, and recommendations.
- [AI Chatbot for Ecommerce and Retail](https://www.zybots.ai/en/solutions/ai-chatbot-ecommerce-retail): Industry page for online stores and retail brands.
- [AI Chatbot for Healthcare and Clinics](https://www.zybots.ai/en/solutions/ai-chatbot-healthcare-clinics): Industry page for clinics, appointments, service questions, and patient inquiries.
- [AI Chatbot for Education and Training](https://www.zybots.ai/en/solutions/ai-chatbot-education-training): Industry page for admissions, courses, enrolment, schedules, and student questions.
- [AI Chatbot for Travel and Hospitality](https://www.zybots.ai/en/solutions/ai-chatbot-travel-hospitality): Industry page for bookings, availability, policies, guest support, cancellations, and refunds.

## Docs

- [Overview](https://www.zybots.ai/docs/api-reference/overview.md): Product overview, public URLs, core concepts, and product surface.
- [Using the Platform](https://www.zybots.ai/docs/api-reference/using-the-platform.md): Simple setup workflow from goal, workspace, training, testing, and publishing to ongoing improvement.
- [Pricing and Plans](https://www.zybots.ai/docs/api-reference/pricing-and-plans.md): Free, Starter, Growth, Pro, and Enterprise plan positioning, limits, feature gates, and add-ons.
- [Authentication](https://www.zybots.ai/docs/api-reference/authentication.md): Workspace API keys, Bearer auth, dashboard sessions, widget authorization, and plan gates.
- [Public API](https://www.zybots.ai/docs/api-reference/public-api.md): Public API v1 base URL, endpoint groups, pagination, error envelope, and plan requirements.
- [Leads API](https://www.zybots.ai/docs/api-reference/leads.md): Lead list, detail, CSV export, filters, and lead object fields.
- [Conversations API](https://www.zybots.ai/docs/api-reference/conversations.md): Conversation summaries, messages, CSV export, pagination, and message fields.
- [Training API](https://www.zybots.ai/docs/api-reference/training.md): Website training, full retrain, single-page retrain, async jobs, path rules, and idempotency.
- [Widget and Channels](https://www.zybots.ai/docs/api-reference/widget-and-channels.md): Web widget embed, domain controls, chat streaming, lead forms, omnichannel, and handoff.
- [AI Actions and Integrations](https://www.zybots.ai/docs/api-reference/ai-actions-and-integrations.md): Shopify, WooCommerce, Stripe, Calendly, Cal.com, Slack, Zendesk, Web Search, and Custom REST actions.
- [Analytics and Leads](https://www.zybots.ai/docs/api-reference/analytics-and-leads.md): Analytics surface, Activity inbox, lead capture sources, exports, and feedback loop.
- [Teams, Workspaces, and Billing](https://www.zybots.ai/docs/api-reference/teams-workspaces-and-billing.md): Workspace model, members, billing behavior, downgrades, cancellation, and Enterprise billing.
- [Agent Presets and Models](https://www.zybots.ai/docs/api-reference/agent-presets-and-models.md): Agent presets, model providers, grounding separation, and model settings.
- [Limits and Rate Limits](https://www.zybots.ai/docs/api-reference/limits-and-rate-limits.md): Plan limits, retrain quotas, API quotas, widget rate limits, AI credits, and training safety.
- [Errors and Idempotency](https://www.zybots.ai/docs/api-reference/errors-and-idempotency.md): Error envelope, HTTP status codes, idempotency keys, training conflicts, and stream errors.

## Blog

- [Zybots Blog](https://www.zybots.ai/en/blog): English blog index for AI assistant rollout, support automation, lead capture, and chatbot implementation guidance.
- [Blog Zybots](https://www.zybots.ai/ro/blog): Romanian blog index for AI assistant rollout, support automation, lead capture, and chatbot implementation guidance.
- [AI customer support needs an operating model, not only automation](https://www.zybots.ai/en/blog/ai-customer-support-operating-model): Operating model for AI customer support, escalation, analytics, and knowledge improvement.
- [AI customer support are nevoie de un model operational, nu doar de automatizare](https://www.zybots.ai/ro/blog/ai-customer-support-operating-model): Romanian version about AI support operating models, escalation, analytics, and knowledge improvement.
- [How AI chatbots turn website visits into qualified leads](https://www.zybots.ai/en/blog/ai-chatbots-for-lead-generation): Conversational lead capture, qualification, and sales handoff guidance.
- [Cum transforma chatbotii AI vizitele pe website in lead-uri calificate](https://www.zybots.ai/ro/blog/ai-chatbots-for-lead-generation): Romanian version about conversational lead capture, qualification, and sales handoff.
- [How to launch an AI chatbot without creating maintenance debt](https://www.zybots.ai/en/blog/launch-ai-chatbot-without-maintenance-debt): Durable chatbot launch framework covering source quality, retraining, analytics, and scale-up.
- [Cum lansezi un chatbot AI fara sa creezi datorie de mentenanta](https://www.zybots.ai/ro/blog/launch-ai-chatbot-without-maintenance-debt): Romanian version about durable chatbot launch, retraining, analytics, and scale-up.
- [Website-trained AI assistants need more than a chat bubble](https://www.zybots.ai/en/blog/website-trained-ai-assistants): Why production assistants need grounded content, lead capture, analytics, retraining, and escalation paths.
- [Asistentii AI antrenati pe website au nevoie de mai mult decat un chat bubble](https://www.zybots.ai/ro/blog/website-trained-ai-assistants): Romanian version about grounded website-trained assistants, lead capture, analytics, retraining, and escalation.

## Product Concepts

Workspace: account-level container for bots, members, billing, API keys, governance, and settings.

Bot: an AI assistant with its own public key, knowledge sources, widget settings, channels, conversations, analytics, and API-accessible data.

Training source: website URL, sitemap-discovered page, file, text source, Q&A pair, or correction depending on plan.

Conversation: a chat session from the web widget or a connected channel.

Lead: contact data captured by AI extraction, lead forms, or operator-assisted workflows.

AI Action: a configured integration the assistant can call during conversation, such as Shopify, WooCommerce, Stripe, Calendly, Cal.com, Slack, Zendesk, Web Search, or Custom REST.

## How to Use the Platform

Use Zybots in this order:

1. Set one clear assistant goal.
2. Create the workspace and bot.
3. Train the bot with trusted content.
4. Configure behavior and appearance.
5. Test with real customer questions.
6. Publish the widget on an allowed domain.
7. Add channels and integrations only after the base flow works.
8. Review conversations, leads, and analytics.
9. Improve the knowledge base from real customer behavior.

For the complete workflow, see [Using the Platform](https://www.zybots.ai/docs/api-reference/using-the-platform.md).

## Plans

Plan positioning:

- Free is for activation, testing, and evaluation.
- Starter is for solo operators, local businesses, and first production chatbot launches.
- Growth is the main production plan for teams that need analytics and automation.
- Pro is for agencies, multi-brand workspaces, and high-volume commercial usage.
- Enterprise is for governance, procurement, custom contracts, custom integrations, and SLA-led support.

Add-ons can extend credits, chatbot capacity, team seats, training capacity, and branding options depending on the workspace plan and commercial agreement.

## Plan Limits

| Limit | Free | Starter | Growth | Pro | Enterprise |
| --- | --- | --- | --- | --- | --- |
| Chatbots | 1 | 2 | 5 | 12 | Up to 500 |
| Members | 1 | 3 | 6 | 15 | Up to 100 |
| AI credits/month | 50 | 1,500 | 6,000 | 18,000 | Up to 250,000 |
| AI actions/bot | 0 | 2 | 4 | 6 | Up to 32 |
| Custom forms/bot | 0 | 0 | 6 | 8 | Up to 10 |
| Widget domains | 1 | 3 | 10 | 30 | Up to 250 |
| Training characters/bot | 500,000 | 5,000,000 | 10,000,000 | 15,000,000 | 50,000,000 |
| Sources/pages/bot | 15 | 2,000 | 6,000 | 15,000 | Effectively unlimited |
| Conversation retention | 3 days | 30 days | 90 days | 180 days | 365 days |
| API requests/month | 0 | 0 | 0 | 5,000 | Custom |

AI credit definition:

- One AI credit is consumed when the AI assistant generates one answer to a visitor message.
- 50 AI credits/month means up to 50 AI-generated assistant replies per month.
- Messages sent by visitors do not consume credits by themselves.
- Human agent replies do not consume AI credits.
- System events, starter questions, and static widget UI text do not consume AI credits.

## Feature Gates

Available on every plan:

- Website training.
- Sitemap training.
- Web widget deployment.
- Basic widget customization.

Starter adds:

- Advanced models.
- Q&A training.
- Text training.
- Scheduled auto-retraining.
- AI lead capture.
- Core analytics.
- CSV exports.
- Omnichannel channels.
- Email support.

Growth adds:

- File training.
- Correction training.
- Daily auto-retraining.
- Custom lead forms.
- Product recommendations.
- Follow-up suggestions.
- Conversation insights.
- Public API leads read.
- Public API conversations read.
- Faster support.
- Onboarding session.

Pro adds:

- Custom calendar auto-retraining.
- Priority training queue.
- Public API training.
- Custom domain.
- Priority onboarding.
- Monthly strategy call.

Enterprise adds:

- Sentiment analysis.
- White-label branding.
- Custom workspace roles.
- Workspace audit logs.
- Custom commercial limits.
- Custom integrations.
- Dedicated onboarding.
- SLA and priority support.
- Invoice and contract billing.

## Training

Zybots training turns website and source content into searchable knowledge for an AI assistant. Supported source types depend on plan:

- Website training and sitemap training are available on all plans.
- Q&A and text training start on Starter.
- File and correction training start on Growth.

Training modes:

- `DISCOVERY`: crawl and discover multiple pages from a base URL or sitemap.
- `SINGLE`: train or retrain a single page.

Website training can use include and exclude path rules. Path rules support `starts_with`, `ends_with`, `contains`, `exact`, and `wildcard` matching against normalized page paths.

Public training API routes are available on Pro and Enterprise:

- `GET /api/public/v1/bots/{botId}/trainings`
- `GET /api/public/v1/bots/{botId}/trainings/{trainingId}`
- `POST /api/public/v1/bots/{botId}/training/website/start`
- `POST /api/public/v1/bots/{botId}/training/website/retrain-full`
- `POST /api/public/v1/bots/{botId}/training/website/retrain-single`

Training write routes return `202 Accepted` after a job is queued. They require `Idempotency-Key`, enforce per-key rate limits, restrict targets to allowed domains, and reject extra concurrent jobs.

## Public API

Base URL:

```text
https://app.zybots.ai
```

Authentication:

```http
Authorization: Bearer <workspace_api_key>
```

Public API endpoint groups:

Exports:

- `GET /api/public/v1/bots/{botId}/leads/export.csv`
- `GET /api/public/v1/bots/{botId}/conversations/export.csv`

Leads:

- `GET /api/public/v1/bots/{botId}/leads`
- `GET /api/public/v1/bots/{botId}/leads/{leadId}`

Conversations:

- `GET /api/public/v1/bots/{botId}/conversations`
- `GET /api/public/v1/bots/{botId}/conversations/{sessionId}`
- `GET /api/public/v1/bots/{botId}/conversations/{sessionId}/messages`

Training:

- `GET /api/public/v1/bots/{botId}/trainings`
- `GET /api/public/v1/bots/{botId}/trainings/{trainingId}`
- `POST /api/public/v1/bots/{botId}/training/website/start`
- `POST /api/public/v1/bots/{botId}/training/website/retrain-full`
- `POST /api/public/v1/bots/{botId}/training/website/retrain-single`

List endpoints use cursor pagination with optional `cursor` and `limit` query parameters. `limit` accepts values from 1 to 100 and defaults to 20.

Error envelope:

```json
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message",
    "details": {}
  }
}
```

Common status codes include `400`, `401`, `403`, `404`, `409`, `428`, and `429`.

## Leads

Lead sources:

- `lead_form`: captured through a configured lead form.
- `ai_collected`: extracted by the assistant during conversation.

Lead objects include:

- `id`
- `sessionId`
- `source`
- `message`
- `createdAt`
- `updatedAt`
- `formId`
- `formName`
- `name`
- `email`
- `phone`
- `note`
- `emails`
- `phones`
- `completionState`
- `fields`

Lead field objects include `id`, `label`, `type`, `required`, and `value`. Field type can be `text`, `email`, `phone`, or `textarea`.

## Conversations

Conversation summaries include:

- `sessionId`
- `startedAt`
- `lastMessageAt`
- `lastPreview`
- `messageCount`
- `rating`
- `client`

Conversation messages include:

- `id`
- `sender`: `user` or `bot`
- `message`
- `createdAt`
- `feedback`: `liked`, `disliked`, or null

CSV exports are available on Starter and above. JSON lead and conversation read access starts on Growth.

## Widget and Channels

Canonical widget embed:

```html
<script src="https://widget.zybots.ai/widget.js" data-bot="YOUR_PUBLIC_BOT_KEY" async></script>
```

Supported widget attributes:

- `data-bot`: the Zybots public bot key.
- `data-position`: `right` or `left`.
- `data-open`: `true` to open the launcher by default.

Customer website domains must be allowlisted in the bot widget domain settings.

Domain allowlist setup:

1. Open the workspace and bot in the Zybots dashboard.
2. Go to `Settings > Security`.
3. Add the exact hostname that will load the widget, for example `example.com`.
4. Add `www.example.com`, staging domains, and preview domains separately when they should load the widget.
5. Save the settings, then reload the page where the widget snippet is installed.

Do not include `https://`, URL paths, query strings, or trailing slashes. The allowlist is hostname-based, so apex, `www`, subdomain, staging, and preview hosts are separate entries.

The widget uses a public bot key and short-lived widget authorization generated by Zybots. The browser does not expose a workspace API key.

Chat responses are streamed as Server-Sent Events. Common stream payload types include:

- `start`: includes the `sessionId`.
- `token`: incremental assistant text.
- `error`: error message and optional error key.
- `final`: final assistant message, persisted user message, persisted bot message, optional sources, and handoff state.
- `suggestions`: follow-up suggestions, suggested forms, or schedule picker data.

The stream ends with:

```text
data: [DONE]
```

Paid plans support omnichannel channels:

- WhatsApp.
- Instagram DMs.
- Facebook Messenger.

All widget and omnichannel conversations flow into the Activity tab.

## AI Actions and Integrations

AI Actions let the assistant execute configured operations during conversation. Supported action categories include:

- Shopify.
- WooCommerce.
- Stripe.
- Calendly.
- Cal.com.
- Slack.
- Zendesk.
- Web Search.
- Custom REST.

AI Actions per bot:

- Free: 0.
- Starter: 2.
- Growth: 4.
- Pro: 6.
- Enterprise: up to 32.

Custom forms do not consume AI Action slots. They are governed by the custom forms feature and plan form limits.

## Analytics and Lead Capture

Analytics can show:

- Total sessions.
- Total messages.
- Total leads.
- Active bots.
- Daily trends.
- Lead capture rate.
- Session size distribution.
- User versus assistant message split.
- Top countries and top sessions on eligible plans.
- Channel performance.

Lead capture can come from:

- AI extraction during normal conversations.
- Custom forms on eligible plans.
- Manual or operator-assisted workflows.

Availability:

- AI lead capture starts on Starter.
- Custom forms start on Growth.
- Core analytics start on Starter.
- Conversation insights start on Growth.
- Sentiment analysis is Enterprise-only.

## Teams, Workspaces, and Billing

Each workspace has its own bots, members, billing, API keys, widget domain settings, conversations, leads, analytics, and exports.

Billing behavior:

- Upgrades apply immediately.
- Stripe prorates upgrades automatically.
- Downgrades are scheduled for the end of the current billing period.
- Cancellation stops the next renewal.
- During the paid period after cancellation, assistants keep working normally.
- Invoices are available from the Billing page and by email.

Downgrades include a 14-day grace period for active assistant count and training-data overages. Extra assistants can be archived rather than immediately deleted. Assistants over training limits can keep responding during the grace window while the owner cleans up sources or upgrades.

After the grace period, archived assistants and their training data can be permanently deleted, and assistants still over limits can be paused until the workspace returns within limits or upgrades.

## Agent Presets and Models

Available agent presets:

- Base instructions.
- Sales agent.
- Teacher.
- Customer support.
- Technical support.

Presets define persona, tone, and workflow behavior. Runtime grounding and safety are enforced separately.

Supported model providers:

- OpenAI GPT models.
- Anthropic Claude models.
- Google Gemini models.
- xAI Grok models.

The model is configured per bot. Teams can set a primary model and optional fallback model. Changing the chat model does not require retraining the knowledge base.

## Limits and Rate Limits

Manual retrain limits:

| Limit | Free | Starter | Growth | Pro | Enterprise |
| --- | --- | --- | --- | --- | --- |
| Full retrains/month/bot | 3 | 8 | 12 | 16 | 500 |
| Single retrains/day/bot | 10 | 50 | 100 | 150 | 5,000 |
| Full retrain cooldown | 24h | 12h | 8h | 6h | 0h |

Public training writes enforce:

- Idempotency key requirement.
- Per-key rate limits.
- Maximum 1 concurrent job per bot.
- Allowed-domain validation.
- Plan source and character limits.

The public training write rate limit is 6 requests per 10-minute window, with idempotency results retained for 24 hours when available.

The widget chat runtime applies bot-level limits by visitor client and IP. Bot settings can control maximum messages per window, the window length in seconds, and localized rate limit messaging.

Chat replies consume workspace AI credits. Zybots checks credits before generation and charges after successful assistant response using a dedupe key.

## Errors and Idempotency

Training write endpoints require:

```http
Idempotency-Key: <unique_key>
```

Requirements:

- Minimum length: 8 characters.
- Maximum length: 128 characters.
- Replaying the same key returns the original accepted result while still available.

Common HTTP status codes:

- `400 Bad Request`: invalid path, query, or JSON body.
- `401 Unauthorized`: missing or invalid authentication.
- `403 Forbidden`: plan gate, access denied, domain denied, or policy failure.
- `404 Not Found`: requested resource not found.
- `409 Conflict`: duplicate or concurrent training conflict.
- `428 Precondition Required`: missing `Idempotency-Key` on training write route.
- `429 Too Many Requests`: rate limit reached.
- `500 Internal Server Error`: unexpected server error.

Widget clients should handle both HTTP errors and in-stream `error` events.