Home / Documentazioni / Chat Bot Integration
Developer Docs

Chat Bot Integration

Integra PROMIUM ASSISTANT nel tuo sito web, e-commerce o applicazione in pochi minuti. Il widget chatbot è distribuito tramite uno snippet JavaScript leggero e personalizzabile.

Tempo integrazione: ~15 minuti Prodotto: PROMIUM ASSISTANT · PROMIUM WEB CONTACT GDPR-ready

Panoramica

Il widget PROMIUM si integra tramite un tag <script> inserito nel <head> o prima della chiusura del </body> di qualsiasi pagina HTML. Il chatbot carica in modo asincrono, senza impatto sulle performance del sito.

Il widget è compatibile con tutti i principali CMS: WordPress, Shopify, Magento, Wix, Webflow, Joomla, Drupal e qualsiasi sito HTML statico.

Quick Start

Incolla questo snippet nel tuo sito sostituendo YOUR_BOT_ID con l'ID del tuo chatbot PROMIUM (disponibile nella dashboard):

HTML — Snippet base 
<!-- PROMIUM Chat Widget -->
<script
  src="https://cdn.promiumai.com/widget/v2/promium-chat.min.js"
  data-bot-id="YOUR_BOT_ID"
  async
></script>

Il widget apparirà automaticamente come bubble nell'angolo in basso a destra della pagina.

Parametri di configurazione

Tutti i parametri vengono passati come attributi data-* nel tag script oppure tramite l'oggetto di configurazione JavaScript window.PromiumConfig.

Parametro Tipo Default Descrizione
data-bot-idstring—Obbligatorio. ID univoco del bot dalla dashboard PROMIUM.
data-positionstringbottom-rightPosizione del widget: bottom-right, bottom-left.
data-langstringautoLingua di partenza. auto rileva dal browser. Es: it, en, de.
data-colorhex#F39200Colore primario del widget (bubble e header).
data-titlestringAssistente AITitolo mostrato nell'header del widget.
data-greetingstring—Messaggio di benvenuto iniziale del bot.
data-openbooleanfalseSe true, il widget si apre automaticamente al caricamento.
data-delaynumber0Ritardo in ms prima dell'apertura automatica (richiede data-open="true").
data-hide-on-mobilebooleanfalseNasconde il widget su dispositivi mobile.
data-z-indexnumber9999Z-index del widget per gestire eventuali conflitti con altri elementi.

Configurazione avanzata

HTML — Configurazione completa 
<!-- PROMIUM Chat Widget — Configurazione avanzata -->
<script>
  window.PromiumConfig = {
    botId:        "YOUR_BOT_ID",
    position:     "bottom-right",
    lang:         "it",
    color:        "#F39200",
    title:        "Supporto PROMIUM",
    greeting:     "Ciao! Come posso aiutarti oggi? 👋",
    open:          false,
    delay:         3000,
    hideOnMobile:  false,
    zIndex:        9999,
    // Callback opzionali
    onOpen:  function() { console.log("Widget aperto"); },
    onClose: function() { console.log("Widget chiuso"); },
    onMessage: function(msg) { console.log("Messaggio inviato:", msg); }
  };
</script>
<script
  src="https://cdn.promiumai.com/widget/v2/promium-chat.min.js"
  async
></script>

JavaScript API

Dopo il caricamento del widget, è disponibile l'oggetto globale window.Promium per controllare il widget programmaticamente.

JavaScript 
// Apri il widget
window.Promium.open();

// Chiudi il widget
window.Promium.close();

// Invia un messaggio predefinito
window.Promium.sendMessage("Vorrei informazioni sui prezzi");

// Imposta variabili di contesto utente
window.Promium.setUser({
  name:    "Mario Rossi",
  email:   "mario@esempio.com",
  plan:    "enterprise",
  locale:  "it-IT"
});

// Ascolta gli eventi
window.Promium.on("message", function(data) {
  console.log("Nuovo messaggio:", data.text);
});

// Distruggi il widget
window.Promium.destroy();

Integrazione per CMS specifici

WordPress — functions.php 
// Aggiungere in functions.php del tema attivo
function promium_widget_script() {
    echo '<script
        src="https://cdn.promiumai.com/widget/v2/promium-chat.min.js"
        data-bot-id="YOUR_BOT_ID"
        async
    ></script>';
}
add_action( 'wp_footer', 'promium_widget_script' );

Canali supportati

WhatsApp Business

Integrazione nativa tramite API ufficiale WhatsApp Business. Richiede account Meta Business Manager verificato.

Telegram Bot

Connessione via Bot API Telegram. Configurabile dalla dashboard PROMIUM con il token del bot.

Email

Integrazione SMTP/IMAP per risposta automatica alle email in entrata su qualsiasi indirizzo aziendale.

SMS

Invio e ricezione SMS tramite Twilio, Vonage o provider dedicato. Ideale per reminder e notifiche.

Widget Web

Snippet JS embed su qualsiasi sito. Personalizzabile nel colore, posizione, lingua e comportamento.

PWA Mobile

Progressive Web App brandizzata inclusa con ogni AI. Push notification native su Android e iOS.

Hai bisogno di aiuto?
Il team PROMIUM supporta l'integrazione tecnica per tutti i clienti. Contatta un AI Specialist →
Pathfinder — Navigazione Guidata