Cara mengonfigurasi komponen HTTP Request - Chat App Message Service

Topik ini menjelaskan cara mengonfigurasi komponen HTTP Request, yang mengirim permintaan HTTP ke URL tertentu.

Informasi komponen

Icon	Name
	HTTP Request

Prasyarat

Untuk mengonfigurasi komponen ini, akses kanvas alur melalui alur yang sudah ada atau buat alur baru.

Buka kanvas alur yang sudah ada
Di Chat Flow > Flow Management > Flow Name
Buat alur baru untuk membuka kanvasnya. Untuk informasi selengkapnya, lihat Create a flow.

Prosedur

Klik ikon komponen HTTP Request di kanvas untuk menampilkan panel konfigurasinya di sebelah kanan.
Panel konfigurasi di sebelah kanan mencakup bagian available variables dengan variabel seperti incomingMessage, wabaId, dan wabaPhoneNumber, serta bagian basic settings. Di bagian basic settings, Anda dapat mengonfigurasi Request Method (GET secara default), Timeout (dalam detik), URL (wajib diisi), dan sakelar Failure Branch. Anda juga dapat mengklik Add Request Header dan Add Path Parameter untuk menambahkan opsi lainnya. Setelah selesai, klik Save di pojok kanan atas.
Konfigurasi parameter komponen sesuai kebutuhan. Untuk penjelasan detail, lihat Parameters.
Setelah selesai mengonfigurasi, klik Save. Di kotak dialog yang muncul, klik Save.

Parameter

Parameter	Description	Example
Request Method	Metode HTTP untuk permintaan. Metode berikut didukung: POST GET	Pengaturan dasar juga mencakup parameter berikut: Timeout (dalam detik), URL (wajib diisi), dan Failure Branch (sakelar yang dinonaktifkan secara default).
Timeout	Jumlah waktu dalam detik untuk menunggu respons sebelum permintaan mengalami timeout.
URL	Titik akhir URL yang menerima permintaan.
Content Type	Jika Anda mengatur Content Type ke POST, Anda harus menentukan nilai Content Type. Jenis berikut didukung: application/json application/x-www-form-urlencoded
Failure Branch	Aktifkan sakelar ini untuk mengaktifkan cabang terpisah dalam alur guna menangani permintaan yang gagal.
Request Header Configuration	Konfigurasikan parameter berikut untuk header permintaan: Key Value	Di Key, masukkan `accesstoken`, dan di Value, masukkan nilai token yang sesuai. Untuk mereferensikan variabel yang sudah ada, klik Insert Variable. Untuk menambahkan header permintaan lainnya, klik Add Request Header.
Request Body Configuration	Jika Request Method adalah POST, Anda dapat mengonfigurasi badan permintaan dalam salah satu format berikut: key-value: key value raw: Masukkan konten badan permintaan secara manual. Untuk detailnya, lihat Request body configuration.	Saat mengonfigurasi parameter badan permintaan, pilih mode key-value lalu atur Key dan Value, atau pilih mode raw lalu masukkan konten secara manual. Anda dapat mengklik Insert Variable untuk menambahkan nilai variabel atau mengklik Add Body untuk menambahkan parameter lainnya.
Request Path Configuration	Jika Request Method adalah GET, Anda dapat mengonfigurasi parameter path permintaan: Key Value	Saat mengonfigurasi parameter URL untuk permintaan GET, atur Key menjadi `phone` dan Value menjadi `{{$.PhoneNumber}}`. Anda dapat mengklik + Insert Variable untuk menambahkan nilai variabel atau mengklik + Add Parameter untuk menambahkan parameter lainnya.
Response Variable Configuration	Pastikan nama variabel sesuai dengan kunci dalam objek respons JSON.	Di bagian Response Variable Configuration, masukkan nama variabel. Klik + Add Variable untuk menambahkan variabel lainnya, atau klik ikon hapus untuk menghapus variabel yang sudah ada.

Request body configuration

Anda dapat mengonfigurasi badan permintaan dalam dua mode: Key Value dan Original Value.

Key Value: Mode ini direkomendasikan untuk struktur badan permintaan yang sederhana. Contohnya:
Atur Key pasangan kunci-nilai pertama menjadi MyName dan Value menjadi haiwei.dhw. Untuk pasangan kedua, atur Key menjadi customerName dan Value menjadi variabel {{customerName}}.
Jika Content Type bernilai application/json, format datanya adalah: {"myName": "haiwei.dhw", "customerName": "{{customerName}}"}. Jika Content Type bernilai application/x-www-form-urlencoded, format datanya adalah: "myName=haiwei.dhw&customerName={{customerName}}".
Original Value: Mode ini direkomendasikan untuk struktur permintaan yang kompleks. Mode ini memungkinkan Anda mengedit seluruh badan permintaan secara bebas. Konten yang Anda masukkan harus sesuai dengan Content Type yang dipilih, yaitu application/json atau application/x-www-form-urlencoded.
application/json
Jika Content Type bernilai application/json, badan permintaan mentah dapat disusun sebagai berikut:
```
{
  "customerNames": [
    {
      "name": "{{customerName}}",
      "type": "vip",
      "intentional": true,
      "intentionLevel": 5
    }
  ],
  "myName": "haiwei.dhw",
  "someConplicatedStructure": {
    "a": {
      "b": "c"
    }
  }
}
```
application/x-www-form-urlencoded
Jika Content Type adalah application/x-www-form-urlencoded, badan permintaan dapat disusun sebagai berikut:
```
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

Parameter

Request body configuration

application/json

application/x-www-form-urlencoded