Telegram

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

Batasan

Hanya bahasa agen default yang didukung oleh integrasi ini.

Menyiapkan Telegram

Untuk menyiapkan integrasi Telegram untuk 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 dan masukkan nama
  4. Masukkan nama pengguna untuk bot, berakhiran "bot" (misalnya, garthsweatherbot)
  5. Salin token akses yang dibuat

Menyiapkan Dialogflow

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

Pengujian

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

Membuat Ulang Token Telegram

Untuk membuat ulang token Telegram bagi agen yang telah mengaktifkan integrasi Telegram, lakukan langkah 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 telah mengaktifkan integrasi Telegram, untuk menautkannya ke bot Telegram baru, lakukan langkah berikut:

  1. Buka setelan integrasi Dialogflow, lalu klik STOP.
  2. Hapus bot lama di Telegram jika diperlukan.
  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 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 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 tersebut akan ditutup. Tindakan ini mencegah masalah saat pengguna dapat mengklik tombol yang dilampirkan ke pesan lama dalam percakapan.

Respons payload kustom

Teks dan hyperlink yang diformat dalam integrasi Telegram dengan sekali klik

Bot Telegram Anda dapat mengirim hyperlink dan teks berformat.

Contoh berikut mengirim 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 dalam 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"
          }
        ]
      ]
    }
  }
}