Berlangganan dan menunggu peristiwa menjalankan alur kerja menggunakan webhook HTTP di Azure Logic Apps
Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)
Daripada menggunakan pemicu yang secara teratur memeriksa atau melakukan polling titik akhir layanan atau tindakan yang memanggil titik akhir tersebut, Anda dapat menggunakan pemicu atau tindakan HTTP Webhook yang berlangganan titik akhir layanan, menunggu peristiwa tertentu, dan menjalankan tindakan tertentu dalam alur kerja Anda.
Berikut adalah beberapa contoh alur kerja berbasis webhook:
- Tunggu hingga peristiwa tiba dari Azure Event Hubs sebelum memicu eksekusi alur kerja.
- Tunggu persetujuan sebelum melanjutkan alur kerja.
Panduan ini menunjukkan cara menggunakan pemicu HTTP Webhook dan tindakan Webhook sehingga alur kerja Anda dapat menerima dan merespons peristiwa di titik akhir layanan.
Bagaimana cara kerja webhook?
Pemicu webhook berbasis peristiwa, yang tidak bergantung pada pemeriksaan atau polling secara teratur untuk data atau peristiwa baru. Setelah Anda menambahkan pemicu webhook ke alur kerja kosong lalu menyimpan alur kerja, atau setelah Anda mengaktifkan kembali sumber daya aplikasi logika yang dinonaktifkan, pemicu webhook berlangganan titik akhir layanan yang ditentukan dengan mendaftarkan URL panggilan balik dengan titik akhir tersebut. Pemicu kemudian menunggu titik akhir layanan tersebut memanggil URL, yang mengaktifkan pemicu dan memulai alur kerja. Mirip dengan pemicu Permintaan, pemicu webhook segera diaktifkan. Pemicu webhook juga tetap berlangganan titik akhir layanan kecuali Anda mengambil tindakan berikut secara manual:
- Ubah nilai parameter pemicu.
- Hapus pemicu lalu simpan alur kerja Anda.
- Nonaktifkan sumber daya aplikasi logika Anda.
Mirip dengan pemicu webhook, pekerjaan tindakan webhook juga berbasis peristiwa. Setelah Anda menambahkan tindakan webhook ke alur kerja yang sudah ada lalu menyimpan alur kerja, atau setelah Anda mengaktifkan kembali sumber daya aplikasi logika yang dinonaktifkan, tindakan webhook berlangganan titik akhir layanan yang ditentukan dengan mendaftarkan URL panggilan balik dengan titik akhir tersebut. Saat alur kerja berjalan, tindakan webhook menjeda alur kerja dan menunggu hingga titik akhir layanan memanggil URL sebelum alur kerja dilanjutkan berjalan. Tindakan webhook berhenti berlangganan dari titik akhir layanan saat kondisi berikut terjadi:
- Tindakan webhook berhasil diselesaikan.
- Eksekusi alur kerja dibatalkan saat menunggu respons.
- Sebelum alur kerja kehabisan waktu.
- Anda mengubah nilai parameter tindakan webhook apa pun yang digunakan sebagai input oleh pemicu webhook.
Misalnya, tindakan Kirim email persetujuan konektor Office 365 Outlook adalah contoh tindakan webhook yang mengikuti pola ini. Anda dapat memperluas pola ini ke layanan apa pun dengan menggunakan tindakan webhook.
Untuk informasi selengkapnya, lihat dokumentasi berikut:
Untuk informasi tentang enkripsi, keamanan, dan otorisasi untuk panggilan masuk ke aplikasi logika Anda, seperti Keamanan Lapisan Transportasi (TLS), yang sebelumnya dikenal sebagai Secure Sockets Layer (SSL), atau Microsoft Entra ID Open Authentication (Microsoft Entra ID OAuth), lihat Akses dan data aman - Akses untuk panggilan masuk ke pemicu berbasis permintaan.
referensi teknis Koneksi or
Untuk informasi selengkapnya tentang parameter pemicu dan tindakan, lihat Parameter Webhook HTTP.
Prasyarat
Akun dan langganan Azure. Jika Anda tidak memiliki langganan Azure, daftar akun Azure gratis.
URL untuk titik akhir atau API yang sudah disebarkan yang mendukung pola berlangganan dan berhenti berlangganan webhook untuk pemicu webhook dalam alur kerja atau tindakan webhook dalam alur kerja yang sesuai
Alur kerja aplikasi logika Standar atau Konsumsi tempat Anda ingin menunggu peristiwa tertentu di titik akhir target. Untuk memulai dengan pemicu HTTP Webhook, buat aplikasi logika dengan alur kerja kosong. Untuk menggunakan tindakan HTTP Webhook, mulai alur kerja Anda dengan pemicu apa pun yang Anda inginkan. Contoh ini menggunakan pemicu HTTP sebagai langkah pertama.
Menambahkan pemicu HTTP Webhook
Pemicu bawaan ini memanggil titik akhir berlangganan pada layanan target dan mendaftarkan URL panggilan balik dengan layanan target. Alur kerja Anda kemudian menunggu layanan target mengirim HTTP POST permintaan ke URL panggilan balik. Ketika peristiwa ini terjadi, pemicu meluncurkan dan meneruskan data apa pun dalam permintaan bersama dengan alur kerja.
Di portal Azure, buka aplikasi logika Standar dan alur kerja kosong di perancang.
Ikuti langkah-langkah umum ini untuk menambahkan pemicu bernama HTTP Webhook ke alur kerja Anda.
Contoh ini mengganti nama pemicu menjadi pemicu HTTP Webhook sehingga langkah tersebut memiliki nama yang lebih deskriptif. Selain itu, contohnya kemudian menambahkan tindakan HTTP Webhook, dan kedua nama tersebut harus unik.
Berikan nilai untuk parameter pemicu HTTP Webhook yang ingin Anda gunakan untuk berlangganan panggilan dan berhenti berlangganan.
Properti Wajib Deskripsi Langganan - Metode Ya Metode yang digunakan saat berlangganan titik akhir target Langganan - URI Ya URL yang digunakan untuk berlangganan titik akhir target Langganan - Isi No Setiap isi pesan untuk disertakan dalam permintaan berlangganan. Contoh ini mencakup URL panggilan balik yang secara unik mengidentifikasi pelanggan, yang merupakan aplikasi logika Anda, dengan menggunakan ekspresi @listCallbackUrl()untuk mengambil URL panggilan balik aplikasi logika Anda.Berhenti Berlangganan - Metode No Metode yang digunakan saat berhenti berlangganan dari titik akhir target Berhenti Berlangganan - URI No URL yang digunakan untuk berhenti berlangganan dari titik akhir target Berhenti Berlangganan - Isi No Isi pesan opsional untuk disertakan dalam permintaan berhenti berlangganan
Catatan: Properti ini tidak mendukung penggunaan fungsilistCallbackUrl(). Namun, pemicu secara otomatis menyertakan dan mengirim header,x-ms-client-tracking-iddanx-ms-workflow-operation-name, yang dapat digunakan oleh layanan target untuk mengidentifikasi pelanggan secara unik.Catatan
Untuk properti Berhenti Berlangganan - Metode dan Berhenti Berlangganan - URI, tambahkan ke tindakan Anda dengan membuka daftar Parameter tingkat lanjut.
Misalnya, pemicu berikut mencakup metode, URI, dan badan pesan yang akan digunakan saat melakukan operasi berlangganan dan berhenti berlangganan.
Jika Perlu menggunakan autentikasi, Anda dapat menambahkan properti Berlangganan - Autentikasi dan Berhenti Berlangganan - Autentikasi . Untuk informasi selengkapnya tentang jenis autentikasi yang tersedia untuk HTTP Webhook, lihat Menambahkan autentikasi ke panggilan keluar.
Lanjutkan membangun alur kerja Anda dengan tindakan yang berjalan saat pemicu diaktifkan.
Setelah selesai, simpan alur kerja. Di bar alat perancang, pilih Simpan.
Menyimpan alur kerja Anda memanggil titik akhir berlangganan pada layanan target dan mendaftarkan URL panggilan balik. Alur kerja Anda kemudian menunggu layanan target mengirim HTTP POST permintaan ke URL panggilan balik. Ketika peristiwa ini terjadi, pemicu meluncurkan dan meneruskan data apa pun dalam permintaan bersama dengan alur kerja. Jika operasi ini berhasil diselesaikan, pemicu berhenti berlangganan dari titik akhir, dan alur kerja Anda berlanjut ke tindakan berikutnya.
Menambahkan tindakan HTTP Webhook
Tindakan bawaan ini memanggil titik akhir berlangganan pada layanan target dan mendaftarkan URL panggilan balik dengan layanan target. Alur kerja Anda kemudian menjeda dan menunggu layanan target mengirim HTTP POST permintaan ke URL panggilan balik. Ketika peristiwa ini terjadi, tindakan meneruskan data apa pun dalam permintaan bersama dengan alur kerja. Jika operasi berhasil diselesaikan, tindakan berhenti berlangganan dari titik akhir, dan alur kerja Anda berlanjut ke tindakan berikutnya.
Contoh ini menggunakan pemicu HTTP Webhook sebagai langkah pertama.
Di portal Azure, buka aplikasi logika standar dan alur kerja Anda di perancang.
Ikuti langkah-langkah umum ini untuk menambahkan tindakan bernama HTTP Webhook ke alur kerja Anda.
Contoh ini mengganti nama tindakan menjadi tindakan HTTP Webhook sehingga langkah tersebut memiliki nama yang lebih deskriptif.
Berikan nilai untuk parameter tindakan HTTP Webhook, yang mirip dengan parameter pemicu HTTP Webhook, yang ingin Anda gunakan untuk panggilan berlangganan dan berhenti berlangganan.
Properti Wajib Deskripsi Langganan - Metode Ya Metode yang digunakan saat berlangganan titik akhir target Langganan - URI Ya URL yang digunakan untuk berlangganan titik akhir target Langganan - Isi No Setiap isi pesan untuk disertakan dalam permintaan berlangganan. Contoh ini mencakup URL panggilan balik yang secara unik mengidentifikasi pelanggan, yang merupakan aplikasi logika Anda, dengan menggunakan ekspresi @listCallbackUrl()untuk mengambil URL panggilan balik aplikasi logika Anda.Berhenti Berlangganan - Metode No Metode yang digunakan saat berhenti berlangganan dari titik akhir target Berhenti Berlangganan - URI No URL yang digunakan untuk berhenti berlangganan dari titik akhir target Berhenti Berlangganan - Isi No Isi pesan opsional untuk disertakan dalam permintaan berhenti berlangganan
Catatan: Properti ini tidak mendukung penggunaan fungsilistCallbackUrl(). Namun, tindakan secara otomatis mencakup dan mengirim header,x-ms-client-tracking-iddanx-ms-workflow-operation-name, yang dapat digunakan oleh layanan target untuk mengidentifikasi pelanggan secara unik.Catatan
Untuk properti Berhenti Berlangganan - Metode dan Berhenti Berlangganan - URI, tambahkan ke tindakan Anda dengan membuka daftar Parameter tingkat lanjut.
Misalnya, tindakan berikut mencakup metode, URI, dan badan pesan yang akan digunakan saat melakukan operasi berlangganan dan berhenti berlangganan.
Untuk menambahkan properti tindakan lainnya, buka daftar Parameter tingkat lanjut.
Misalnya, jika Anda perlu menggunakan autentikasi, Anda dapat menambahkan properti Berlangganan - Autentikasi dan Berhenti Berlangganan - Autentikasi. Untuk informasi selengkapnya tentang jenis autentikasi yang tersedia untuk HTTP Webhook, lihat Menambahkan autentikasi ke panggilan keluar.
Setelah selesai, simpan alur kerja. Di bar alat perancang, pilih Simpan.
Saat tindakan ini berjalan, alur kerja Anda memanggil titik akhir berlangganan pada layanan target dan mendaftarkan URL panggilan balik. Alur kerja kemudian menjeda dan menunggu layanan target mengirim HTTP POST permintaan ke URL panggilan balik. Ketika peristiwa ini terjadi, tindakan meneruskan data apa pun dalam permintaan bersama dengan alur kerja. Jika operasi berhasil diselesaikan, tindakan berhenti berlangganan dari titik akhir, dan alur kerja Anda berlanjut ke tindakan berikutnya.
Output pemicu dan tindakan
Berikut adalah informasi selangkapnya tentang output dari pemicu atau tindakan HTTP Webhook, yang mengembalikan informasi ini:
| Nama properti | Jenis | Deskripsi |
|---|---|---|
| header | object | Header dari permintaan |
| body | object | Objek dengan konten isi dari permintaan |
| status code | int | Kode status dari permintaan |
| Kode status | Deskripsi |
|---|---|
| 200 | OK |
| 202 | Diterima |
| 400 | Permintaan Buruk |
| 401 | Tidak diizinkan |
| 403 | Terlarang |
| 404 | Tidak Ditemukan |
| 500 | Kesalahan Server Internal Terjadi kesalahan yang tidak diketahui. |