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 membuat kueri data langsung dari Slack, yang memungkinkan Anda berbagi data dengan mudah dan menjawab pertanyaan berbasis data tanpa harus bekerja di luar alur kerja yang ada di organisasi Anda.

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. Download update 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 meluaskan URL secara otomatis untuk konten Looker yang Anda bagikan di Slack. Agar Lookerbot dapat otomatis memperluas URL yang dibagikan 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 meluaskan URL Looker tidak tersedia di pesan langsung Slack, karena adanya perbedaan antara channel pribadi/publik dan pesan langsung dalam kemampuan API peluasan lama yang digunakan di Lookerbot.

Untuk mengundang Lookerbot ke channel publik atau pribadi di Slack:

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

Saat Anda menempelkan URL dari Jelajahi atau Tampilan di channel Slack tempat Lookerbot diundang, Lookerbot akan otomatis meluaskan 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 dari data Anda di Looker dan memposting hasilnya di Slack. Perintah garis miring kustom dibuat selama penyiapan Lookerbot, tetapi dapat dijalankan di Slack oleh pengguna Slack mana pun.

Perintah garis miring tidak diperlukan untuk berinteraksi dengan Lookerbot. Untuk menggunakan semua fungsi Lookerbot, Anda juga dapat mengirim pesan langsung ke bot atau menyebutkannya di saluran Slack tempat Lookerbot berada: @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 setiap sebutan Lookerbot. Perintah yang tersedia tercantum di jendela pop-up.
  • Pilih aplikasi Lookerbot di bagian Aplikasi di ruang kerja Slack. Kemudian, pilih tab Tentang di halaman aplikasi. Perintah yang tersedia akan tercantum di bagian Perintah.

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 yang dibuat pelanggan untuk produk tertentu. Developer telah menggunakan "urutan" untuk merepresentasikan data ini saat mengonfigurasi perintah garis miring. Untuk memanggil perintah ini, Anda dapat:

  1. @mention Lookerbot diikuti dengan komponen teks perintah. Tindakan ini dapat dilakukan di saluran mana pun yang memiliki Lookerbot. Contoh:

    @lookerbot orders

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

    /lookerbot orders

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

Menggunakan perintah garis miring dengan filter

Jika Anda atau developer di organisasi Anda telah membuat perintah garis miring yang membuat kueri dasbor dengan satu elemen dan filter dasbor, Anda dapat menjalankan perintah 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 tertentu di Amerika Serikat 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 ini:

Respons Slackbot dari visualisasi data yang menampilkan peta New York dengan titik-titik dalam berbagai ukuran 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 pengembalian:

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

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

    Respons Slackbot terhadap perintah pesanan minggu lalu yang menampilkan link ke kueri Looker dan total jumlah pesanan sebanyak 228.
  • Visualisasi: Jika konten pokoknya adalah visualisasi, data akan ditampilkan sebagai gambar visualisasi. Misalnya, jika pengguna menjalankan perintah movie budgets yang dikonfigurasi 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 anggaran film Brad Pitt rata-rata dari 0 hingga 160 juta untuk tahun rilis pertama film, mulai dari tahun 1990 hingga 2015:

Referensi lainnya

Untuk informasi tentang integrasi Slack Looker lainnya, lihat referensi berikut: