Langkah ini memungkinkan pengiriman Permintaan HTTP dan menyimpan responsnya sebagai Variabel.
Langkah ini hanya tersedia untuk paket Bisnis dan di atasnya.
Ada dua konfigurasi utama dalam Langkah Permintaan HTTP:
Metode spesifik yang diperlukan untuk permintaan tersebut. Pilih metode yang sesuai dari daftar turun bawah.
Di bidang URL, masukkan titik akhir URL API eksternal untuk mengambil data. Untuk menyertakan Variabel, gunakan awalan "$" untuk mendukung interpolasi teks statis dan Variabel.
Anda sekarang dapat menggunakan alamat IP dan nomor port pada langkah permintaan HTTP, memberi Anda akses langsung ke server dan fleksibilitas untuk mengakses layanan pada port non-standar.
Harap perhatikan bahwa respond.io dan domain label putih masuk daftar hitam. Mengirim panggilan API ke domain ini tidak diperbolehkan, karena dapat menyebabkan masalah perulangan.
Untuk memastikan pengodean yang benar oleh penerima permintaan, perluas bagian Body dan sertakan body beserta Content-Type Header.
Di bagian Header, Anda dapat menambahkan header ke permintaan HTTP secara berpasangan. Kuncinya melambangkan nama header, dan nilainya melambangkan nilai header. Anda dapat menggunakan Variabel sebagai header dengan menambahkan awalan "$". Akan tetapi, ingatlah bahwa hanya 10 header yang diizinkan.
Untuk respons JSON API dengan pasangan kunci-nilai, Anda dapat menyimpan elemen respons tertentu sebagai Variabel. Di bagian Pemetaan Respons, masukkan kunci objek JSON di sebelah kiri dan tetapkan nama untuk variabel di sebelah kanan. Perlu diingat bahwa hanya respons JSON yang dapat disimpan, dan Anda dapat memiliki maksimal 10 pengaturan pemetaan respons.
Contoh:
Untuk menyimpan respons dalam format yang berbeda, isi kunci JSON yang sesuai dengan data yang ingin Anda simpan.
{
"nama": "Jason",
"kode pos": "12345",
"telepon": "123123"
}
Untuk menyimpan nomor telepon dari respons di atas, gunakan $.phone sebagai kunci JSON.
{
"bidang\_khusus": {
"nama_depan": "John",
"Nama Belakang": "Doe",
"lokal": "en\_GB",
"zona waktu": "5",
"jenis kelamin": "laki-laki",
"telepon": "123123",
Bahasa Indonesia: "Surel": "[email protected]",
"ID pelanggan": "1"
},
"dibuat pada": 1575618542
}
Untuk menyimpan nomor telepon dari respons di atas, gunakan $.custom_fields.phone
{
"data": {
"id":"1776025372480910",
"kontak" : \[
{
"firstName":"John",
"lastName":"Doe",
"locale": "en\_GB"
},
{
"firstName":"Jane",
"lastName":"Doe",
"locale": "en\_GB"
}
\]
}
}
Untuk menyimpan nama depan 'Jane' dari respons di atas, gunakan $.data.contacts[1].firstName.
Untuk menyimpan status respons dari permintaan HTTP sebagai Variabel, nyalakan tombol Simpan Status Respons sebagai Variabel . Lalu, beri nama Variabel pada kolom yang disediakan.
Saat diaktifkan, langkah ini akan mengirimkan permintaan HTTP ke URL yang ditentukan, menggunakan badan dan tajuk yang ditentukan.
Anda dapat memandu Alur Kerja berdasarkan status respons. Misalnya, Anda dapat membuat Cabang untuk kode status "sama dengan 200". Jika kode status respons lain diterima, Langkah Lompat dapat mengembalikan Kontak ke Langkah Permintaan HTTP. Alternatifnya, Kontak dapat diarahkan ke Cabang Kegagalan jika kondisi cabang tidak terpenuhi. Jika tidak ada langkah yang disiapkan di bawah Cabang Kegagalan, Alur Kerja akan diakhiri.
Jika permintaan HTTP Anda melebihi 10 detik, maka akan terjadi batas waktu, yang menyebabkan permintaan tersebut gagal.
Untuk menghindari potensi kegagalan dalam mengeksekusi permintaan HTTP, pastikan kondisi berikut terpenuhi:
Gunakan metode HTTP dan Content-Type Header yang benar.
Pastikan untuk menyertakan protokol yang diperlukan http:// atau https:// di URL Anda berdasarkan apa yang didukung sistem Anda untuk menghindari kegagalan permintaan.
Pastikan Tipe Konten valid.
Kecualikan nomor port dari URL.
Hindari penggunaan sertifikat yang ditandatangani sendiri di URL.
Verifikasi bahwa otorisasi tersebut valid.
Pastikan alamat IP kita (52.74.35.155, 18.138.31.163, 54.169.155.20) tidak diblokir.
Jika salah satu kondisi di atas tidak terpenuhi, Kontak akan melewati langkah ini dan melanjutkan perjalanan yang tersisa.
Saat memverifikasi keluaran permintaan HTTP dengan variabel dinamis, ingatlah bahwa Variabel tanpa nilai akan kembali sebagai null dan undefined.
Berikut adalah beberapa praktik terbaik untuk langkah ini yang dapat Anda ikuti untuk mengoptimalkan alur kerja Anda:
Simpan Status Respons sebagai Variabel:
Pastikan langkah pertama adalah menyimpan Status Respons sebagai Variabel untuk tindakan selanjutnya.
Langkah Cabang:
Tambahkan Langkah Cabang untuk mengevaluasi status permintaan HTTP.
Jika statusnya 200, permintaan berhasil.
Jika tidak, konfigurasikan peringatan untuk memberitahukan manajer tentang permintaan yang gagal.
Google Sheet untuk Pemantauan:
Catat Status Respons dalam Google Sheet untuk visibilitas yang jelas mengenai keberhasilan atau kegagalan permintaan.
Komentar:
Tambahkan komentar di alur kerja Anda untuk mendokumentasikan Status Respons. Ini akan membantu Anda melacak dan meninjau kesalahan secara lebih efisien.
Simpan Status Respons sebagai Variabel:
Mirip dengan permintaan yang berhasil, simpan Status Respons sebagai Variabel untuk penanganan kesalahan.
Gunakan Langkah Tunggu atau Lompat untuk Percobaan Ulang:
Terapkan Langkah Tunggu untuk berhenti sejenak sebelum mencoba lagi permintaan yang gagal.
Atau, gunakan Langkah Lompat untuk kembali ke Langkah Permintaan HTTP dan coba permintaan lagi.
Komentar:
Dokumentasikan kesalahan dengan membuat komentar untuk mencatat kesalahan Permintaan HTTP
Sertakan rincian kontak dan tandai orang yang bertanggung jawab.
Google Sheet untuk Pemantauan:
Manfaatkan Google Sheet Step untuk mencatat informasi Kontak dan detail kesalahan untuk pemantauan dan peninjauan.
Penugasan Tugas:
Tetapkan tugas kepada pengguna tertentu untuk memulai proses lain dalam alur kerja dan coba lagi.
Berikut adalah beberapa cara Anda dapat menggunakan Langkah Permintaan HTTP:
Rutekan Kontak VIP: Manfaatkan Langkah Permintaan HTTP untuk mengambil detail Kontak dari gudang data seperti CRM. Hal ini memungkinkan Anda mengidentifikasi Kontak VIP, memberikan pengalaman pelanggan yang dipersonalisasi dan membedakannya dari Kontak non-VIP.
Artikel terkait 👩💻
