Kirim Permintaan HTTP melalui Alur Obrolan untuk Mengintegrasikan API Eksternal - Layanan Pesan Aplikasi Obrolan

Topik ini menjelaskan cara mengonfigurasi komponen HTTP Request, yang digunakan untuk mengirim permintaan Hypertext Transfer Protocol (HTTP) ke URL yang ditentukan.

Informasi Komponen

Ikon Komponen	Nama Komponen
	HTTP Request.

Prasyarat

Buka halaman kanvas dari alur yang sudah ada atau buat alur baru.

Buka halaman kanvas dari alur yang sudah ada.
Di Chat Flow > Flow Management, klik Flow Name dari alur yang ingin Anda edit untuk membuka halaman orkestrasi alur.
Buat alur baru untuk membuka halaman kanvas. Untuk informasi selengkapnya, lihat Buat alur.

Prosedur

Klik ikona komponen HTTP Request di kanvas untuk menampilkan area konfigurasi komponen di sebelah kanan.
Konfigurasikan komponen sesuai kebutuhan. Untuk informasi selengkapnya, lihat Item Konfigurasi.
Setelah dikonfigurasi, klik Save. Di kotak dialog yang muncul, klik Save.

Item Konfigurasi

Item Konfigurasi	Deskripsi	Contoh
Request Method	Metode yang didukung: POST. GET.
Timeout	Tetapkan periode timeout respons permintaan.
URL	Tetapkan URL yang menerima permintaan.
Content Type	Jika Anda memilih POST sebagai metode permintaan, tetapkan Content Type. Jenis yang didukung: application/json. application/x-www-form-urlencoded.
Failure Branch	Buka failure branch untuk menangani alur ketika permintaan gagal.
Request Header Configuration	Masukkan informasi berikut: Key. Value.
Request Body Configuration	Jika metode permintaan adalah POST, konfigurasikan badan permintaan: Key-Value: Key. Value. Raw: Masukkan nilai mentah secara manual. Untuk informasi selengkapnya, lihat Konfigurasi dan contoh badan permintaan.
Request Path Configuration	Jika metode permintaan adalah GET, konfigurasikan path permintaan: Key. Value.
Response Variable Configuration	Pastikan nama variabel sesuai dengan kunci objek JSON dalam tanggapan.

Contoh dan Petunjuk Konfigurasi Badan Permintaan

Badan permintaan mendukung dua metode konfigurasi: Key Value dan Original Value.

Key Value: Gunakan metode ini untuk struktur badan permintaan yang sederhana. Berikut contohnya:
Tetapkan Key pasangan kunci-nilai pertama menjadi MyName dan Value-nya menjadi haiwei.dhw. Tetapkan Key pasangan kunci-nilai kedua menjadi customerName dan Value-nya menjadi variabel {{customerName}}.
Jika tipe konten adalah application/json, format datanya adalah: {"myName": "haiwei.dhw", "customerName": "{{customerName}}"}. Jika tipe konten adalah application/x-www-form-urlencoded, format datanya adalah: "myName=haiwei.dhw&customerName={{customerName}}".
Original Value: Gunakan metode ini untuk struktur permintaan yang kompleks. Anda dapat mengedit seluruh badan permintaan secara bebas. Nilai badan permintaan mentah harus sesuai dengan tipe konten yang dipilih, yaitu application/json atau application/x-www-form-urlencoded.
application/json
Jika tipe konten adalah application/json, lihat contoh berikut untuk badan permintaan mentah:
```
{
  "customerNames": [
    {
      "name": "{{customerName}}",
      "type": "vip",
      "intentional": true,
      "intentionLevel": 5
    }
  ],
  "myName": "haiwei.dhw",
  "someConplicatedStructure": {
    "a": {
      "b": "c"
    }
  }
}
```
Application/x-www-form-urlencoded
Jika tipe konten adalah application/x-www-form-urlencoded, lihat contoh berikut untuk badan permintaan mentah:
```
customerNames[0][name]={{customerName}}&customerNames[0]
[type]=vip&customerNames[0]
[intentional]=true&customerNames[0]
[intentionLevel]=5&myName=haiwei.dhw&someConplicatedStructure[a][b]=c
```

Informasi Komponen

Prasyarat

Prosedur

Item Konfigurasi

Contoh dan Petunjuk Konfigurasi Badan Permintaan

application/json

Application/x-www-form-urlencoded