IT ← Home Features Tech Specs Activate WhatsApp Pricing Book a demo →
SuperAgent.fit / Tech Specs

Technical
Specs.

Architecture, internal database, REST API, knowledge base, automations and bulk messaging. Everything a technical team needs to evaluate or integrate SuperAgent.fit.

1
WhatsApp number
per account
∞
Web chat
widgets
20k
Max characters
system prompt
∞
Configurable
automations
01

Channels & Agents.

SuperAgent.fit supports one official WhatsApp number and unlimited web chat widgets, each configurable as an independent agent with its own behaviour.

WhatsApp Business API

One official Meta WhatsApp number per account. Existing or dedicated number, zero ban risk, full WABA compliance.

  • 1 number per account — existing or dedicated
  • Official Meta API — zero ban risk
  • Meta-approved template support
  • WhatsApp 24h session management

Web Chat

Embeddable widget on any website via JS snippet. Unlimited agents, each with dedicated knowledge base and behaviour.

  • Unlimited web chat agents
  • JS snippet — 2-line installation
  • Custom colours and agent name
  • Independent knowledge base per agent
02

Internal Database
Mini CRM.

A fully customisable contact database, integrated directly into the agent engine. Data collected in conversation feeds the profile and drives bot behaviour.

Custom fields

Every database field is configurable. The agent can collect and update any data point during conversation.

  • Standard fields (name, phone, email...)
  • Freely configurable custom fields
  • Data extraction from bot during profiling
  • Field types: text, date, number, select, boolean

Conditional logic

Agent behaviour changes based on contact status. Conditions are configurable on any database field.

  • Differentiated flows by status: cold lead, warm lead, trial, member, ex-member
  • Conditions on any custom field
  • AND/OR logic on field combinations
  • Automatic status change on event trigger

Want to see the database
in action?

Book a free 20-minute technical demo — we'll walk you through the full configuration.

Book a demo → View plans
03

REST API & Integrations.

Two integration modes: the campaign endpoint to send leads from external sources with a contextual WhatsApp message, and the External APIs for full record management with JWT authentication.

Campaign endpoint

Configurable endpoint to receive leads from external sources (forms, CRMs, landing pages) and automatically send a WhatsApp message to the contact at call time.

  • Authentication via x-api-key header
  • Free payload — configurable fields per endpoint
  • Creates lead record + sends WhatsApp in a single call
  • Response with uniqueId and sessionId for traceability
Campaign endpoint call
POST /leads/send/{{endpoint_campagna}}
x-api-key: {{chiave_sorgente}}

{
  "nome": "Marco",
  "cognome": "Rossi",
  "email": "marco@example.com",
  "telefono": "+39 333 123 4567"
}

// → Crea lead + invia WhatsApp di benvenuto

External API — record management

Full APIs to read, create and update records in the internal database. Any update to a trigger-configured field automatically fires the associated WhatsApp template.

  • JWT authentication — POST /data/external/token
  • Available fields — GET /data/external/fields/:code
  • Single or bulk creation — /register and /register/bulk
  • Update with trigger — PUT /data/external/:id
  • Paginated search with filters on any field
  • Bulk update with per-record triggers — up to 100+ in one call
Update with WhatsApp trigger
PUT /data/external/{{record_id}}
x-auth-token: {{jwt_token}}

{
  "data": {
    "status_crm": "qualificato"
  },
  "status": "in-progress",
  "tags": ["qualificato", "followup"]
}

// ⚡ status_crm = trigger → invia template WA

📋 External API endpoints summary

Endpoint Method Function WA Trigger
/data/external/token POST Generate JWT token —
/data/external/fields/:code GET List configured fields —
/data/external/search POST Paginated search with filters —
/data/external/register POST Create single record —
/data/external/register/bulk POST Create multiple records (partial errors tolerated) —
/data/external/:id PUT Update single record ⚡ Sì
/data/external/update/bulk POST Update multiple records ⚡ Sì
/leads/send/:endpoint POST Campaign endpoint — create lead + WhatsApp ⚡ Sì
04

Knowledge Base & Prompt.

The agent only knows what you teach it. The knowledge base is structured for the fitness sector and configurable for each centre.

Knowledge sources

Multiple combinable sources to build a complete, always up-to-date knowledge base.

  • Structured fitness grid: activities, memberships, hours, trial, staff
  • Full scraping of one or more websites
  • Q&A section — custom questions and answers
  • Document upload (PDF, Word, text files)
  • Knowledge base update at any time

System Prompt

Full control over agent behaviour via high-detail system prompt.

  • Maximum 20,000 characters system prompt
  • Define tone of voice, personality, boundaries
  • Structured conversational flows
  • Instructions for data collection and escalation
  • Separate configuration per channel (WhatsApp vs web chat)
05

Automations & Triggers.

A trigger section with preconfigured automations for the fitness sector and the ability to create unlimited custom logic.

⚡ Preconfigured automations — activate immediately

Trigger When Default schedule Type
Membership expiry Before expiry −60 / −30 / −10 days Prefigurato
Medical certificate Before expiry −60 / −30 / −10 days Prefigurato
Lead status change On database status change Immediate Prefigurato
Unconverted trial follow-up N days after trial Configurable Prefigurato
Appointment reminder Before an appointment −24h / −1h Prefigurato
Any custom automation Any event or condition Configurable Custom

Trigger logic

  • Date-based triggers (expirations, anniversaries, custom dates)
  • Event-based triggers (field change, bot action, API call)
  • Conditions on any database field
  • Actions: WhatsApp message, field update, status change
  • Unlimited configurable automations

Messages in automations

  • Text templates with dynamic variables from database
  • Variables: name, expiry, link, custom fields
  • Media support: images, attached PDFs
  • Quick reply buttons (CTA buttons)
  • Each message can re-activate the conversation with the agent
06

Bulk Messaging
WhatsApp Newsletter.

Bulk campaigns via official WhatsApp API. CSV import, list segmentation, no sending limits.

Broadcast campaigns

Send messages to contact lists officially, safely and without volume limitations.

  • No sending volume limit
  • List import from CSV file
  • Segmentation by tag, status, custom fields
  • Message personalisation with variables (name, etc.)
  • Scheduled sending — future date and time
  • Official WhatsApp API — zero account ban risk

Import & formats

Simple import from any source that exports CSV. Configurable column mapping.

  • CSV import with custom column mapping
  • Automatic deduplication by phone number
  • List preview before sending
  • Delivery report: sent, read, errors
  • Automatic opt-out management
Accepted CSV format
phone,name,status,expiry_date
+39333123456,Marco R.,iscritto,2026-06-30
+39334987654,Sara B.,ex_iscritto,2025-12-31
// Qualsiasi colonna custom è mappabile

Ready to set up
your SuperAgent?

Talk to our technical team. We'll walk through the full architecture for your specific use case.

Book a technical demo → Message us on WhatsApp