Skip to main content
Understanding the fundamental concepts of Animam.

​
Tenant

A tenant represents your Animam account. Each tenant has:
  • A unique slug (e.g., my-company)
  • A corpus (knowledge base)
  • Segments (contexts)
  • A configurable personality

​
Corpus

The corpus is your chatbot’s knowledge base. It’s the content it uses to answer questions. Each corpus entry has:
  • A title (for organization)
  • Content (the text the bot knows)
  • An optional segment (for context)
  • A priority (high-priority entries are preferred)
Write your corpus as if you were talking to a customer. The bot naturally adopts this tone.

​
Segments

Segments allow different contexts for different pages. Example:
  • Segment landing: general questions about your product
  • Segment pricing: questions about pricing
  • Segment support: technical questions
<!-- Home page -->
<script src="https://animam.ai/widget.js" data-tenant="my-site" data-segment="landing"></script>

<!-- Pricing page -->
<script src="https://animam.ai/widget.js" data-tenant="my-site" data-segment="pricing"></script>

​
Personality

The personality defines how the bot expresses itself:
ParameterDescription
NameThe bot’s name (e.g., “Alice”, “Support”)
TitleIts role (e.g., “Sales Assistant”)
LoreIts background/context
ToneProfessional, casual, friendly
FormalityFormal or informal address
EmojisAllowed or not

​
API Tokens

API tokens allow programmatic API access. Each token has scopes (permissions):
  • corpus:read / corpus:write
  • conversations:read
  • settings:read / settings:write
  • * (full access)
Tokens are only displayed once at creation. Store them securely.

​
Bridges

Bridges are how the agent acts on third-party systems without building a parallel data store. Instead of capturing leads, orders or subscriptions in an Animam-owned table, the agent calls the system the tenant already runs and lets it persist the data — so existing automations (Zapier, notification emails, CRM connectors) keep firing untouched. Today three bridges ship in the WordPress plugin:
BridgeWhat the agent doesWhere data lands
WPFormsSubmits the form on behalf of the visitor through the native WPForms pipelineWPForms entries (existing automations preserved)
WooCommerceSearches products, adds to cart; checkout stays nativeWooCommerce orders
MailPoetSubscribes the visitor to whitelisted lists, double opt-in preservedMailPoet subscribers
Bridges live inside the destination system — Animam never owns the data and the tenant can audit what the agent did inside WPForms entries, WooCommerce orders or MailPoet subscribers like any other action.

​
Connectors

Connectors authenticate the agent into outbound services so the chatbot can act on the tenant’s behalf. Today the platform ships connectors for Google Calendar (BOOK_MEETING + CHECK_AVAILABILITY) and Stripe (COLLECT_PAYMENT). Each connector auto-injects the tools it powers into the agent’s toolbelt — no manual configuration needed once OAuth or API keys are linked.

​
Multi-tenant (Enterprise)

In Enterprise mode, you can create child tenants:
  • A parent dashboard to manage everything
  • Independent child chatbots
  • Complete white-label (no Animam mention)