Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Integrasi kendur
Dengan konektor aksi Slack, Anda dapat mengakses platform Slack langsung di Amazon Quick melalui bahasa alami. Anda dapat mengirim pesan, mengelola saluran, mencari konten, dan berinteraksi dengan pengguna dan grup pengguna tanpa meninggalkan Amazon Quick.
Amazon Quick mendukung beberapa metode otentikasi untuk Slack. Pilih metode yang paling sesuai dengan persyaratan keamanan organisasi Anda.
-
Aplikasi OAuth default — Menggunakan aplikasi OAuth yang AWS dikelola. Tidak diperlukan kredensi tambahan. Anda mengautentikasi langsung dengan ruang kerja Slack Anda.
-
Aplikasi OAuth khusus - Menggunakan aplikasi Slack yang dikelola pelanggan. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.
-
Bearer Token — Menggunakan token bot Slack untuk otentikasi. Metode ini cocok untuk akses tingkat bot ke ruang kerja.
Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihatMetode autentikasi.
Sebelum Anda mulai
Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
-
Ruang kerja Slack dengan akses ke saluran dan data yang ingin Anda gunakan.
-
Untuk aplikasi Custom OAuth: Akses ke dasbor Slack API
di situs web Slack untuk membuat aplikasi. -
Untuk Token Pembawa: Token bot (dimulai dengan
xoxb-) dari aplikasi Slack. Untuk informasi selengkapnya, lihat Pengaturan aplikasi mulai cepatdi situs web Slack. -
Untuk persyaratan berlangganan Amazon Quick, lihatSiapkan integrasi di konsol.
Mengkonfigurasi Slack
Jika Anda menggunakan otentikasi aplikasi OAuth Default, lewati bagian ini dan buka. Menyiapkan konektor di Amazon Quick
Untuk aplikasi Custom OAuth atau otentikasi Bearer Token, selesaikan langkah-langkah yang berlaku di Slack sebelum Anda mengonfigurasi Amazon Quick.
Buat aplikasi Slack untuk aplikasi Custom OAuth atau Bearer Token
Buat aplikasi Slack untuk mendapatkan kredensyal klien atau token bot yang Anda butuhkan untuk Amazon Quick.
-
Buka dasbor Slack API
di situs web Slack dan pilih Buat Aplikasi Baru. -
Pilih Dari awal.
-
Masukkan Nama Aplikasi dan pilih ruang kerja Slack Anda. Pilih Buat Aplikasi.
-
Di bilah sisi kiri, pilih OAuth & Izin.
-
Di bawah Redirect URL, pilih Add New Redirect URL dan masukkan URL callback Amazon Quick:
https://{region}.quicksight.aws.amazon.com/sn/oauthcallbackPilih Tambah, lalu pilih Simpan URL.
-
Di bawah Cakupan, tambahkan Bot Token Scopes yang diperlukan integrasi Anda. Untuk cakupan yang direkomendasikan, lihatCakupan yang direkomendasikan.
-
Di bilah sisi kiri, pilih Informasi Dasar. Di bawah Kredensyal Aplikasi, catat nilai berikut:
-
ID Klien
-
Rahasia klien
-
-
Untuk Token Pembawa: Instal aplikasi ke ruang kerja Anda dari halaman OAuth & Izin. Setelah instalasi, salin Token OAuth Pengguna Bot (dimulai dengan
xoxb-).
Cakupan yang direkomendasikan
Cakupan berikut diminta saat Anda terhubung ke Slack. Saat Anda membuat aplikasi Slack khusus, tambahkan cakupan ini di halaman OAuth & Izin. Untuk aplikasi OAuth Kustom, tambahkan sebagai Lingkup Token Pengguna. Untuk Bearer Token, tambahkan sebagai Bot Token Scopes.
| Lingkup | Deskripsi |
|---|---|
calls:read |
Membaca informasi panggilan. |
calls:write |
Membuat dan mengelola panggilan. |
channels:history |
Membaca riwayat pesan di saluran publik. |
channels:read |
Membaca informasi tentang saluran publik. |
channels:write |
Mengelola saluran publik. |
chat:write |
Mengirim pesan ke saluran dan percakapan. |
dnd:read |
Membaca Pengaturan Jangan Ganggu. |
dnd:write |
Pembaruan Jangan Ganggu pengaturan. |
emoji:read |
Membaca emoji khusus. |
files:read |
Membaca file yang dibagikan di saluran. |
files:write |
Mengunggah dan mengelola file. |
groups:history |
Membaca riwayat pesan di saluran pribadi. |
groups:read |
Membaca informasi tentang saluran pribadi. |
groups:write |
Mengelola saluran pribadi. |
im:history |
Membaca riwayat pesan dalam pesan langsung. |
im:read |
Membaca informasi tentang pesan langsung. |
im:write |
Mulai pesan langsung. |
links:read |
Membaca pratinjau tautan. |
links:write |
Mengelola pratinjau tautan. |
mpim:history |
Membaca riwayat pesan dalam pesan langsung grup. |
mpim:read |
Membaca informasi tentang pesan langsung grup. |
mpim:write |
Memulai pesan langsung grup. |
pins:read |
Membaca pesan yang disematkan. |
pins:write |
Pin dan buka pin pesan. |
reactions:read |
Membaca reaksi emoji pada pesan. |
reactions:write |
Menambahkan dan menghapus reaksi emoji. |
reminders:read |
Membaca pengingat. |
reminders:write |
Membuat pengingat. |
remote_files:read |
Membaca file jarak jauh. |
remote_files:share |
Berbagi file jarak jauh. |
search:read |
Mencari pesan dan file. |
stars:read |
Membaca item berbintang. |
stars:write |
Bintang dan item unstars. |
team:read |
Membaca informasi ruang kerja. |
usergroups:read |
Membaca informasi grup pengguna. |
usergroups:write |
Mengelola grup pengguna. |
users:read |
Membaca informasi pengguna. |
users:read.email |
Membaca alamat email pengguna. |
users:write |
Memperbarui informasi pengguna. |
users.profile:read |
Membaca informasi profil pengguna. |
users.profile:write |
Memperbarui informasi profil pengguna. |
catatan
Tidak semua cakupan tersedia untuk Lingkup Token Pengguna dan Lingkup Token Bot. Beberapa cakupan, seperti search:read danstars:read, hanya tersedia sebagai Lingkup Token Pengguna. Saat Anda mengonfigurasi cakupan untuk otentikasi Bearer Token, verifikasi ketersediaan cakupan dalam referensi cakupan API Slack
Menyiapkan konektor di Amazon Quick
Connect dari tab Tersedia
Jika Anda ingin menggunakan otentikasi aplikasi OAuth Default, Anda dapat terhubung langsung dari tab Tersedia tanpa konfigurasi tambahan.
-
Di konsol Amazon Quick, pilih Konektor.
-
Pada tab Tersedia, temukan Slack dan pilih Connect.
-
Selesaikan alur masuk Slack dan berikan izin yang diminta.
Untuk mengonfigurasi konektor dengan aplikasi OAuth Kustom atau Token Pembawa, gunakan tab Buat untuk tim Anda seperti yang dijelaskan di bawah ini.
Buat dari tab Buat untuk tim Anda
Setelah Anda menyelesaikan konfigurasi Slack yang diperlukan, buat konektor di Amazon Quick.
-
Di konsol Amazon Quick, pilih Konektor.
-
Pilih tab Buat untuk tim Anda.
-
Temukan dan pilih Slack.
catatan
Jika konektor Slack sudah ada, dialog akan muncul dengan konektor yang ada. Untuk menggunakan konektor yang ada, pilihlah. Untuk membuat yang baru, pilih Tidak, buat yang baru.
-
Masukkan Nama untuk konektor Anda. Secara opsional, pilih + Tambahkan Deskripsi untuk menambahkan deskripsi.
-
Untuk jenis Koneksi, pilih Jaringan publik.
-
Untuk Konfigurasi OAuth, pilih salah satu metode otentikasi berikut dan konfigurasikan bidang yang diperlukan.
-
Untuk aplikasi OAuth Default:
Tidak diperlukan kredensi tambahan. Pilih Next untuk melanjutkan.
-
Untuk aplikasi Custom OAuth, konfigurasikan bidang berikut:
-
URL Dasar (Opsional) — URL dasar API Slack. Contoh:
https://slack.com/api -
ID Klien — ID klien dari aplikasi Slack Anda.
-
Rahasia klien — Rahasia klien dari aplikasi Slack Anda.
-
URL Token — Titik akhir token. Contoh:
https://slack.com/api/oauth.v2.access -
URL Otorisasi — Titik akhir otorisasi. Contoh:
https://slack.com/oauth/v2/authorize -
Redirect URL — Pre-filled dengan URL callback Amazon Quick.
-
-
Untuk Bearer Token, konfigurasikan bidang berikut:
-
URL Dasar (Opsional) — URL dasar API Slack. Contoh:
https://slack.com/api -
Token bot — Token bot Slack Anda (dimulai dengan
xoxb-).
-
-
-
Pilih Berikutnya.
-
Jika Anda memilih aplikasi OAuth Default atau aplikasi Custom OAuth, jendela otorisasi Slack akan terbuka. Tinjau izin yang diminta, pilih ruang kerja Anda, dan pilih Izinkan.
-
Pada halaman Ulasan, tinjau tindakan yang tersedia untuk konektor. Pilih Berikutnya.
-
Pada halaman Publikasikan, pilih siapa yang dapat mengakses konektor. Anda dapat mengaktifkan akses untuk semua orang di organisasi Anda atau mencari tim atau grup tertentu.
-
Pilih Terbitkan.
Tindakan yang tersedia
Setelah Anda mengatur konektor, tindakan berikut tersedia.
| Kategori | Tindakan | Deskripsi |
|---|---|---|
| Pesan | Obrolan Posting Pesan | Memposting pesan ke saluran, pesan langsung, atau grup pribadi. |
| Pesan | Kirimi Saya Pesan | Mengirim pesan tindakan orang ketiga ke saluran. |
| Pesan | Dapatkan Pesan Permalink | Mengambil URL permalink untuk pesan tertentu. |
| Saluran | Buat Percakapan | Membuat saluran publik atau pribadi. |
| Saluran | Riwayat Percakapan | Mengambil riwayat pesan dari saluran. Mengembalikan pesan timeline utama saja, bukan balasan berulir. |
| Saluran | Balasan Percakapan | Mengambil balasan berulir ke pesan induk tertentu. |
| Saluran | Undangan Percakapan | Mengundang pengguna ke saluran yang ada. |
| Saluran | Percakapan Bergabung | Bergabung dengan saluran yang ada. |
| Saluran | Tendangan Percakapan | Menghapus pengguna dari saluran. |
| Saluran | Percakapan Tinggalkan | Meninggalkan saluran. |
| Saluran | Anggota Percakapan | Daftar ID anggota untuk saluran. |
| Saluran | Percakapan Terbuka | Membuka atau melanjutkan pesan langsung atau pesan langsung multi-orang. |
| Saluran | Percakapan Set Topik | Menetapkan atau memperbarui topik untuk saluran. |
| Saluran | Dapatkan Percakapan | Mengambil metadata untuk saluran dengan ID. |
| Saluran | Daftar Saluran | Daftar saluran yang tersedia untuk pengguna. |
| Saluran | Daftar Percakapan Untuk Pengguna | Daftar saluran dan pesan langsung yang dapat diakses oleh pengguna. |
| Reaksi | Buat Reaksi | Menambahkan reaksi emoji ke pesan. |
| Reaksi | Hapus Reaksi | Menghapus reaksi emoji dari pesan. |
| Reaksi | Daftar Reaksi | Daftar reaksi pada pesan, file, atau komentar file. |
| Berkas | Unggah atau Buat File | Mengunggah file atau media ke saluran atau utas. |
| Berkas | Unggah Ke URL Eksternal | Menambahkan referensi ke file eksternal untuk berbagi di Slack. |
| Berkas | Unduh Berkas | Mengunduh file yang dibagikan di Slack. |
| Berkas | Info File | Mengambil metadata dan komentar untuk file. |
| Berkas | Daftar File | Daftar file di ruang kerja dengan filter opsional. |
| Pencarian | Cari Semua | Mencari pesan dan file di seluruh ruang kerja. |
| Pencarian | Cari Pesan | Mencari pesan dengan rentang tanggal dan filter. |
| Pencarian | Cari Saluran | Mencari saluran berdasarkan nama, topik, atau tujuan. |
| Pencarian | Cari Pengguna | Mencari pengguna melalui email, nama, atau nama tampilan. |
| Pencarian | Konteks Pencarian | Pencarian di seluruh pesan, file, saluran, dan pengguna. Mendukung pencarian semantik di ruang kerja dengan Slack AI. |
| Pencarian | Dapatkan Konfigurasi Pencarian | Memeriksa apakah pencarian semantik tersedia di ruang kerja. |
| Pengguna | Dapatkan Detail Pengguna | Mengambil informasi untuk pengguna dengan ID. |
| Pengguna | Dapatkan Profil Pengguna | Mengambil informasi profil untuk pengguna. |
| Pengguna | Set Profil Pengguna | Memperbarui bidang profil pengguna. |
| Pengguna | Daftar Pengguna | Daftar semua pengguna di ruang kerja. |
| Grup pengguna | Buat Grup Pengguna | Membuat grup pengguna baru. |
| Grup pengguna | Daftar Grup Pengguna | Daftar grup pengguna di ruang kerja. |
| Grup pengguna | Pembaruan Pengguna Grup Pengguna | Menggantikan semua anggota grup pengguna. |
| Pengingat | Pengingat Tambahkan | Membuat pengingat dengan teks dan waktu tertentu. |
| Ruang kerja | Dapatkan Tim | Mengambil metadata tentang ruang kerja Slack. |
catatan
Tindakan yang dapat Anda gunakan bergantung pada cakupan yang dikonfigurasi untuk aplikasi Slack Anda dan saluran yang dapat diakses oleh pengguna yang diautentikasi.
Mengelola dan memecahkan masalah
Untuk mengedit, membagikan, atau menghapus konektor Anda, lihatMengelola integrasi yang ada.
Masalah otentikasi
-
Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth) — Verifikasi bahwa ruang kerja Slack Anda aktif dan Anda dapat masuk ke situs web Slack secara langsung.
Untuk aplikasi Custom OAuth, konfirmasikan bahwa URL pengalihan di aplikasi Slack cocok dengan URL callback Amazon Quick. -
Kredensyal klien tidak valid (aplikasi OAuth Kustom) — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan nilai di bagian Informasi Dasar aplikasi Slack Anda.
-
Token Pembawa ditolak — Verifikasi bahwa token bot Anda aktif dan dimulai dengan
xoxb-. Token dapat dicabut dari dasbor Slack API. -
Izin tidak memadai — Pastikan cakupan yang dikonfigurasi untuk aplikasi Slack Anda menyertakan izin yang diperlukan untuk tindakan yang ingin Anda gunakan. Lihat Cakupan yang direkomendasikan.
-
Saluran tidak ditemukan atau tidak di saluran — Verifikasi bahwa bot telah ditambahkan ke saluran. Undang bot ke saluran sebelum mencoba memposting pesan atau membaca riwayat.
