Documentation
Everything you need to ship Vivollo
Guides, channel setup, and references to take your agent from zero to live.
01
Getting Started
- What is Vivollo?Meet the AI agent that answers customers, looks things up, and gets work done across every channel you sell on.
- QuickstartGo from an empty account to a live AI agent answering real customers — in about ten minutes.
- Core conceptsThe seven ideas that make up Vivollo. Learn these once and the whole platform falls into place.
- Navigating the panelA quick tour of the Vivollo dashboard, so you always know where you are and where to go next.
02
Conversations
- DashboardYour at-a-glance home in Vivollo — how busy your agent is, how it's performing, and what needs your attention.
- AnalyticsThe deeper numbers behind your agent — conversation and customer trends, flow performance, and period-over-period comparisons.
- The inboxWhere you and your team read live conversations, jump in, and take over from the AI — with the full story in front of you.
- Live handoffHow a conversation moves from the AI to a human — smoothly, with full context, and back again when the moment passes.
- The visitor journeyEverything Vivollo learns about a visitor — device, location, traffic source, and the pages they browsed — gathered with privacy built in.
- MetafieldsCustom attributes you can attach to conversations and customers — to tag, classify, and remember whatever your business cares about.
- Vision (photos & images)When a customer sends a photo, your agent can actually see it — and reason about what's in it.
03
Channels
- Channels overviewConnect the places your customers already talk to you — WhatsApp, Instagram, your website, your store, your help desk — into one agent.
- Web widgetPut a real-time, on-brand chat on your website in minutes — one snippet, fully white-labeled, streaming replies as they're typed.
- WhatsAppBring your agent to WhatsApp — two-way Business messaging, media, and the same brain that runs every other channel.
- InstagramAnswer Instagram DMs and post comments automatically — turn your most active social channel into a support and sales surface.
- Help desks (Connexease, Gupshup, Grispi)Already running support through a help desk? Connect it so Vivollo works alongside your existing tools and team.
- Connecting your storeGive your agent live access to your catalog and orders — Shopify, WooCommerce, Ticimax, and Trendyol.
04
Knowledge
- Knowledge & CollectionsTeach your agent what it needs to know — your products, policies, and FAQs — so every answer is grounded in your real content.
- TemplatesPick the blueprint that matches your content — Knowledge, Product, Listing, or Custom — and the right fields, search, and filters come preconfigured.
- Fields & filtersThe structure that lets your agent search with precision — typed fields and the filter vocabulary that narrows results to exactly the right ones.
- Adding contentFill your collection from your website, store, help center, files, or API — and keep it fresh automatically.
- How retrieval worksA peek under the hood at how your agent finds the right answer — searching by meaning and keyword, filtering, and reranking for relevance.
05
Assistants
- Assistants overviewThe configurable "mind" behind your agent — its personality, its model, and the knowledge and tools it can reach.
- Configuring an assistantEvery setting on an assistant — instructions, model tier, creativity, length, knowledge, and guardrails — and how to get them right.
- Agentic AIThe autonomous agent at the heart of Vivollo — and the tools it uses to look things up, remember, resolve, and hand off on its own.
06
Flows
- Flows overviewThe visual canvas where you design what your agent says and does — no code, just blocks you connect.
- Build your first flowBuild a real support flow from scratch — greet on open, answer from your knowledge, and hand off when needed.
- Conditions & branchingSend different customers down different paths based on what they've said, who they are, or what you know about them.
- Reusable flows & timingBreak big flows into reusable pieces, and teach your agent to handle silence with idle timers.
- Rich messagesGo beyond plain text with buttons, product carousels, and forms that make a conversation feel like an app.
07
Actions
- Actions referenceEvery building block you can drop into a flow — what it does, when to reach for it, and what each setting means.
- Control actionsThe skeleton of a flow — where it starts, how it waits out silence, and how it wraps up.
- Messaging & capture actionsThe actions for talking to customers and collecting what they tell you — Send Message, Capture User, and Assign User.
- AI & data actionsThe intelligent blocks — asking the AI, the autonomous agent, classifying intent, and searching and answering from your knowledge.
- Flow control actionsBranch a conversation down different paths, and jump between flows — the actions that give a flow its judgment.
- Integration actionsReach beyond Vivollo — call external APIs, update conversations, and act inside your connected help desk.
08
Guardrails
- Guardrails overviewThe safety rules that keep your AI on-topic, on-brand, and compliant — checking every message on the way in and on the way out.
- Guardrail typesThe five kinds of guardrail — pattern, PII, topic, custom-rule, and full PII — and how to choose the right one for each job.
- PII & complianceHow Vivollo detects and protects personal data — the entities it catches, how masking works, and what it means for KVKK and GDPR.
09
Insights
- Insights overviewVivollo reads every conversation and tells you what it learns — why customers reach out, what's trending, and where the agent gets stuck.
- ExplorerSlice your conversations by any dimension, watch trends over time, and read the real chats behind every number.
- FindingsPatterns Vivollo spots on its own — what's rising, what's falling, and what's unusually connected — so you don't have to go looking.
- Knowledge GapsThe questions your agent couldn't answer well — ranked by impact, with one-click drafting to turn each gap into a published answer.
- TaxonomyManage the labels Vivollo uses to classify conversations — the built-in dimensions, your own custom ones, and the values it discovers.
10
Organization
- Organization settingsYour account-wide basics — company name, timezone, language, and how conversations wrap up.
- Team & rolesInvite your teammates and give each the right level of access — from full admin to agents who just answer chats.
- Plans & limitsWhat your plan includes — the features it unlocks and the usage limits it sets — and how to keep an eye on your consumption.
- LocalizationHow Vivollo works across languages — your workspace language, the agent's multilingual replies, and insights in your own tongue.
11
Developer
- Developer overviewConnect Vivollo to your own systems — with API keys, webhooks, and APIs to read data, push content, and react to events.
- API keysCreate and manage the credentials your code uses to talk to Vivollo securely.
- WebhooksGet a real-time notification whenever something happens in Vivollo — so your own systems can react the moment it does.
- REST APIRead and manage your Vivollo data programmatically — conversations, collections, flows, and more — over a straightforward REST API.