Integrasi Twitter Direct Message ke Qiscus Multichannel

Secara default, Qiscus Multichannel menyediakan beberapa saluran yang dapat Anda aktifkan sebagai sumber pesan masuk dari pelanggan. Namun, Anda mungkin juga memerlukan saluran lain untuk digunakan dalam arus bisnis Anda. Mari kita ambil Twitter Direct Message (Twitter DM) sebagai contoh. Untuk mengaktifkan saluran ini, Anda dapat menggunakan fitur Custom Channel di Qiscus Multichannel. Dalam dokumentasi Qiscus, dinyatakan bahwa:

Ide di balik Custom Channel ini adalah Anda dapat menyediakan server Anda sendiri untuk terhubung dengan layanan messaging (Telegram, Slack, WeChat, Email, SMS, dll) untuk mengirim pesan. Pesan tersebut kemudian akan diteruskan ke Qiscus Multichannel CS Chat oleh server Anda untuk dikumpulkan di dashboard Qiscus Multichannel CS Chat.

Pada artikel ini, kami akan membahas topik tentang mengintegrasikan Twitter DM ke dalam Qiscus Multichannel CS Chat. Penting untuk dicatat bahwa karena ini adalah dukungan tidak resmi dari Qiscus Multichannel, Anda tetap harus memelihara layanan Anda sendiri. Semoga Qiscus Multichannel akan menyertakan Twitter DM sebagai bulit-in channel di masa mendatang!

Twitter

Pertama-pertama, untuk menggunakan Twitter DM sebagai saluran baru Anda di Qiscus Multichannel, Anda harus memiliki akun Twitter Developer karena kami akan menggunakan Access Token-nya dalam proses. Anda dapat mendaftar di sini.

Setelah Anda terdaftar sebagai developer di Twitter, Anda dapat membuat aplikasi baru. Isi formulir yang sesuai dengan proyek Anda. Dalam contoh ini, saya menamakannya “Twitter DM Channel.”

image.png

Setelah itu, buka tab “Keys and Tokens” dan buat token akses. Nanti akan kita gunakan di layanan perantara untuk menghubungkan antara Twitter dan Qiscus Multichannel.

image.png

Selanjutnya, Anda juga perlu mengubah akses izin untuk menyertakan akses ke Direct Message API. Buka tab Permissions dan centang opsi terakhir.

image.png

Terakhir tetapi tidak kalah penting, kita perlu set-updev environment. Buka halaman Dev environments dan set-upAccount Activity API dev environment.

image.png

Tentukan label yang ingin Anda gunakan dan pilih aplikasi yang baru saja kita buat.

image.png

Sekian untuk bagian Twitter. Selanjutnya, kita perlu set-up Custom Channel baru di Qiscus Multichannel.

Multichannel

Jika Anda belum sign in, silakan lakukan sekarang di https://multichannel.qiscus.com lalu buka halaman Integration:

image.png

Buat Custom Channel baru dengan mengeklik tombol “Add Channel”.

image.png

Harap tentukan nama channel dan identifier key Anda. Nama channel bisa diisi dengan “Twitter DM”. Nama ini nanti akan muncul di tab channel. Sedangkan untuk Identifier Key bisa menggunakan apa saja yang diinginkan. Key ini digunakan untuk mencocokkan sumber request yang datang dari webhook anda. Ini adalah parameter yang diminta. Terakhir URL Webhook, ini akan menjadi URL Webhook Custom Channel Anda, yang merupakan layanan perantara yang akan Anda buat.

Infrastruktur Layanan Perantara

Kami telah menyiapkan Aplikasi Twitter dan Custom Channel di langkah sebelumnya. Jadi, selanjutnya adalah menyiapkan layanan perantara kami. Layanan ini bertindak sebagai bridging service yang akan memenuhi aturan berikut:

  1. Terima webhook dari DM Twitter.
  2. Ketika layanan Anda menerima pesan, kirim pesan tersebut ke Qiscus Multichannel CS Chat dengan format berikut.

Header:

image.png

URL:

image.png

Params:

image.png

Anda dapat memeriksa detailnya di https://documentation.qiscus.com/multichannel-customer-service/customization#custom-channel

Dalam contoh ini, kami menggunakan AWS Lambda, API Gateway, dan Python 3.7. Anda dapat mengakses repo di https://bitbucket.org/qiscus/twitter-custom-channel

Untuk menerapkan kode ke AWS Lambda:

  • Kode menggunakan chalice sebagai python micro-framework tanpa server.
image.png
image.png
  • Request API untuk mendaftarkan webhook. Twitter mengirimkan pesan atau event ke layanan Anda di URL ini. Harap dicatat, endpoint-nya harus “/webhooks/twitter”

Selesai.

You May Also Like
WhatsApp API Chat
Selengkapnya

WhatsApp Business API 101

WhatsApp Business API memiliki cara kerja khusus yang membedakannya dari WhatsApp Personal. Tak ayal, butuh beberapa adaptasi yang…