Permintaan web dan webhook
Jalankan bot dari peristiwa situs web, atau minta data dari layanan lain melalui reaksi.
Di halaman ini
Situs web dapat memberi tahu bot bahwa ada pendaftaran baru. Sebaliknya, bot dapat menanyakan status pesanan ke situs web. Keduanya menggunakan HTTP, cara yang juga dipakai peramban untuk membuka situs:
| Arah | Yang memulai | Contoh |
|---|---|---|
| Webhook masuk | Layanan lain mengirim pemberitahuan ke GetMyBot dan menjalankan reaksi | Ada pendaftaran baru di situs; bot memberi tahu pengelola |
| Permintaan web keluar | Reaksi meminta data dari layanan lain dan menerima jawabannya | Bot meminta harga atau status pesanan |
Webhook berarti pemberitahuan otomatis dari satu layanan kepada layanan lain. Untuk koneksi yang sudah disiapkan, lihat Integrasi.
Webhook masuk (pemicu)
Pemicu Permintaan web masuk (webhook) menjalankan reaksi saat permintaan HTTP datang dari layanan lain:
- Alamat: aktifkan pemicu dan simpan reaksi. Setelah itu, GetMyBot membuat URL webhook untuk reaksi tersebut dan menampilkannya di kolom ini. Anda dapat menyalinnya, tetapi tidak mengubahnya.
- Token rahasia: mencegah orang lain menjalankan reaksi melalui alamat tersebut.
- Metode: pilih
POST,GET,PUT, atauANY.
Kolom dari permintaan yang diterima tersedia sebagai data sementara reaksi (ctx). Misalnya, jika layanan mengirim order_id, tindakan dapat memakai {{ctx.order_id}}. Setelah mengatur webhook, kirim permintaan percobaan dan periksa apakah reaksi menerima data yang diperlukan.
Permintaan web keluar (aksi)
Tindakan Permintaan web menghubungi layanan lain dari sebuah reaksi:
- metode (
GET,HEAD,OPTIONS,POST,PUT,PATCH, atauDELETE), header, dan isi permintaan (JSON atau teks); - kode hasil yang dianggap berhasil, batas waktu tunggu, dan jumlah percobaan ulang;
- menyimpan jawaban dalam parameter pelanggan atau data sementara
ctx; JSONPath memilih kolom tertentu dari jawaban; - mode asinkron, sehingga bot melanjutkan reaksi tanpa menunggu layanan. Reaksi lain dapat menangani hasil berhasil atau gagal.
Tindakan terkait adalah Muat URL untuk mengambil teks halaman ke ctx, serta Permintaan ke sumber dan Tulis ke sumber untuk koneksi yang sudah disimpan. Baca Sumber dan kunci.
Integrasi webhook
Jika bot rutin mengirim data ke layanan yang sama, atur integrasi Webhook dengan URL dan tanda tangan HMAC. Tanda tangan ini membantu layanan penerima memeriksa asal data. Baca Integrasi.
Keamanan
Gunakan token rahasia pada webhook masuk agar orang lain tidak dapat menjalankan reaksi. Permintaan keluar tidak dapat mengakses alamat jaringan internal melalui GetMyBot. Perlindungan ini dikenal sebagai pencegahan SSRF. Ukuran jawaban layanan lain juga dibatasi.
Selanjutnya
- Pemicu: pemicu webhook masuk.
- Tindakan: Permintaan web dan Muat URL.
- Penggantian nilai dan rumus: data permintaan dalam
ctx.