Telegram

L'integrazione di Dialogflow Telegram consente di creare facilmente bot Telegram con la comprensione del linguaggio naturale basata sulla tecnologia Dialogflow.

Limitazioni

Questa integrazione supporta solo la lingua predefinita dell'agente.

Configurazione di Telegram

Per configurare l'integrazione di Telegram per il tuo agente, ti serviranno:

un account Telegram.

Creare un bot in Telegram

Accedi a Telegram e vai all'indirizzo https://telegram.me/botfather
Fai clic sul pulsante Avvia nell'interfaccia web o digita /start
Fai clic su /newbot o digita questo comando e inserisci un nome.
Inserisci un nome utente per il bot che termini 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 token di accesso nel campo correlato.
Fai clic sul pulsante Avvia.

Test

Una volta completata la configurazione, BotFather ti fornirà un link al tuo bot. Vai a questo link per testare l'agente.

Rigenerazione del 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 AVVIA.

Integrazione dell'agente con un nuovo bot Telegram

Per un agente con l'integrazione di Telegram abilitata, per collegarlo a un nuovo bot Telegram, segui questi passaggi:

Vai alle impostazioni di integrazione di Dialogflow e fai clic su INTERROMPI.
Se necessario, elimina il vecchio bot 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 Telegram o digita `/start`.
`TELEGRAM_HELP`	Si attiva quando un utente inserisce `/help` mentre conversa con il tuo bot Telegram.
`TELEGRAM_SETTINGS`	Si attiva quando un utente inserisce `/settings` mentre conversa con il tuo bot Telegram.

Messaggi di risposta avanzati

Sono supportati i seguenti messaggi di risposta avanzata.

Risposte con immagini

Formati e dimensioni supportati:

Dimensione massima 5 MB

Risposte delle schede

È obbligatorio compilare il campo dell'URL dell'immagine o il campo del titolo.

Sono supportati i pulsanti con un URL e con un postback di testo. Quando viene toccato, un pulsante con un URL aprirà una pagina web, mentre un pulsante con del testo invierà 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 chiusi. In questo modo, si evita il problema per cui gli utenti potevano fare clic sui pulsanti allegati ai vecchi messaggi in una conversazione.

Risposte di payload personalizzate

Testo formattato e link ipertestuali nell'integrazione con Telegram con un clic

I bot 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"
  }
}

Per riferimento, consulta la documentazione di Telegram.

Pulsanti della tastiera in linea

Il seguente esempio mostra come definire i pulsanti della tastiera in linea 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"
          }
        ]
      ]
    }
  }
}