Membuat webhook untuk Amazon Chime

Webhook memungkinkan aplikasi web untuk berkomunikasi satu sama lain secara real time. Biasanya, webhook mengirim notifikasi saat tindakan terjadi. Misalnya, katakanlah Anda menjalankan situs belanja online. Webhook dapat memberi tahu Anda ketika pelanggan menambahkan item ke keranjang belanja, membayar pesanan, atau mengirim komentar. Webhook tidak membutuhkan pemrograman sebanyak aplikasi tradisional, dan mereka tidak menggunakan banyak kekuatan pemrosesan. Tanpa webhook, sebuah program harus sering melakukan polling untuk data agar bisa mendapatkannya secara real time. Dengan webhook, aplikasi pengirim memposting data segera.

Webhook masuk yang Anda buat dapat mengirim pesan secara terprogram ke ruang obrolan Amazon Chime. Misalnya, webhook dapat memberi tahu tim layanan pelanggan tentang pembuatan tiket prioritas tinggi baru, dan menambahkan tautan ke tiket di ruang obrolan.

Pesan webhook dapat diformat dengan penurunan harga dan dapat menyertakan emoji. Tautan HTTP dan alamat email dirender sebagai tautan aktif. Pesan juga dapat menyertakan anotasi @All dan @Present untuk memberi tahu semua anggota dan anggota ruang obrolan yang ada. Untuk langsung @mention peserta chat room, gunakan alias atau alamat email lengkap mereka. Misalnya, @aliasatau @[e-mail].

Webhook hanya dapat menjadi bagian dari ruang obrolan dan tidak dapat dibagikan. Administrator ruang obrolan Amazon Chime dapat menambahkan hingga 10 webhook untuk setiap ruang obrolan.

Setelah membuat webhook, Anda dapat mengintegrasikannya dengan ruang obrolan Amazon Chime, seperti yang ditunjukkan dalam prosedur berikut.

Untuk mengintegrasikan webhook dengan ruang obrolan

1. Dapatkan URL webhook dari administrator ruang obrolan. Untuk informasi lebih lanjut, lihatMenambahkan webhook ke ruang obrolandi dalamPanduan Pengguna Amazon Chime.

2. Gunakan URL webhook di skrip atau aplikasi yang Anda buat untuk mengirim pesan ke ruang obrolan:

   1. URL menerima permintaan HTTP POST.

   2. Webhook Amazon Chime menerima payload JSON dengan satu kunciKonten. Berikut ini adalah contoh perintah curl dengan payload sampel:

      curl -X POST "<Insert your webhook URL here>" -H "Content-Type:application/json" --data '{"Content":"Message Body emoji test: :) :+1: link test: http://sample.com email test: [e-mail] All member callout: @All All Present member callout: @Present"}'

      Berikut ini adalah contohPowerShellperintah untuk pengguna Windows:

      Invoke-WebRequest -Uri '<Insert your webhook URL here>' -Method 'Post' -ContentType 'application/JSON' -Body '{"Content":"Message Body emoji test: :) :+1: link test: http://sample.com email test: [e-mail] All member callout: @All All Present member callout: @Present"}'

Setelah program eksternal mengirimkan HTTP POST ke URL webhook, server memvalidasi bahwa webhook valid dan memiliki ruang obrolan yang ditetapkan. Webhook muncul di daftar ruang obrolan dengan ikon webhook di samping namanya. Pesan ruang obrolan yang dikirim oleh webhook muncul di ruang obrolan dengan nama webhook diikuti oleh(Webhook).

catatan

CORS saat ini tidak diaktifkan untuk webhooks.

Memecahkan masalah kesalahan webhook

Berikut ini adalah daftar kesalahan terkait webhook:

• Batas tingkat webhook yang masuk untuk setiap webhook adalah 1 TPS per chat room. Throttling menghasilkan kesalahan HTTP 429.

• Pesan yang diposting oleh webhook harus berukuran 4 KB atau kurang. Payload pesan yang lebih besar menghasilkan galat HTTP 413.

• Pesan yang diposting oleh webhook dengan anotasi @All dan @Present hanya berfungsi untuk ruang obrolan dengan 50 anggota atau lebih sedikit. Lebih dari 50 anggota menghasilkan kesalahan HTTP 400.

• Jika URL webhook diregenerasi, menggunakan URL lama menghasilkan kesalahan HTTP 404.

• Jika webhook di ruangan dihapus, menggunakan URL lama menghasilkan kesalahan HTTP 404.

• URL webhook tidak valid menghasilkan kesalahan HTTP 403.

• Jika layanan tidak tersedia, pengguna menerima kesalahan HTTP 503 dalam respons.