L'integrazione di Dialogflow con Telegram consente di creare facilmente bot di Telegram con comprensione del linguaggio naturale basata sulla tecnologia Dialogflow.
Limitazioni
Solo la lingua predefinita dell'agente è supportata da questa integrazione.
Configurazione di Telegram
Per configurare l'integrazione di Telegram per il tuo agente, devi disporre di:
- Un account Telegram.
Creazione di un bot in Telegram
- Accedi a Telegram e vai a https://telegram.me/botfather
- Fai clic sul pulsante Start nell'interfaccia web oppure digita /start
- Fai clic o digita /newbot e inserisci un nome
- Inserisci un nome utente per il bot, che termina con "bot" (ad es. garthsweatherbot)
- Copia il token di accesso generato.
Configurazione di Dialogflow
- In Dialogflow, vai a Integrazioni nel menu a sinistra
- Fai clic sul riquadro Telegram.
- Incolla il valore del campo Access Token (Token di accesso) nel campo correlato.
- Fai clic sul pulsante Inizia.
Test
Una volta completata la configurazione, BotFather fornirà un link al tuo bot. Vai a questo link per testare l'agente.
Rigenerazione del token Telegram in corso...
Per rigenerare il token Telegram per un agente con l'integrazione Telegram abilitata, segui questi passaggi:
- Vai alle impostazioni di integrazione di Dialogflow e fai clic su INTERROMPI.
- Rigenera il token in Telegram.
- Inserisci il nuovo token Telegram nelle impostazioni di integrazione e fai clic su AVVIA.
Integrazione dell'agente con un nuovo bot Telegram
Per collegare un agente con l'integrazione di Telegram abilitata a un nuovo bot di Telegram:
- Vai alle impostazioni di integrazione di Dialogflow e fai clic su INTERROMPI.
- Se necessario, elimina il bot precedente in Telegram.
- Inserisci il nuovo token Telegram nelle impostazioni di integrazione e fai clic su AVVIA.
Eventi
I seguenti eventi vengono attivati da questa integrazione:
| Evento | Descrizione |
|---|---|
TELEGRAM_WELCOME |
Si attiva quando un utente avvia una conversazione con il tuo bot di Telegram o digita /start. |
TELEGRAM_HELP |
Si attiva quando un utente inserisce /help mentre conversa con il bot di Telegram. |
TELEGRAM_SETTINGS |
Si attiva quando un utente inserisce /settings mentre conversa con il bot di Telegram. |
Messaggi di risposta avanzati
Sono supportati i seguenti messaggi di risposta avanzata.
Risposte immagine
Formati e dimensioni supportati:
- Dimensione massima 5 MB
Risposte scheda
Il campo dell'URL dell'immagine o del titolo è obbligatorio.
Sono supportati i pulsanti con un URL e un postback di testo. Quando viene toccato, un pulsante con un URL apre una pagina web, mentre un pulsante con testo invia il testo come query dell'utente.
Risposte rapide
Le risposte rapide nelle integrazioni di Telegram con un solo clic corrispondono ai pulsanti della tastiera in Telegram.
Quando un utente fa clic su uno dei pulsanti, questi vengono ignorati. In questo modo si evita che gli utenti possano fare clic sui pulsanti allegati ai vecchi messaggi di una conversazione.
Risposte payload personalizzate
Testo formattato e link ipertestuali nell'integrazione con Telegram con un solo clic
I bot di Telegram possono inviare testo formattato e link ipertestuali.
L'esempio seguente invia testo formattato con un link ipertestuale utilizzando la modalità di analisi Markdown:
{
"telegram": {
"text": "You can read about *entities* [here](/docs/concept-entities).",
"parse_mode": "Markdown"
}
}
Come riferimento, consulta la documentazione di Telegram.
Tasti della tastiera in linea
L'esempio seguente mostra come definire i pulsanti della tastiera incorporata nell'elemento payload personalizzato.
{
"telegram": {
"text": "Pick a color",
"reply_markup": {
"inline_keyboard": [
[
{
"text": "Red",
"callback_data": "Red"
}
],
[
{
"text": "Green",
"callback_data": "Green"
}
],
[
{
"text": "Yellow",
"callback_data": "Yellow"
}
],
[
{
"text": "Blue",
"callback_data": "Blue"
}
],
[
{
"text": "Pink",
"callback_data": "Pink"
}
]
]
}
}
}