L'integrazione di Dialogflow Telegram ti consente di creare facilmente bot Telegram con la comprensione del linguaggio naturale basata sulla tecnologia Dialogflow.
Limitazioni
Solo il lingua predefinita dell'agente è supportato da questa integrazione.
Configurazione di Telegram
Per configurare l'integrazione di Telegram per il tuo agente, avrai bisogno della seguenti:
- un account Telegram.
Creare un bot in Telegram
- Accedi a Telegram e vai all'indirizzo https://telegram.me/botfather
- Fai clic sul pulsante Start nell'interfaccia web o 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 Integrations (Integrazioni) nel menu a sinistra
- Fai clic sul riquadro Telegramma.
- Incolla il Token di accesso nel relativo campo
- Fai clic sul pulsante Inizia.
Test
BotFather fornirà un link al tuo bot una volta completata la configurazione. Vai a
questo link per testare l'agente.
Rigenerazione token Telegram
Per rigenerare il token Telegram per un agente con l'integrazione di 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 INIZIA.
Integrazione dell'agente con un nuovo bot Telegram
Per un agente con l'integrazione di Telegram abilitata, per collegarlo 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 INIZIA.
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 Telegram o digita /start. |
TELEGRAM_HELP |
Si attiva quando un utente inserisce /help durante la conversazione con il tuo 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 con schede
Il campo dell'URL dell'immagine o il campo del titolo è obbligatorio.
Sono supportati i pulsanti con un URL e un postback di testo. Se 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 tasti della tastiera di Telegram.
Quando un utente fa clic su uno dei pulsanti, questi vengono ignorati. In questo modo si evita che gli utenti facciano clic sui pulsanti allegati a vecchi messaggi in una conversazione.
Risposte payload personalizzate
Testo formattato e link ipertestuali nell'integrazione di Telegram con un solo clic
I bot di Telegram possono inviare testo formattato e link ipertestuali.
L'esempio seguente invia un 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" } }
Per riferimento futuro, consulta la documentazione di Telegram.
Pulsanti della tastiera in linea
L'esempio seguente mostra come definire i pulsanti della tastiera in linea nell'elemento del 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"
}
]
]
}
}
}