Form AI v3.0

PROMIUM Contact Form AI

Il Form AI di PROMIUM è molto più di un semplice form di contatto. Qualifica i lead in entrata, categorizza le richieste, instrada automaticamente verso il team giusto e si integra con il tuo CRM — tutto senza codice backend.

Lettura: 10 min API v3.0 GDPR Ready

Funzionalità AI integrate

A differenza dei form tradizionali, il Form AI elabora ogni invio in tempo reale con un layer di intelligenza artificiale che arricchisce i dati del lead prima ancora che arrivi nella tua CRM.

Lead Scoring automatico

Ogni lead riceve un punteggio 0–100 basato su settore, dimensione azienda, budget dichiarato e urgenza percepita nel testo del messaggio.

Categorizzazione intent

Il testo del messaggio viene analizzato e categorizzato in: Acquisto, Supporto, Demo, Preventivo, Partnership, Altro.

Routing intelligente

In base alla categoria e al territorio, il lead viene instradato automaticamente al commerciale o al team di supporto corretto.

Auto-risposta contestuale

L'email di conferma al lead include contenuti personalizzati in base all'intent rilevato (es. brochure prodotto, link case history).

Il Form AI si integra nativamente con PROMIUM Sales AI per la gestione del pipeline commerciale e con PROMIUM Assistant per il follow-up automatico via chat.

Quick Start

  1. Crea un Form nella dashboard

    Dashboard → Form AI → Nuovo Form. Scegli il template (Contatto generico, Richiesta demo, Preventivo, Support ticket) o parti da zero.

  2. Configura i campi e le regole AI

    Aggiungi campi custom, attiva il lead scoring, configura le categorie di intent e imposta le regole di routing.

  3. Connetti le notifiche

    Imposta email di notifica per il tuo team e la risposta automatica per il lead. Configura opzionalmente webhook verso il tuo CRM.

  4. Copia il Form ID e incolla lo snippet

    Il widget si carica automaticamente nel div target con il tuo data-form-id.

Codice Embed

HTML — Snippet base
<!-- PROMIUM Form AI Widget -->
<div id="promium-form"
     data-form-id="TUO_FORM_ID"
     data-lang="it">
</div>
<script src="https://cdn.promiumai.com/form/v3/widget.js" async></script>

Snippet con configurazione completa

HTML — Configurazione avanzata
<div id="promium-form"
     data-form-id="TUO_FORM_ID"
     data-lang="it"
     data-theme="light"
     data-primary-color="#F5671A"
     data-show-logo="false"
     data-success-message="Grazie! Ti risponderemo entro 24 ore."
     data-redirect-url=""
     data-gdpr="true"
     data-gdpr-text="Ho letto e accetto la Privacy Policy."
     data-gdpr-url="https://miosito.com/privacy"
     data-score-visible="false"
     data-prefill-name="Mario Rossi"
     data-prefill-email="mario@azienda.it">
</div>
<script src="https://cdn.promiumai.com/form/v3/widget.js" async></script>

Parametri di configurazione

Parametro Tipo Default Descrizione
data-form-id required string ID univoco del form dalla dashboard.
data-lang string it Lingua interfaccia: it, en, es, fr, de.
data-theme string light light | dark | custom.
data-primary-color string #F5671A Colore HEX per bottoni e accenti (con data-theme="custom").
data-show-logo boolean true Mostra/nasconde il logo PROMIUM nel footer del widget.
data-success-message string Messaggio inviato! Testo mostrato dopo invio riuscito.
data-redirect-url string URL a cui reindirizzare dopo l'invio (se vuoto: mostra messaggio inline).
data-gdpr boolean true Aggiunge checkbox consenso GDPR obbligatoria.
data-gdpr-text string Accetto la Privacy Policy. Testo del consenso GDPR.
data-gdpr-url string URL alla Privacy Policy (inserito come link nel testo GDPR).
data-score-visible boolean false Mostra il lead score all'utente (debug only — non usare in produzione).
data-prefill-name string Pre-compila il campo Nome (utile se l'utente è già loggato).
data-prefill-email string Pre-compila il campo Email.

Configurazione Campi

I campi del form si configurano dalla dashboard con drag & drop. Ogni campo ha le seguenti proprietà:

Tipo campoID internoNote
Testo brevetextNome, Azienda, Telefono, ecc.
EmailemailValidazione formato automatica.
TelefonotelSupporta prefissi internazionali (+39, +1, ecc.).
URLurlSito web azienda, LinkedIn profile, ecc.
Testo lungotextareaMessaggio principale. L'AI analizza questo campo per intent/scoring.
SelectselectMenu a tendina con opzioni predefinite.
RadioradioScelta singola da gruppo di opzioni.
CheckboxcheckboxScelta multipla. Usato anche per consensi.
File uploadfileAllegati PDF/DOC/immagini. Max 10MB per file.
NumeronumberBudget, numero dipendenti, ecc.
DatadateData desiderata per la demo o l'appuntamento.
HiddenhiddenPassaggio di dati nascosti (es. ID campagna, UTM source).

Campi standard raccomandati

Per una qualificazione AI ottimale, includi sempre: Nome, Email aziendale, Azienda, Numero dipendenti (select), Messaggio. Il lead scoring usa questi 5 campi come base.

Routing & Notifiche

Il sistema di routing consente di inviare le notifiche ai team corretti in base a regole configurabili. Le regole vengono valutate in ordine: la prima che corrisponde determina il destinatario.

Esempio di regola routing

JSON — Regola di routing
{
  "routing_rules": [
    {
      "name": "Lead ad alto valore → Sales Senior",
      "conditions": [
        { "field": "ai_score", "operator": "gte", "value": 80 },
        { "field": "ai_intent", "operator": "in", "value": ["acquisto", "demo"] }
      ],
      "actions": {
        "notify_email": "senior-sales@azienda.com",
        "slack_channel": "#leads-hot",
        "crm_pipeline": "enterprise",
        "priority": "alta"
      }
    },
    {
      "name": "Supporto tecnico",
      "conditions": [
        { "field": "ai_intent", "operator": "eq", "value": "supporto" }
      ],
      "actions": {
        "notify_email": "support@azienda.com",
        "ticket_system": "zendesk",
        "priority": "normale"
      }
    }
  ]
}

Template email di notifica

La notifica email al team include automaticamente:

  • Dati compilati nel form
  • AI Score con barra visiva 0–100
  • Intent rilevato con livello di confidenza
  • Sintesi generata dall'AI del messaggio
  • Link diretto al profilo lead nella dashboard
  • Pulsanti azione rapida (Chiama, Email, Assegna)

Qualificazione Lead AI

Il motore di qualificazione AI elabora ogni submission e produce i seguenti output:

Campo generatoTipoDescrizione
ai_score number Punteggio lead 0–100. Basato su settore, dimensione, urgenza, budget.
ai_intent string Categoria intent: acquisto | demo | preventivo | supporto | partnership | altro.
ai_intent_confidence number Confidenza della categorizzazione (0.0–1.0).
ai_summary string Sintesi in 2–3 righe del messaggio del lead.
ai_language string Lingua rilevata del messaggio (es. it, en).
ai_sentiment string Sentiment del messaggio: positivo | neutro | negativo.
ai_urgency string Urgenza percepita: alta | media | bassa.

Webhook

Configura webhook per ricevere i dati del lead (inclusi i campi AI) in tempo reale nel tuo sistema.

Configurazione

Dashboard → Form AI → Il tuo form → Webhook → Aggiungi URL. Il sistema invia una richiesta POST con payload JSON a ogni invio.

Payload Webhook

JSON — Payload esempio
{
  "event": "form.submission",
  "form_id": "TUO_FORM_ID",
  "submission_id": "sub_abc123xyz",
  "timestamp": "2026-06-17T10:30:00Z",
  "data": {
    "nome": "Laura Bianchi",
    "email": "laura@azienda.it",
    "azienda": "Bianchi SRL",
    "dipendenti": "50-200",
    "messaggio": "Vorremmo valutare PROMIUM per il nostro reparto commerciale.",
    "sito_web": "https://bianchi.it"
  },
  "ai": {
    "score": 87,
    "intent": "demo",
    "intent_confidence": 0.94,
    "urgency": "alta",
    "sentiment": "positivo",
    "language": "it",
    "summary": "Lead interessato a PROMIUM per uso commerciale. Alto potenziale di conversione."
  },
  "source": {
    "page_url": "https://tuosito.com/contatti",
    "referrer": "https://google.com",
    "utm_source": "google",
    "utm_campaign": "brand-search"
  }
}

Sicurezza webhook: Ogni richiesta include l'header X-Promium-Signature con HMAC-SHA256 del payload. Verifica sempre la firma prima di processare il payload nel tuo server.

Verifica firma (Node.js)

JavaScript (Node.js)
const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload, 'utf8')
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// In Express:
app.post('/webhook/promium', (req, res) => {
  const signature = req.headers['x-promium-signature'];
  const rawBody   = JSON.stringify(req.body);

  if (!verifyWebhook(rawBody, signature, process.env.PROMIUM_WEBHOOK_SECRET)) {
    return res.status(401).send('Unauthorized');
  }

  const { data, ai } = req.body;
  console.log(`Lead: ${data.email} — Score: ${ai.score}`);
  res.status(200).send('OK');
});

Integrazione CRM

Il Form AI si integra nativamente con i principali CRM attraverso connettori predefiniti:

Salesforce

Crea automaticamente Lead o Contact in Salesforce con i campi AI mappati come custom fields.

HubSpot

Sincronizzazione bidirezionale. Lead score PROMIUM mappato su HubSpot Contact Score.

Pipedrive

Crea deal nel pipeline corretto in base all'intent AI. Assegna owner in base alle regole di routing.

Mailchimp / Brevo

Aggiungi il lead alla lista corretta e avvia un'automation sequence in base all'intent.

Slack

Notifica istantanea nel canale corretto con score, intent e link al lead. Bottoni inline per azioni rapide.

Zapier / Make

Connetti qualsiasi app tramite webhook Zapier o Make (ex Integromat). Trigger: New Form Submission.

Sicurezza & GDPR

Crittografia TLS 1.3

Tutti i dati in transito sono protetti con TLS 1.3. I dati a riposo sono cifrati con AES-256.

GDPR Art. 7 compliant

Consenso esplicito registrato con timestamp, IP e testo esatto mostrato all'utente. Disponibile per audit.

Bot protection

Honeypot invisibile + rate limiting per IP. Opzionale: integrazione reCAPTCHA v3 (score threshold configurabile).

Data retention

Configura la retention automatica dei dati (30/90/365 giorni). Richieste di cancellazione gestibili via API.

PROMIUM è Data Processor ai sensi del GDPR. Il DPA (Data Processing Agreement) è disponibile nella dashboard sotto Impostazioni → Compliance → Scarica DPA.