Centro assistenza KWIGA Servizi, integrazioni, API, Impostazioni Servizi Come collegare un bot a KWIGA

Come collegare un bot a KWIGA

Articoli:

Scopri come collegare un chatbot a KWIGA, configurare le integrazioni con le app di messaggistica e usarlo per automatizzare i messaggi e comunicare con i clienti.


In questo articolo:


In KWIGA puoi collegare bot e canali di messaggistica tramite Telegram, WhatsApp, Facebook Messenger, Instagram Direct e Viber.

Per collegare un bot, apri la sezione delle impostazioni pertinente nel tuo account KWIGA, seleziona il servizio di messaggistica, compila i campi richiesti e fai clic su "Salva bot".

1. Telegram

Per collegare un bot Telegram, inserisci:

  • Nome — il nome del bot in KWIGA.

  • Token — il token ricevuto su Telegram da @BotFather dopo aver creato il bot.

Importante:

  • Non condividere il token con nessun altro. Consente di gestire il bot.

  • Se il token è stato compromesso, revocalo e creane uno nuovo tramite BotFather.

2. WhatsApp

Per collegare WhatsApp, inserisci:

  • Nome — il nome della connessione in KWIGA.

  • Token di accesso — un token permanente dell'utente di sistema.

  • ID del numero di telefono — l'ID del numero di telefono.

  • ID dell'account WhatsApp Business (ID WABA) — l'ID dell'account WhatsApp Business.

  • App Secret dell'app Meta — la chiave segreta dell'app Meta.

Importante prima del collegamento

  • Il numero di telefono non deve rimanere collegato alla normale app WhatsApp o a WhatsApp Business. Scollegalo prima di procedere, seguendo le istruzioni per l'integrazione.

  • Se il numero è utilizzato con un altro fornitore, verifica i requisiti per il trasferimento del numero e la verifica a due fattori.

  • L'app Meta deve essere in modalità Live e includere un link all'informativa sulla privacy.

  • Finché Meta non completa la verifica dell'azienda, l'interfaccia di KWIGA indica un limite di 250 nuovi clienti al giorno per l'invio di messaggi. Prima della pubblicazione, verifica che questo limite sia ancora attuale e a cosa si applichi esattamente.

  • Trascorse 24 ore dall'ultimo messaggio del cliente, puoi inviare solo modelli di messaggio approvati da Meta.

  • Per contattare un cliente per la prima volta, devi rispettare le regole di WhatsApp sul consenso del destinatario a ricevere messaggi.

Tieni inoltre presente che Meta stabilisce le tariffe dei messaggi e può imporre restrizioni in base allo stato e alla qualità dell'account.

3. Facebook Messenger

Per collegare Facebook Messenger, inserisci:

  • Nome — il nome della connessione in KWIGA.

  • Token di accesso alla Pagina — il token di accesso alla Pagina Facebook.

  • ID della Pagina — ID della Pagina Facebook.

  • App Secret dell'app Meta — chiave segreta dell'app Meta.

Importante prima della connessione

  • L'app Meta deve essere in modalità Live e includere un link all'informativa sulla privacy.

  • Puoi rispondere a un cliente con un messaggio normale entro 24 ore dal suo ultimo messaggio.

  • Trascorso questo periodo, le regole di Meta limitano l'invio di messaggi normali. Le opzioni di messaggistica speciali sono disponibili solo se vengono soddisfatti i requisiti di Meta.

  • L'integrazione richiede le autorizzazioni appropriate per l'app e l'accesso alla Pagina Facebook.

4. Instagram Direct

Per connettere Instagram Direct, inserisci:

  • Nome — nome della connessione in KWIGA.

  • Token di accesso Instagram (a lunga durata) — token di accesso.

  • ID utente Instagram — ID dell'account Instagram professionale.

  • Instagram App Secret dell'app Meta — chiave segreta dell'app Meta.

Importante prima della connessione

  • L'integrazione richiede un account Instagram professionale — Business o Creator. Gli account personali non supportano questo tipo di integrazione API.

  • L'app Meta deve essere in modalità Live e includere un link all'informativa sulla privacy.

  • Puoi rispondere a un cliente con un messaggio normale entro 24 ore dal suo ultimo messaggio.

  • La possibilità di avviare una conversazione, inviare un messaggio o continuare a chattare dipende dalle regole dell'API di messaggistica di Instagram.

  • L'integrazione richiede che l'app disponga delle autorizzazioni necessarie per la messaggistica.

5. Viber

Per connettere Viber, inserisci:

  • Nome — nome del bot in KWIGA.

  • Token del bot Viber — token ottenuto dal pannello di amministrazione di Viber.

Importante prima della connessione

  • La creazione di un chatbot richiede la registrazione e l'approvazione in base alle attuali condizioni commerciali di Rakuten Viber.

  • Secondo l'attuale modello commerciale di Viber, il costo standard del servizio per un nuovo bot è di €115 al mese. I messaggi avviati dal bot e consegnati comportano costi aggiuntivi. Verifica il costo finale con Viber prima della connessione.

  • In questo modello, i messaggi inviati durante una sessione attiva di 24 ore non vengono addebitati singolarmente.

  • Una sessione inizia quando un iscritto invia un messaggio al bot o risponde a un messaggio avviato dal bot.

  • I messaggi inviati al di fuori di una sessione attiva sono soggetti alle condizioni commerciali di Viber.

Configurazione del bot in KWIGA

Dopo aver connesso un bot a KWIGA, puoi configurarne il funzionamento, i messaggi automatici, i comandi, i pulsanti e altre impostazioni per interagire con gli iscritti.

Le impostazioni disponibili dipendono dall'app di messaggistica connessa.

Posta in arrivo

Configura la gestione delle conversazioni in arrivo e gli orari di attività del bot.

  • Assegnazione automatica delle conversazioni — assegna automaticamente le conversazioni a rotazione ai membri del personale.

  • Orari di attività — imposta il fuso orario e gli orari di attività.

  • Risposta automatica fuori dagli orari di attività — invia automaticamente un messaggio agli iscritti che contattano il bot fuori dagli orari di attività.

Messaggi

Configura i messaggi automatici che il bot invia in diverse situazioni.

A seconda delle funzionalità disponibili, puoi configurare un messaggio di benvenuto per chi contatta il bot per la prima volta, risposte alle domande frequenti e messaggi sull'accesso ai gruppi chiusi.

Comandi

Qui puoi creare comandi per il bot e configurare le risposte che gli iscritti ricevono quando li inseriscono.

I comandi compaiono nel menu del bot e aiutano gli utenti a trovare rapidamente informazioni o ad avviare un'azione. Ad esempio, puoi creare i comandi "Aiuto", "I miei corsi", "Contatti" o "Supporto".

Per ogni comando puoi impostare un nome e la risposta del bot. Per interazioni più complesse — come porre diverse domande agli utenti, raccogliere informazioni o eseguire azioni — puoi collegare il comando a un'automazione.

Sono disponibili anche i comandi di sistema, tra cui //help, //menu, //stop, //unsubscribe e //subscribe, che gestiscono le azioni standard del bot.

Pulsanti

Configura i pulsanti che gli iscritti possono usare per interagire con il bot.

A seconda delle funzionalità disponibili, puoi configurare una tastiera sotto il campo di inserimento e pulsanti sotto i messaggi.

Link

Qui puoi creare link distinti al bot con etichette per le fonti, per monitorare la provenienza dei nuovi iscritti.

Ad esempio, se condividi un link al bot sul tuo sito web, su Instagram e negli annunci, crea un link distinto per ogni fonte e assegnagli un nome appropriato: "Sito web", "Instagram", "Annunci Facebook", ecc.

Per creare un link:

  1. Inserisci il nome della fonte.

  2. Fai clic su "Crea link".

  3. Copia il link generato o scarica il codice QR.

  4. Condividilo nel canale appropriato.

Quando qualcuno segue il link, apre il bot e fa clic su "Avvia", KWIGA registra la fonte. Il numero di nuovi iscritti provenienti da ogni link compare nelle relative impostazioni e nella sezione di analisi "Provenienza degli iscritti".

Vengono conteggiati solo i nuovi iscritti: se qualcuno ha già interagito con il bot, l'apertura successiva di un altro link non verrà conteggiata.

Diagnostica

Controlla la connessione tra il bot e KWIGA, visualizzane lo stato e usa gli strumenti di diagnostica disponibili.

Gli strumenti disponibili dipendono dall'integrazione.