Guida all'integrazione per sviluppatori
Panoramica per sviluppatori
WebChatAgent offre tre modalità per mettere a disposizione un Chatbot ai tuoi utenti. Scegline una in base al livello di controllo desiderato sull'interfaccia.
| Integrazione | Cosa include | Ideale per |
|---|---|---|
| Incorporamento Widget | Una UI di chat pronta all'uso tramite un singolo tag script | Siti web e applicazioni web |
| REST API | Invia un messaggio, ricevi una risposta (richiesta/risposta) | UI personalizzate, app mobili, script lato server |
| WebSocket API | Flusso di messaggi in tempo reale con digitazione e presenza | Bacheche di Chat dal vivo, strumenti per operatori |
Tutte e tre le opzioni comunicano con lo stesso Chatbot, condividono la stessa Base di conoscenza e scalano dalla stessa quota di messaggi. Puoi combinarle, ad esempio incorporando il Widget sul tuo sito e creando una dashboard interna per operatori tramite WebSocket API.
Incorporamento Widget (Il più veloce)
Aggiungi il Chatbot a qualsiasi Sito Web con un singolo tag script e un elemento HTML personalizzato (<web-chat-agent chatbot-id="...">). Nessun framework, nessun passaggio di build. Tutti i colori, i testi e gli strumenti si configurano nella dashboard e vengono applicati automaticamente. È la scelta consigliata per il 90% dei siti web.
- Guida all'incorporamento del Widget: tag script, elemento personalizzato, tutti gli attributi HTML, CSS personalizzato, modalità Chat integrata e utilizzo in SPA
REST API
Quando hai bisogno di un'interfaccia di chat personalizzata, come un'app mobile, un componente web dedicato o un'automazione backend, chiama direttamente l'endpoint di chat. Invii un message insieme al tuo chatbotId e ricevi una reply generata dall'IA con le relative origini. Un ID Sessione restituito nell'header di risposta mantiene coerenti le conversazioni su più turni.
- Riferimento REST API: endpoint, autenticazione basata su Dominio, campi di richiesta/risposta, codici di Errore ed esempi di codice in cURL, JavaScript, Python e PHP
WebSocket API
Per la Chat dal vivo, dove i messaggi devono arrivare all'istante e sono necessari indicatori di digitazione, presenza e Traduzione automatica. Lo stesso socket gestisce sia i Widget per il Visitatore che la dashboard per gli operatori. Usalo per creare una console operatore personalizzata o per gestire la Chat dal vivo dal tuo backend.
- Riferimento WebSocket API: Connessione, ruoli, eventi inviati e ricevuti ed esempio funzionante di client
Quale opzione usare?
| Caso d'uso | Consigliato |
|---|---|
| Aggiungere un Chatbot a un Sito Web | Incorporamento Widget |
| Mostrare la chat all'interno del layout della tua pagina | Chat integrata (incorporamento Widget) |
| UI di chat personalizzata o app mobile | REST API |
| Automazione server-to-server (senza interfaccia) | REST API |
| Bacheca di Chat dal vivo in tempo reale per operatori umani | WebSocket API |
Consulta Casi d'uso per scenari concreti supportati da queste integrazioni.