Mengatur webhook saat meneruskan pesan di Telegram

Webhook adalah mekanisme pengiriman data secara otomatis antara situs dan aplikasi saat peristiwa tertentu terjadi. Data dikirim melalui permintaan HTTP: satu aplikasi mengirimkannya melalui internet ke alamat aplikasi lain yang telah ditentukan sebelumnya.

Kemampuan webhook

Di FLOWIN, webhook bekerja dengan penerusan. Webhook dapat terpicu saat pesan muncul, diubah, dihapus, atau disematkan di obrolan asal (sumber), serta saat tombol diklik di obrolan tempat pesan diteruskan (tujuan).

Dengan cara ini, FLOWIN dapat dihubungkan dengan media sosial, bursa, spreadsheet, dan CRM, yaitu sistem untuk mengelola hubungan dengan pelanggan. Hubungan ini disebut integrasi dan memungkinkan Anda:

• Menambahkan permintaan dari Telegram ke CRM secara otomatis.
• Mengirim sinyal perdagangan dari Telegram ke bursa untuk penyalinan transaksi otomatis, yaitu melakukan transaksi secara otomatis berdasarkan sinyal tersebut.
• Meneruskan pesan dari Telegram ke media sosial lain.
• Menyalin postingan dan pesan ke Google Sheets.
• Mengatur balasan otomatis dalam bot.

Untuk setiap skenario, penerimaan data dan tindakan yang diperlukan harus diatur di sisi situs atau aplikasi.

Membuat webhook

Kita akan menguji webhook di webhook.site, situs yang memberikan alamat untuk menerima data dan menampilkan permintaan yang diterima. Kita akan mengirim teks pesan baru dari Telegram ke alamat tersebut.

Untuk ini, diperlukan penerusan yang telah diatur dan aktif di FLOWIN.

0. Buka @flow_in_bot, kirim perintah /start, lalu tekan “Panel kontrol”.

   

1. Buka webhook.site di tab terpisah. Salin alamat untuk menerima permintaan dari bidang “Your unique URL”.

   

2. Di panel FLOWIN, buka “Menu” → “Webhook” lalu klik “Buat”.

   

   

3. Tempelkan alamat yang disalin di bidang paling atas. Di bidang “Isi permintaan”, masukkan {"message":"<message-text>"} lalu klik “Buat”. Ini adalah templat data yang dikirim: sebagai pengganti <message-text> FLOWIN akan menyisipkan teks pesan, dan penerima akan melihatnya di bidang message.

   

4. Klik “Terapkan” pada webhook yang telah dibuat. Centang penerusan yang diperlukan lalu klik “Simpan”.

   

   

5. Kirim pesan pengujian ke obrolan sumber, misalnya “Permintaan No.1042: perlu katalog furnitur.” Kembali ke webhook.site: permintaan pertama yang diterima akan terbuka secara otomatis. Di blok “Request Content”, teks permintaan akan muncul di bidang message. Sekarang FLOWIN akan mengirim teks setiap pesan baru secara otomatis ke alamat yang ditentukan sebelum meneruskannya ke obrolan tujuan.

   

   

Pengaturan webhook

Mari kita bahas pengaturan menggunakan webhook yang telah dibuat sebagai contoh: cara mengubahnya dan arti setiap bidang.

Cara mengubah pengaturan webhook

1. Di daftar “Webhook”, klik “Ubah” pada webhook yang diperlukan.

   

2. Ubah bidang yang diperlukan lalu klik “Simpan”.

   

   

Metode HTTP

Metode HTTP menentukan tindakan permintaan: POST mengirim data untuk diproses, GET meminta data, PUT menggantinya. POST dipilih secara default dan sesuai untuk pengujian kita. Untuk situs atau aplikasi lain, pilih metode yang tercantum dalam dokumentasinya.

Alamat URL

URL berarti alamat di internet. Di sini Anda memasukkan alamat untuk menerima data yang didapat dari situs atau aplikasi yang dihubungkan. Dalam contoh kita, alamat tersebut diberikan oleh webhook.site.

Isi permintaan

Isi permintaan memuat data yang dikirim dalam format JSON, berupa pasangan “nama bidang: nilai”. Susunan bidang bergantung pada persyaratan situs atau aplikasi yang dihubungkan.

Tag meta adalah penanda yang diganti FLOWIN dengan data pesan. Misalnya, <message-text> diganti dengan teks, sedangkan <author-name> dengan nama penulis. Daftar tag meta juga dapat dibuka melalui tautan “tag meta” di bawah bidang.

Header permintaan

“Header permintaan” memuat informasi teknis untuk penerima. Misalnya, kunci akses memungkinkan penerima memeriksa siapa yang mengirim permintaan. Header ditentukan dalam format JSON. Biasanya bidang ini tidak perlu diubah; nilai yang diperlukan diambil dari dokumentasi situs atau aplikasi yang dihubungkan.

Pemicu permintaan

“Pemicu permintaan” menentukan peristiwa dan waktu saat webhook harus mengirim permintaan ke alamat yang ditentukan. Peristiwa berikut dapat dipilih:

• “Pengiriman” dipilih secara default. Webhook terpicu saat pesan baru diteruskan.
• “Pengubahan” terpicu saat perubahan pesan di sumber diproses.
• “Penyematan” terpicu saat penyematan pesan di sumber diproses.
• “Penghapusan” terpicu saat penghapusan pesan di sumber diproses.
• “Klik tombol” terpicu untuk tombol callback di obrolan tujuan. Tombol seperti ini memberi tahu bot tentang klik dan mengirim data yang ditentukan untuknya. Tombol tautan biasa tidak memicu webhook ini.

Waktu pengiriman menentukan pada tahap penerusan mana permintaan dikirim:

• “Sebelum diproses”: permintaan dikirim sebelum penerjemahan dan pemrosesan pesan dengan kecerdasan buatan (AI).
• “Setelah diproses”: permintaan dikirim setelah terjemahan dan pemrosesan AI.
• “Setelah dikirim”: permintaan dikirim setelah pesan berhasil dikirim atau diubah di obrolan tujuan.

Deskripsi

“Deskripsi” adalah catatan untuk kemudahan Anda dan tidak memengaruhi cara kerja webhook. Bidang ini boleh dibiarkan kosong.

Tindakan yang tersedia untuk webhook

Webhook yang telah dibuat dapat dikelola dari daftar “Webhook”:

• “Ubah” membuka pengaturan utama webhook.
• “Gandakan” di menu “Lainnya” membuat salinan pengaturan webhook.
• “Pilih proyek” di menu “Lainnya” menambahkan webhook ke proyek.
• “Hapus” di menu “Lainnya” menghapus webhook.

Selain itu, setiap webhook memiliki tombol “Penerusan [N]” yang membuka pemilihan penerusan tempat webhook diterapkan. N menunjukkan jumlah penerusan yang dipilih. Jika belum ada penerusan yang dipilih, tombol “Terapkan” ditampilkan sebagai gantinya.