Pemberitahuan akhir dukungan: Pada 20 Februari 2026, AWS akan mengakhiri dukungan untuk layanan Amazon Chime. Setelah 20 Februari 2026, Anda tidak akan lagi dapat mengakses konsol Amazon Chime atau sumber daya aplikasi Amazon Chime. Untuk informasi lebih lanjut, kunjungi posting blog
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Webhook memungkinkan aplikasi web untuk berkomunikasi satu sama lain secara real time. Biasanya, webhook mengirim notifikasi saat tindakan terjadi. Misalnya, Anda menjalankan situs belanja online. Webhooks 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 data untuk mendapatkannya secara real time. Dengan webhook, aplikasi pengirim segera memposting data.
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 mengingatkan semua anggota dan anggota ruang obrolan yang hadir. Untuk langsung @mention peserta chat room, gunakan alias atau alamat email lengkap mereka. Misalnya, @ alias atau @alias@domain.com.
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 Anda membuat webhook, Anda dapat mengintegrasikannya dengan ruang obrolan Amazon Chime, seperti yang ditunjukkan dalam prosedur berikut.
Untuk mengintegrasikan webhook dengan ruang obrolan
Dapatkan URL webhook dari administrator ruang obrolan. Untuk informasi selengkapnya, lihat Menambahkan webhook ke ruang obrolan di Panduan Pengguna Amazon Chime.
-
Gunakan URL webhook dalam skrip atau aplikasi yang Anda buat untuk mengirim pesan ke ruang obrolan:
-
URL menerima permintaan HTTP POST.
-
Webhook Amazon Chime menerima payload JSON dengan satu Konten kunci. 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: marymajor@example.com All member callout: @All All Present member callout: @Present"}'Berikut ini adalah contoh PowerShell perintah 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: marymajor@example.com 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 sebelah namanya. Pesan ruang obrolan yang dikirim oleh webhook muncul di ruang obrolan di bawah nama webhook diikuti oleh (Webhook).
catatan
CORS saat ini tidak diaktifkan untuk webhook.
Memecahkan masalah kesalahan webhook
Berikut ini adalah daftar kesalahan terkait webhook:
-
Batas tarif 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 kesalahan 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 dibuat ulang, menggunakan URL lama menghasilkan kesalahan HTTP 404.
-
Jika webhook di ruangan dihapus, menggunakan URL lama menghasilkan kesalahan HTTP 404.
-
Webhook tidak valid URLs menghasilkan kesalahan HTTP 403.
-
Jika layanan tidak tersedia, pengguna menerima kesalahan HTTP 503 dalam respons.
