Telegram

Integrasi Telegram Dialogflow memungkinkan Anda membuat bot Telegram dengan natural language understanding berdasarkan teknologi Dialogflow dengan mudah.

Batasan

Hanya bahasa agen default yang didukung oleh integrasi ini.

Menyiapkan Telegram

Untuk menyiapkan integrasi Telegram bagi agen, Anda memerlukan hal berikut:

Membuat Bot di Telegram

  1. Login ke Telegram dan buka https://telegram.me/botfather
  2. Klik tombol Start di antarmuka web atau ketik /start
  3. Klik atau ketik /newbot, lalu masukkan nama
  4. Masukkan nama pengguna untuk bot, yang diakhiri dengan "bot" (misalnya, garthsweatherbot)
  5. Salin token akses yang dibuat

Menyiapkan Dialogflow

  1. Di Dialogflow, buka Integrations di menu sebelah kiri
  2. Klik kartu Telegram
  3. Tempelkan Token Akses ke kolom terkait
  4. Klik tombol Start

Pengujian

BotFather akan memberikan link ke bot Anda setelah Anda menyelesaikan penyiapan. Buka link ini untuk menguji agen Anda.

Membuat Ulang Token Telegram

Untuk membuat ulang token Telegram untuk agen dengan integrasi Telegram yang diaktifkan, lakukan hal berikut:

  1. Buka setelan integrasi Dialogflow, lalu klik STOP.
  2. Buat ulang token di Telegram.
  3. Masukkan token Telegram baru di setelan integrasi, lalu klik MULAI.

Mengintegrasikan Agen dengan Bot Telegram Baru

Untuk agen yang mengaktifkan integrasi Telegram, agar dapat menautkan agen ke bot Telegram baru, lakukan hal berikut:

  1. Buka setelan integrasi Dialogflow, lalu klik STOP.
  2. Hapus bot lama di Telegram jika perlu.
  3. Masukkan token Telegram baru di setelan integrasi, lalu klik MULAI.

Acara

Peristiwa berikut dipicu oleh integrasi ini:

Acara Deskripsi
TELEGRAM_WELCOME Dipicu saat pengguna memulai percakapan dengan bot Telegram Anda atau mengetik /start.
TELEGRAM_HELP Dipicu saat pengguna memasukkan /help saat berkomunikasi dengan bot Telegram Anda.
TELEGRAM_SETTINGS Dipicu saat pengguna memasukkan /settings saat berkomunikasi dengan bot Telegram Anda.

Pesan respons lengkap

Pesan respons kaya berikut didukung.

Respons gambar

Format dan ukuran yang didukung:

  • Ukuran maks. 5 MB

Respons kartu

Kolom URL gambar atau kolom judul wajib diisi.

Tombol dengan URL dan dengan postback teks didukung. Saat diketuk, tombol dengan URL akan membuka halaman web, sedangkan tombol dengan teks akan mengirim teks sebagai kueri pengguna.

Respons balasan cepat

Balasan cepat dalam integrasi Telegram sekali klik sesuai dengan tombol keyboard di Telegram.

Saat pengguna mengklik salah satu tombol, tombol akan ditutup. Hal ini mencegah masalah saat pengguna dapat mengklik tombol yang dilampirkan ke pesan lama dalam percakapan.

Respons payload kustom

Teks berformat dan hyperlink dalam integrasi Telegram sekali klik

Bot Telegram Anda dapat mengirim teks dan hyperlink yang diformat.

Contoh berikut mengirimkan teks berformat dengan hyperlink menggunakan mode penguraian Markdown:

{
  "telegram": {
    "text": "You can read about *entities* [here](/docs/concept-entities).",
    "parse_mode": "Markdown"
  }
}

Lihat dokumentasi Telegram untuk referensi.

Tombol Keyboard Inline

Contoh berikut menunjukkan cara menentukan Tombol Keyboard Inline di elemen Payload kustom.

{
  "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"
          }
        ]
      ]
    }
  }
}