Salta ai contenuti
API di consegna
Prima di pianificare in base a una funzionalità, consulti lo stato delle funzionalità.

GuideCoinvolgimento

Chatbot del sito web

Aggiunga un chatbot Atlas al Suo sito web, con flussi predefiniti, risposte dell'IA basate sui Suoi contenuti e raccolta di contatti commerciali.

Questa pagina è stata tradotta dall'inglese. In caso di differenze, fa fede la versione inglese. Leggi in inglese

  • Flussi predefiniti creati in Studio: saluti, pulsanti, domande e raccolta di contatti commerciali.
  • Risposte dell’IA basate sui contenuti pubblicati del Suo sito, pagate con i crediti IA del Suo piano. Quando i crediti sono esauriti, il bot mostra il proprio messaggio di ripiego.
  • Aspetto e attivatori: colori, immagine del pulsante di avvio e momento di apertura, impostati per sito in Studio.
  • Turnstile come protezione quando la conversazione sembra automatizzata.
  • Contatti commerciali: i dati che un visitatore condivide in un passaggio di raccolta arrivano in Forms & leads → Leads, come le richieste dei moduli.

Non esiste ancora un passaggio in diretta a un operatore umano.

I chatbot arrivano in Produzione all’interno dei rilasci. Quando la Produzione è attiva e un rilascio firmato è online, il chatbot rilasciato risponde ai visitatori reali, usando le conoscenze ricavate dalle pagine di quel rilascio (fino a 5.000 brani). Le modifiche fatte in Sviluppo raggiungono i visitatori solo con il successivo rilascio approvato.

Finché la Produzione è disattivata, gli indirizzi del chatbot rispondono 404 CP_NOT_FOUND; con la Produzione attiva ma senza un rilascio online, 403 CP_PRODUCTION_LOCKED.

  1. Mostri il widget una sola volta nel layout principale. Non richiede alcun token: il browser comunica direttamente con Atlas e Atlas accetta solo l’origine registrata del Suo sito web.

    app/atlas-chat.tsx
    'use client';
    import { AtlasChat } from '@atlas/chat-widget';
    import '@atlas/chat-widget/styles.css';
    import { usePathname } from 'next/navigation';
    export function SiteChat() {
    const path = usePathname();
    return (
    <AtlasChat
    apiOrigin="https://delivery.atlas.example"
    environmentId="env_XXXXXXXX"
    botKey="support"
    path={path}
    />
    );
    }
  2. Consenta Atlas nella Sua Content-Security-Policy: aggiunga l’origine dell’API di Atlas a connect-src e img-src.

  3. Usi l’id dell’ambiente di Produzione nella distribuzione online e quello di Sviluppo ovunque altrove.

Il pacchetto del widget viene distribuito direttamente ai clienti collegati; non è ancora sul registro npm pubblico. Senza React, usi il client semplice createChatClient({ apiOrigin, environmentId, botKey }), che offre bot(), start(path) e send(…).

  • Le conversazioni sono legate a un segreto casuale conservato nella session storage del visitatore. Non ci sono cookie.
  • I dati dei contatti commerciali vengono archiviati solo quando il visitatore li invia in un passaggio di raccolta.
  • I limiti di frequenza si applicano per indirizzo IP e per conversazione; vedere Limiti.