Apa Itu Webhooks?
Webhooks adalah mekanisme yang memungkinkan sistem lain menerima notifikasi secara real-time dari platform Utas ketika suatu event tertentu terjadi, seperti pembelian produk atau pembayaran berhasil. Dalam case ini kami akan memberikan gambaran bagaiaman webhook ini dapat digunakan untuk menampilkan notifikasi di telegram via pipedream.
Langkah-Langkah Setup Webhooks di Utas:
- Masuk ke dashboard App Utas, kemudian navigasikan ke: Integrasi > Webhooks
- Klik tombol Tambah Webhook untuk menambahkan webhook.
- Masukkan URL endpoint yang akan menerima notifikasi. URL ini didapatkan dari platform Pipedream ketika membuat workflow baru.
- Pilih event yang ingin Anda pantau (misalnya: new order, paid, shipping, completed order).
- Klik Simpan.
Tutorial Integrasi Webhooks Utas dengan Pipedream
- Pastikan kamu melakukan login di Pipedream.
- Buat workflow baru dan tambahkan trigger.
- Pilih HTPP / Webhook, dan setup sesuai dengan contoh yang ada.
- Pilih Generate Event untuk menambahkan event custom dari UTAS.
- Tambahkan event berupa json pada form body.
Berikut adalah syntaxnya:
{
  "state": "order",
  "name": "xxx",
  "email": "[email protected]",
  "address": "-",
  "store": "xxxx",
  "items": [
    {
      "item_name": "Xxxxx",
      "item_qty": "xx",
      "item_price": "xxx",
      "item_data": "xx"
    }
  ],
  "total": "xx",
  "store_link": "xxx"
}
{
  "state": "paid",
  "name": "xxx",
  "email": "[email protected]",
  "address": "-",
  "store": "xxxx",
  "items": [
    {
      "item_name": "Xxxxx",
      "item_qty": "xx",
      "item_price": "xxx",
      "item_data": "xx"
    }
  ],
  "total": "xx",
  "store_link": "xxx"
}
{
  "state": "shipping",
  "name": "xxx",
  "email": "[email protected]",
  "address": "-",
  "store": "xxxx",
  "items": [
    {
      "item_name": "Xxxxx",
      "item_qty": "xx",
      "item_price": "xxx",
      "item_data": "xx"
    }
  ],
  "total": "xx",
  "store_link": "xxx"
}
{
  "state": "complete",
  "name": "xxx",
  "email": "[email protected]",
  "address": "-",
  "store": "xxxx",
  "items": [
    {
      "item_name": "Xxxxx",
      "item_qty": "xx",
      "item_price": "xxx",
      "item_data": "xx"
    }
  ],
  "total": "xx",
  "store_link": "xxx"
}
- Jika sukses maka klik Continue & pilih Telegram Bot sebagai action berikutnya.
- Selanjutnya pilih Send a Text Message or Reply untuk memberikan aksi berupa mengirim pesan ketika event berhasil di trigger.
- Selanjutnya input telegram botnya dengan menginput token access yang didapatkan ketika membuat bot. Tutorial membuat bot dapat ditemukan ketika klik Select a Telegram Bot Account
- Isi token yang didapatkan di form yang telah disediakan
- Selanjutnya buat grup / channel baru di Telegram, dan pastikan aksesnya adalah public. Copy channel id nya dan input di form yang tersedia.
- Setelah itu tulis pesan yang ingin ditampilkan, kamu juga bisa menginput item_name sebagai nama product & item_price untuk menampilkan harga product.
- Setup berhasil, kamu bisa melakukan testing untuk memastikan apakah pesan masuk. Jika sudah aman kamu bisa melakukan Deploy dan setiap event ter trigger akan mengirimkan pesan ke channel telegram.
