Base di conoscenza

hotline.tg

Integrazioni esterne con Hotline Telegram CRM

Questo articolo parla di un modo per espandere la funzionalità Hotline Telegram CRM utilizzando il tuo bot di supporto (il cosiddetto bot assistente) lavorando sul lato del tuo gruppo di argomenti utilizzando Hotline Topics API.
Utilizzando un assistente bot, puoi aumentare significativamente la comodità e la produttività di lavorare con il sistema:

  • implementa i tuoi comandi sul lato del gruppo di argomenti
  • ottenere informazioni sull'utente da sistemi esterni
  • creare operazioni o chiamare comandi arbitrari in sistemi esterni
  • connettere un bot AI al gruppo per interagire con gli utenti
Nota: Questa pagina contiene frammenti con traduzione automatica. Se hai difficoltà a comprendere queste informazioni, prova a cambiare la lingua in inglese o russo e utilizza il tuo sistema di traduzione di siti web di fiducia.
Anche in Hotline Esistono altri approcci per espandere le funzionalità, descritti in articoli separati:

Come funziona l'assistente bot
  • Ne stai creando uno nuovo Telegram bot tramite @botfather, programmarne il comportamento
  • Il bot viene aggiunto al gruppo backend, da dove può elaborare comandi destinati solo a lui, rispondere a eventi specifici nel gruppo o integrare comandi standard esistenti
  • La parte software del bot interagisce con Topics API (riporta l'indirizzo dell'argomento e riceve le informazioni disponibili sull'utente con cui si sta conducendo il dialogo)
  • Quando connesso a Hotline account utente, il bot può anche vedere i messaggi dell'utente (la modalità di trasmissione corrispondente tramite l'account viene attivata su richiesta in Supporto)
  • Reazione Hotline per i comandi personalizzati è disabilitato tramite il parametro @CUSTOM_COMMANDS@ nel bot di installazione
Puoi implementare tu stesso l'assistente bot o richiedere uno sviluppo a pagamento al nostro servizio di supporto. Il nostro team ha già accumulato una serie di soluzioni standard che possono essere rapidamente adattate a diversi compiti.
Utilizziamo spesso la piattaforma come costruttore per l'assistente bot N8N. La versione gratuita di questa piattaforma è abbastanza funzionale e non è limitata nel numero di chiamate, il sistema può essere installato sul proprio server, consente di rappresentare visivamente l'algoritmo di funzionamento del bot e dispone di numerose connessioni API già pronte con sistemi esterni .
Impostazioni speciali per l'assistente bot in @botfather
Affinché un assistente bot aggiunto a un gruppo di argomenti possa vedere tutti i messaggi degli operatori di sistema, deve specificare parametri speciali in @botfather:

  • Disabilita la modalità Privacy nella sezione Privacy del gruppo (di default è attivo)
  • Consenti l'aggiunta di un bot ai gruppi con il parametro Consenti gruppi
Caso 1: Ottenere informazioni aggiuntive sull'utente da sistemi esterni
L'assistente bot può monitorare i messaggi indicati dagli operatori sul lato del gruppo backend e integrare l'output del comando /info informazioni aggiuntive sull'utente o rispondere a qualsiasi altro comando personalizzato.
Se inserisci il comando richiesto in un argomento per il dialogo con l'utente, l'assistente bot può contattare Topics API sistemi Hotline, fornire l'indirizzo dell'argomento e ricevere informazioni sull'utente nel formato JSON (user_id, language_code, first_name, last_name, username, phone).
Successivamente, l'assistente bot può richiedere ulteriori informazioni sull'utente dal sistema esterno user_id e visualizzarlo in un argomento per l'operatore del sistema.
Ad esempio, tramite l'estensione del comando /info Nel nostro supporto, abbiamo implementato una rapida visualizzazione di un elenco delle istanze attive dell'utente e se ha un abbonamento a pagamento.
Un principio simile può essere utilizzato anche per ottenere qualsiasi altra informazione disponibile sull'utente, ad esempio:

  • elenco delle transazioni degli utenti da parte sua user_id
  • saldo attuale, tariffe utenze connesse
  • elenco dei gruppi condivisi con l'utente
Caso 2: Creazione di una transazione o di un contatto con un utente in un sistema esterno

L'assistente bot può monitorare i messaggi indicati dagli operatori sul lato del gruppo backend e integrare l'output del comando /info informazioni aggiuntive sull'utente o rispondere a qualsiasi altro comando personalizzato.

Tali problemi possono essere risolti da un sistema esterno, mentre Hotline può fungere da interfaccia nativa super conveniente con cui comunicare Telegram utenti (per essere una sorta di front office).
Esempio di integrazione con Notion

Al servizio di supporto Hotline Utilizziamo Notion come sistema per archiviare e strutturare il nostro database clienti (nozione.so).
Quando si invia un comando /notion sul lato dell'argomento del gruppo, i dati del cliente vengono scritti nel database Notion e viene restituito un collegamento alla scheda cliente creata. Facendo clic sul collegamento, puoi accedere rapidamente alla scheda cliente, compilare i tag per il cliente e dargli la priorità.
Notion può presentare comodamente la tua base clienti sotto forma di tabella, bacheca con schede, filtri e ordinamenti. Se necessario, puoi filtrare gli utenti richiesti sul lato Notion, ottenere un elenco dei loro identificatori e, ad esempio, quindi utilizzalo nella tua newsletter.
Richiamando il comando /notion nuovamente nell'argomento dell'utente, l'assistente bot, oltre al collegamento alla scheda, restituisce un elenco di tag specificati per l'utente.
Un'integrazione simile tramite API è possibile con molti altri sistemi: Google Sheets, AMO, Bitrix, SalesForce, ecc.
Caso 3: Collegamento rapido di una tariffa in un sistema esterno per l'utente
Se gli utenti con cui comunichi attraverso Hotline sono anche gli utenti di qualsiasi sistema, quindi l'operatore Hotline può utilizzare l'assistente bot per attivare i metodi necessari.
Esempio 1: Dopo aver accettato e ricevuto il pagamento dall'utente tramite Hotline, puoi inviare un comando simile /activate t1m6, che attiverà per questo utente la Tariffa 1 condizionale per 6 mesi e gli invierà una notifica a riguardo. Il comando viene implementato in modo simile /deactivate.
Esempio 2: squadra / admin La modalità amministratore viene avviata nel bot esterno per gestire le impostazioni dell'utente corrispondente che ha contattato il servizio di supporto.
Caso 4: Creazione di un collegamento con un utente in un sistema esterno
Se è necessario stabilire una connessione tra l'utente Telegram secondo lui user_id con il corrispondente identificatore di account nel sistema esterno, allora è possibile implementare un comando come /link N005
Un comando simile può vincolare uno o più utenti al numero di conto N005. Dopo aver stabilito una connessione con l'utente, il comando /info (Caso 1) può essere integrato visualizzando informazioni sul suo account da un sistema esterno.
Ciò è spesso utile quando si implementa un help desk aziendale, quando più utenti possono scrivere all'help desk da un cliente.
Caso 5: Salvataggio della corrispondenza da un gruppo di argomenti in un sistema esterno
Affinché l'assistente bot possa vedere i messaggi degli utenti ed essere in grado di elaborarli, i messaggi al gruppo di argomenti devono provenire per conto dell'account utente e non del bot. A causa delle restrizioni di Telegram, i bot non possono vedere i messaggi di altri bot nei gruppi.
Attiva una modalità speciale per trasmettere messaggi a un gruppo di argomenti tramite un account utente (userbot) è possibile attraverso il ns Supporto.
Quando la trasmissione di messaggi dagli utenti a un gruppo di argomenti tramite un account è abilitata, questi messaggi diventano disponibili per l'elaborazione da parte dell'assistente bot.
Ciò consente ad esempio di salvare i messaggi in un sistema esterno per eseguire il backup della corrispondenza con i clienti o di utilizzare frammenti di corrispondenza per addestrare l'intelligenza artificiale.
Nota sul salvataggio dei messaggi: Puoi anche creare manualmente copie di backup dei messaggi di un gruppo in qualsiasi momento tramite la funzione Esporta cronologia chat nelle proprietà dell'argomento del gruppo.
Caso 6: Aggiunta di un consulente AI al tuo Telegram account o bot
Quando la trasmissione di messaggi dagli utenti a un gruppo di argomenti tramite un account è abilitata (userbot) l'assistente bot può vedere i messaggi degli utenti.
Successivamente puoi trasmettere messaggi utente con il contesto AI desiderato tramite l'API e ricevere una risposta, che puoi quindi visualizzare nel gruppo di argomenti come commento o inviare direttamente all'utente.
Ad esempio, puoi invitare l'utente a porre la sua domanda mentre aspetti che l'operatore risponda all'intelligenza artificiale in modo che possa provare a risolvere da solo il suo problema.
È buona norma porre domande all’intelligenza artificiale iniziando la domanda con l’indirizzo dell’IA, ad esempio: ai quali comandi ci sono nel sistema?
Puoi anche insegnare all'IA a capire che se viene posta una domanda che inizia con un commento, allora questa è una domanda dell'operatore di sistema e la risposta deve essere data anche sotto forma di commento.
In alternativa, è possibile inviare tutti i messaggi dell'utente per l'analisi AI (questo è più costoso in termini di token AI) ed emettere o meno una risposta in base alla logica richiesta. Ad esempio, rispondere all'utente solo quando l'IA ritiene che la domanda corrisponda esattamente a quanto presente nella sua base di conoscenza.
Per un controllo flessibile del funzionamento dell'intelligenza artificiale, è possibile inserire restrizioni speciali e comandi ausiliari che attivano/disattivano l'intelligenza artificiale in un determinato argomento o cambiano la modalità di comunicazione con l'utente.
Maggiori informazioni sui casi di utilizzo dell'intelligenza artificiale in relazione a Telegram CRM Hotline (presto)
Vedi anche altri modi per espandere la funzionalità Hotline: