Basis pengetahuan GetMyBot

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:

ArahYang memulaiContoh
Webhook masukLayanan lain mengirim pemberitahuan ke GetMyBot dan menjalankan reaksiAda pendaftaran baru di situs; bot memberi tahu pengelola
Permintaan web keluarReaksi meminta data dari layanan lain dan menerima jawabannyaBot 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, atau ANY.

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, atau DELETE), 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