Menggunakan Lookerbot untuk Slack

Halaman ini memberikan ringkasan tentang cara menggunakan Lookerbot, salah satu dari beberapa integrasi yang disediakan Looker untuk membagikan data Looker di Slack.

Lookerbot untuk Slack terintegrasi dengan Looker sehingga Anda dapat mengkueri data langsung dari Slack, sehingga Anda dapat berbagi data dengan mudah dan menjawab pertanyaan berbasis data tanpa harus bekerja di luar alur kerja organisasi yang ada.

Halaman ini membahas alur kerja Slack-Lookerbot berikut:

Mulai menggunakan Lookerbot

Sebelum dapat menggunakan Lookerbot di Slack, Anda harus mengonfigurasi aplikasi Lookerbot dengan mengikuti petunjuk penyiapan teknis di repositori GitHub open source Looker.

Pada Februari 2021, Slack menghentikan penggunaan beberapa endpoint API yang memengaruhi cara Lookerbot berinteraksi dengan tindakan data. Lihat info terbaru dari repo GitHub Lookerbot Looker. File package.json Anda harus menunjukkan versi Looker 0.0.16 atau yang lebih baru.

Memperluas URL Looker secara otomatis

Lookerbot dapat memperluas URL secara otomatis untuk konten Looker yang Anda bagikan di Slack. Agar Lookerbot dapat otomatis memperluas URL bersama dalam saluran Slack, Anda harus menambahkan Lookerbot ke saluran Slack tersebut. (Konfigurasi bot juga harus menetapkan variabel lingkungan LOOKER_SLACKBOT_EXPAND_URLS ke true. Lihat petunjuk penyiapan teknis Lookerbot untuk mengetahui informasi selengkapnya tentang variabel lingkungan.)

Kemampuan untuk memperluas URL Looker tidak tersedia di pesan langsung Slack, karena adanya perbedaan yang dibuat antara saluran pribadi/publik dan pesan langsung dalam kemampuan API pengembangan lama yang digunakan di Lookerbot.

Untuk mengundang Lookerbot ke saluran publik atau pribadi di Slack:

  1. Klik nama channel untuk membuka setelan channel.
  2. Pilih tab Integrations.
  3. Di bagian Aplikasi, pilih nama aplikasi Lookerbot Anda.

Saat Anda menempelkan URL dari Explore atau Look di saluran Slack yang mengundang Lookerbot, Lookerbot akan otomatis memperluas URL dan kontennya. Jika konten Looker memiliki visualisasi terkait, Lookerbot akan menampilkan gambar visualisasi tersebut. Jika konten Looker adalah tabel data, Lookerbot akan menampilkan data sebagai teks.

Menggunakan perintah garis miring kustom untuk menjalankan dan memposting kueri Looker

Anda juga dapat membuat dan menggunakan perintah garis miring kustom yang, saat dijalankan, akan menjalankan kueri tersimpan atas data Anda di Looker dan memposting hasilnya di Slack. Perintah garis miring kustom dibuat selama penyiapan Lookerbot, tetapi dapat dijalankan di Slack oleh semua pengguna Slack.

Perintah garis miring tidak diperlukan untuk berinteraksi dengan Lookerbot. Untuk menggunakan semua fungsi Lookerbot, Anda juga dapat mengirim pesan ke bot secara langsung atau menyebutkannya di saluran Slack tempat Lookerbot ada: @lookerbot help.

Jika integrasi Slack diaktifkan untuk ruang kerja Slack, Anda tidak dapat menggunakan perintah garis miring /looker dengan Lookerbot. Sebagai ganti @looker atau /looker, gunakan @lookerbot atau /lookerbot.

Untuk melihat perintah yang telah dibuat untuk Lookerbot Anda:

  • Arahkan kursor ke sebutan Lookerbot. Perintah yang tersedia tercantum di jendela pop-up.
  • Pilih aplikasi Lookerbot di bagian Aplikasi pada ruang kerja Slack. Lalu pilih tab Tentang di halaman aplikasi. Perintah yang tersedia akan tercantum di bagian Commands.

Berbagai cara untuk menggunakan perintah garis miring

Ada tiga cara untuk menggunakan perintah. Misalnya, Anda atau developer di organisasi telah menyiapkan perintah untuk mengambil data dari Looker yang melacak jumlah pesanan produk tertentu yang telah dilakukan pelanggan. Developer telah menggunakan "pesanan" untuk mewakili data ini saat mengonfigurasi perintah garis miring. Untuk memanggil perintah ini, Anda dapat:

  1. @sebutan Lookerbot diikuti dengan komponen teks dari perintah tersebut. Hal ini dapat dilakukan di saluran mana pun tempat Lookerbot ada. Contoh:

    @lookerbot orders

  2. Gunakan perintah garis miring. Anda dapat menggunakan perintah dengan mengklik perintah dari daftar perintah atau dengan mengetikkan nama perintah (diawali dengan garis miring). Anda dapat melakukannya jika perintah garis miring telah dikonfigurasi selama penyiapan.

    /lookerbot orders

  3. Pesan langsung Lookerbot. Jika mengirim pesan langsung ke Lookerbot, Anda tidak perlu menambahkan perintah di awal dengan /lookerbot. Dalam hal ini, DM hanya akan menjadi orders.

Menggunakan perintah garis miring dengan filter

Jika Anda atau developer di organisasi Anda telah membuat perintah garis miring yang mengkueri dasbor dengan satu elemen dan filter dasbor, Anda dapat menjalankan perintah tersebut untuk mengambil konten Looker tersebut dan menambahkan nilai filter dari Slack. Filter bersifat opsional, dan kueri akan berjalan tanpa filter tersebut jika tidak ada nilai yang ditentukan.

Misalnya, Anda memiliki dasbor dengan visualisasi peta pelanggan yang memfilter kota-kota tertentu di AS dan perintah garis miring kustom telah dikonfigurasi untuk memanggil data dasbor ini. Anda dapat menjalankan perintah customer map in yang difilter untuk New York, seperti berikut:

Respons Slackbot dari visualisasi data yang menampilkan peta New York dengan titik-titik ukuran berbeda yang mewakili jumlah pengguna di area tertentu.

Format data

Perintah akan menampilkan data dengan cara yang berbeda, bergantung pada jenis visualisasi elemen Jelajahi, Tampilan, atau dasbor yang mendasarinya. Ada tiga kemungkinan format hasil:

  • Teks: Jika konten pokok adalah tabel, data akan ditampilkan sebagai teks. Misalnya, jika pengguna menjalankan perintah yang dikonfigurasi top customer this month, Slackbot akan menampilkan data teratas dalam format teks:

    Respons Slackbot ke pelanggan teratas bulan ini menampilkan link ke kueri dan nilai Looker untuk Nama Pengguna, Usia Pengguna, Status Pengguna, dan Jumlah Pesanan.
  • Visualisasi Nilai Tunggal: Jika konten yang mendasarinya adalah visualisasi nilai tunggal, data akan ditampilkan sebagai nilai teks. Misalnya, jika pengguna menjalankan perintah yang dikonfigurasi orders last week, Slackbot akan menampilkan jumlah total untuk minggu sebelumnya:

    Respons Slackbot terhadap perintah minggu lalu menampilkan link ke kueri Looker dan total jumlah pesanan sebagai 228.
  • Visualisasi: Jika konten yang mendasarinya adalah visualisasi, data akan ditampilkan sebagai gambar visualisasi. Misalnya, jika pengguna menjalankan perintah yang dikonfigurasi movie budgets dengan nilai Brad Pitt, Slackbot akan merespons dengan link ke kueri Looker dan visualisasi diagram garis yang menggambarkan tren nilai yang meningkat dan menurun dari rata-rata anggaran film Brad Pitt dari 0 hingga 160 juta untuk tahun rilis pertama sebuah film, mulai dari tahun 1990 hingga 2015:

Referensi lain

Untuk mendapatkan informasi tentang integrasi Slack dari Looker, lihat referensi berikut: