EN ← Home Funzionalità Specifiche Tecniche Attiva WhatsApp Pricing Prenota una demo →

Specifiche
Tecniche.

Architettura, database interno, API REST, knowledge base, automazioni e invio massivo. Tutto quello che serve a un team tecnico per valutare o integrare SuperAgent.fit.

1
Numero WhatsApp
collegabile per account
Web chat
configurabili
20k
Caratteri max
system prompt
Automazioni
configurabili

Canali & Agenti.

SuperAgent.fit supporta un numero WhatsApp ufficiale e un numero illimitato di web chat, ognuno configurabile come agente indipendente con il proprio comportamento.

Web Chat

Widget incorporabile su qualsiasi sito web tramite snippet JS. Agenti illimitati, ognuno con knowledge base e comportamento dedicati.

  • Agenti web chat illimitati
  • Snippet JS — installazione in 2 righe
  • Personalizzazione colori e nome agente
  • Knowledge base indipendente per agente

Database Interno
Mini CRM.

Un database contatti completamente personalizzabile, integrato direttamente nel motore dell'agente. I dati raccolti in conversazione alimentano il profilo e guidano il comportamento del bot.

Campi personalizzabili

Ogni campo del database è configurabile. L'agente può raccogliere e aggiornare qualsiasi dato durante la conversazione.

  • Campi anagrafici standard (nome, tel, email...)
  • Campi custom configurabili liberamente
  • Estrazione dati dal bot in fase di profilazione
  • Tipi di campo: testo, data, numero, select, booleano

Logiche condizionali

Il comportamento dell'agente cambia in base allo stato del contatto. Le condizioni sono configurabili su qualsiasi campo del database.

  • Flussi differenziati per stato: lead freddo, lead caldo, in prova, iscritto, ex iscritto
  • Condizioni su qualsiasi campo custom
  • Logiche AND/OR su combinazioni di campi
  • Cambio automatico stato al verificarsi di un evento

Vuoi vedere il database
in azione?

Prenota una demo tecnica gratuita di 20 minuti — ti mostriamo la configurazione completa.

Prenota una demo → Vedi i piani

API REST & Integrazioni.

Due modalità di integrazione: l'endpoint campagna per inviare lead da sorgenti esterne con messaggio WhatsApp contestuale, e le API External per gestione completa dei record con autenticazione JWT.

API External — gestione record

API complete per leggere, creare e aggiornare i record del database interno. Ogni aggiornamento di un campo configurato come trigger scatena automaticamente il template WhatsApp associato.

  • Autenticazione JWT — POST /data/external/token
  • Lista campi disponibili — GET /data/external/fields/:code
  • Creazione singola o bulk — /register e /register/bulk
  • Aggiornamento con trigger — PUT /data/external/:id
  • Ricerca paginata con filtri su qualsiasi campo
  • Bulk update con trigger per record — fino a 100+ in una chiamata
Aggiornamento con trigger WhatsApp
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

📋 Riepilogo endpoint API External

Endpoint Method Funzione Trigger WA
/data/external/token POST Genera token JWT
/data/external/fields/:code GET Lista campi configurati
/data/external/search POST Ricerca paginata con filtri
/data/external/register POST Crea singolo record
/data/external/register/bulk POST Crea più record (errori parziali tollerati)
/data/external/:id PUT Aggiorna singolo record ⚡ Sì
/data/external/update/bulk POST Aggiorna più record ⚡ Sì
/leads/send/:endpoint POST Endpoint campagna — crea lead + WhatsApp ⚡ Sì

Knowledge Base & Prompt.

L'agente conosce solo quello che gli insegni tu. La knowledge base è strutturata per il settore fitness e configurabile su misura per ogni centro.

Fonti di conoscenza

Più fonti combinabili per costruire una base di conoscenza completa e sempre aggiornata.

  • Griglia strutturata fitness: attività, abbonamenti, orari, prova, staff
  • Scraping completo di uno o più siti web
  • Sezione Q&A — domande e risposte personalizzate
  • Caricamento documenti (PDF, Word, testi)
  • Aggiornamento knowledge base in qualsiasi momento

System Prompt

Controllo completo del comportamento dell'agente tramite prompt di sistema ad alto dettaglio.

  • Massimo 20.000 caratteri di system prompt
  • Definizione tono di voce, personalità, limiti
  • Flussi conversazionali strutturati
  • Istruzioni per la raccolta dati e l'escalation
  • Configurazione separata per canale (WhatsApp vs web chat)

Automazioni & Trigger.

Una sezione trigger con automazioni preconfigurate per il settore fitness e la possibilità di creare logiche personalizzate illimitate.

⚡ Automazioni preconfigurate — attivabili immediatamente

Trigger Quando Cadenza default Tipo
Scadenza abbonamento Prima della scadenza −60 / −30 / −10 giorni Prefigurato
Certificato medico Prima della scadenza −60 / −30 / −10 giorni Prefigurato
Cambio stato lead Al cambio di stato nel database Immediato Prefigurato
Follow-up prova non convertita Dopo N giorni dalla prova Configurabile Prefigurato
Reminder appuntamento Prima di un appuntamento −24h / −1h Prefigurato
Qualsiasi automazione custom Qualsiasi evento o condizione Configurabile Custom

Logica trigger

  • Trigger basati su data (scadenze, anniversari, date custom)
  • Trigger basati su evento (cambio campo, azione bot, API call)
  • Condizioni su qualsiasi campo del database
  • Azioni: messaggio WhatsApp, aggiornamento campo, cambio stato
  • Automazioni illimitate configurabili

Messaggi nelle automazioni

  • Template di testo con variabili dinamiche dal database
  • Variabili: nome, scadenza, link, campi custom
  • Supporto media: immagini, PDF allegati
  • Pulsanti di risposta rapida (CTA buttons)
  • Ogni messaggio può riattivare la conversazione con l'agente

Invio Massivo
Newsletter WhatsApp.

Campagne di invio massivo tramite API ufficiale WhatsApp. Import da CSV, segmentazione per liste, nessun limite di invio.

Import & formati

Importazione semplice da qualsiasi sorgente che esporta in CSV. Mappatura colonne configurabile.

  • Import da CSV con mappatura colonne custom
  • Deduplicazione automatica per numero di telefono
  • Preview lista prima dell'invio
  • Report di consegna: inviati, letti, errori
  • Gestione opt-out automatica
Formato CSV accettato
phone,name,status,expiry_date
+39333123456,Marco R.,iscritto,2026-06-30
+39334987654,Sara B.,ex_iscritto,2025-12-31
// Qualsiasi colonna custom è mappabile

Pronto a configurare
il tuo SuperAgent?

Parla con il nostro team tecnico. Ti mostriamo l'intera architettura sul tuo caso d'uso specifico.

Prenota una demo tecnica → Scrivici su WhatsApp