Integration
  • 03 Sep 2023
  • 16 Minutes to read
  • Contributors
  • Dark
    Light

Integration

  • Dark
    Light

Article Summary

Integration adalah halaman untuk mengintegrasi atau menghubungkan omni messaging dengan kesemua messaging channel (Aplikasi Chatting) dan Bot Studio. Integration dapat dilakukan melalui beberapa channel, yaitu sebagai berikut:

1. INTEGRATE WITH WHATSAPP

Integrasi ke whatsapp adalah membantu developer untuk menghubungkan agent dengan pengguna secara tepat waktu dan singkat.

Untuk menambahkan integration WhatsApp baru, dapat dilakukan dengan cara sebagai berikut:

  • Pada halaman integration, pilih channel Whatsapp Messenger.
  • Akan muncul pilihan channel yang dapat di integrasi
  • Kemudian klik Add Account jika ingin membuat baru.

Halaman Integrasi akun WhatsApp baru akan menampilkan kolom-kolom yang harus dilengkapi, seperti:

  1. Pilih WhatsApp API Service yang digunakan.
  2. Mengisi WhatsApp Name
  3. Mengisi WhatsApp Number
  4. Mengisi WhatsApp Base URL
  5. Mengisi Nama HSM
  6. Mengisi Username dan Password untuk mengakses ke platform API Service yang sesuai dengan Base Url
  7. Klik Add.

Ketika anda ingin menambahkan webhook url dengan Whatsapp Messenger yang sudah ada atau yang telah dibuat sebelumnya, klik CONFIGURATION pada Whatsapp yang baru ditambahkan.

Halaman Integrasi WhatsApp yang telah di konfigurasi akan menampilkan kolom-kolom yang harus dilengkapi, seperti:

  1. Pilih WhatsApp API Service yang digunakan.
  2. Salin script code pada kolom Webhook URL
  3. Masuk ke platform API Service dengan menggunakan akun yang sudah terdaftar.
  4. Kemudian sisipkan Webhook URL pada Platform API Service WhatsApp
  5. Klik Set Webhook
  6. Submit

2. INTEGRATE WITH LINE

Integrasi ke Line Messenger adalah membantu developer untuk menghubungkan agent dengan pengguna secara tepat waktu dan singkat.

berikut ini adalah tahapan-tahapan yang dapat dilakukan untuk dapat terhubung dengan Line API. 

I. Registrasi Akun Line Developer

  • Langkah pertama sebelum membuat akun Line Developer adalah anda harus memiliki akun Line. Jika belum ada, silahkan melakukan registrasi akun Line terlebih dahulu. Jika anda sudah melakukan proses Login akun Line, buka tab baru dan ketikkan https://developers.line.biz/en/ kemudian akan muncul halaman seperti gambar dibawah ini. 

  • Kemudian klik “Log in”, lalu klik "Log in with Line account". Akan muncul halaman yang akan membantu agar penggunaan API sesuai dengan tujuan utama anda.

Anda akan diminta untuk mengisi di kolom alamat email dan password yang sudah didaftarkan pada akun LINE, jika data anda sudah lengkap dan sesuai, klik Log in

II. Setup Line Messenger API

  • Setelah anda melakukan Login, maka akan menampilkan halaman provider. Anda dapat menggunakan provider yang sudah ada ataupun membuat provider baru.

  • Saat anda masuk ke dalam salah satu provider, akan muncul beberapa submenu dan anda dapat mengklik salah satu submenu yaitu Create Messaging API Channel.

  • Menampilkan isi informasi untuk membuat API LINE dan yang harus diisi pada halaman membuat Channel. 

  • Dan jangan lupa memberi centang dengan mengklik LINE Official Terms of Use dan LINE Official Account API Terms of Use, jika anda sudah mengklik maka bahwa anda sudah membaca dan menyetujui persyaratan yang ada. Kemudian klik Create.

  • Setelah klik create, akan muncul notifikasi Create a Messaging API Channel with the following details (Membuat Messaging API Channel dengan detail berikut). Jika sudah memahami ketentuan dan persyaratan klik OK.

  • Setelah klik OK, akan muncul notifikasi persetujuan mengenai penggunaan informasi. Jika sudah memahami ketentuan dan persyaratan klik Setuju.

  • Jika sudah mengklik SETUJU, maka akan muncul Messaging API Line yang sudah berhasil anda buat.
  • Klik API tersebut, kemudian sesuaikan pengaturan yang dibutuhkan. Karena Omni Messaging membutuhkan Access Token Line, maka kita dapat melihat Access Token Line tersebut di navbar menu Messaging API.

Saat pertama kali membuat Messaging API Line, Access token masih kosong. Anda dapat mengklik Issue, maka akan muncul link access token dan salin link tersebut kemudian sisipkan pada kolom  teks access token Integrasi Line Messenger.

Jika sudah mengklik Issue, maka akan muncul link access token Messaging API Line.

  • Pada tab basic settings, salin Channel secret. Hal tersebut merupakan secret key yang nantinya akan digunakan untuk permintaan autentifikasi ke Line messagind API.

III. Integrasi Platform Lenna dengan Line Messenger 

Langkah-langkah untuk melakukan proses integrasi API adalah sebagai berikut, masuk ke halaman Setting kemudian pilih submenu Integration:

  • Masuk ke Platform Lenna, pilih Lenna Production pada Platform Lenna yang akan diintegrasikan dengan Line API. Pilih menu Integration kemudian pilih channel Line Messenger.
  • Pastikan anda sudah menyalin atau menyimpan kode akses dari akun Line Developer anda. Salin kode Channel secret dan Channel access token.
  • Kemudian sisipkan kode pada kolom Access Token, Channel secret yang berada pada menu Integration Line di Platform Lenna.
  • Setelah integrasi baru dibuat, klik edit dan copy webhook URL (contoh: https://staging.lenna.ai/app/public/api/webhook/line/{random_string}). URL tersebut akan digunakan untuk mengirim events dari Line Messaging API ke Platform Lenna

IV. Set up Line Console/Line Developer

  1. Pada akun Line Developer, pilih menu Messaging API.
  2. Sisipkan webhook URL ke webhook setting di Line Console. Hal itu akan memberitahukan Line messaging API untuk mengirim events ke Platform Lenna.
  3. Klik verify untuk memastikan bahwa webhook berfungsi dengan benar.
  4. Aktifkan (enabled) webhook. Hal tersebut akan mengaktifkan Line messaging API untuk mengirim events ke Platform Lenna.

V. Set up Line Manager

  1. Akses Line Manager dengan mengklik link Line Official Account Manager pada tab basic settings.
  2. Konfigusikan response seetings sesuai kebutuhan. Seperti:
  • Enable Chat
  • Disable the greeting message
  • Enable webhooks
  • Disable response hours
  • Choose manual chat only as response method

3. INTEGRATE WITH TELEGRAM

Integrasi ke Telegram adalah membantu developer untuk menghubungkan agent dengan pengguna secara tepat waktu dan singkat.

Berikut ini adalah tahapan-tahapan yang dapat dilakukan untuk dapat terhubung dengan Telegram API.

I. Registrasi Akun Telegram Messenger

  • Langkah pertama sebelum mendapatkan bot token adalah anda harus mendaftar atau memiliki akun Telegram Messenger. Anda dapat membuka tab baru dan ketikkan https://web.telegram.org/ kemudian akan muncul halaman seperti gambar dibawah ini.

  • Kemudian anda akan diarahkan pada halaman berisi QR Code yang memudahkan untuk proses login atau dengan memasukan nomer telepon dengan mengklik Log In By Phone Number.
  • Jika sudah berhasil login, maka halaman akan menuju ke halaman web Telegram yang tersinkronisasi dengan mobile Telegram.

II. Set up Telegram API

  • Setelah anda berhasil masuk ke halaman telegram, anda dapat isi kolom Search dengan ketik “BotFather” dengan centang biru untuk mendapatkan Keys. Kemudian anda dapat klik chat BotFather yang paling pertama untuk masuk ke dalam room chat.
  • Pada roomchat BotFather, tekan tombol Start.
  • Anda dapat memilih /newbot atau anda juga bisa mengetik secara manual.
  • Selanjutnya anda dapat memasukkan nama bot Telegram yang anda inginkan. Contoh: TestTele
  • Ketika sudah berhasil membuat nama untuk bot, selanjutnya membuat username untuk bot tersebut. Username yang anda buat harus diakhiri dengan kata bot. Jika ada balasan “Sorry, this username is already taken”  maka anda harus memasukkan username lain di karena username yang ada buat sebelumnya sudah digunakan.
  • Jika berhasil akan ada balasan “ Done! Congratulations on new your bot ” maka username yang telah didaftarkan telah berhasil dan anda dapat menyimpan TOKEN dengan baik-baik untuk mendapatkan hak akses HTTP API.


III. Integrasi Platform Lenna dengan Telegram API

Langkah-langkah untuk melakukan proses integrasi Platform Lenna dengan Telegram API adalah sebagai berikut:

  •  Masuk ke Platform Lenna, pilih Lenna Production pada Platform Lenna yang akan diintegrasikan dengan Bot. Pilih menu Integration.
  • Pilih channel Telegram
  • Klik Add
  • Pastikan anda sudah menyalin atau menyimpan kode akses dari chat @BotFather anda. Salin kode API key.
  • Sisipkan URL yang sudah anda disalin dari chat @BotFather telegram pada kolom teks “Bot Token” Integration, kemudian anda dapat mengklik Check untuk menampilkan data berupa nama bot dan username yang telah dibuat di halaman chat @BotFather. Jika sudah sesuai dengan token anda punya, maka akan ditampilkan Bot Name dan Bot Username yang sebelumnya sudah dibuat.
  • Klik Submit 
  • Saat Telegram sudah berhasil terintegrasi dengan Omni messaging, saatnya untuk mencoba berinteraksi dengan bot anda di Telegram. Cari akun bot yang sudah anda buat di kolom pencarian, ketik sesuai dengan Username/nama pengguna nya. Kemudian anda dapat mengklik Start untuk memulai percakapan.
  • Tampilan yang telah berhasil mengintegrasi antara omni messaging dengan telegram API.  


4. INTEGRATE WITH FACEBOOK

Berikut ini adalah langkah – langkah yang dapat dilakukan untuk dapat terhubung dengan Facebook Messenger.

  • Pilih Integration Facebook, kemudian klik tombol Add.

  • Klik Login With Facebook
  • Kemudian, akan muncul popup yang mengarahkan ke halaman Facebook. Masukkan Email dan Password akun Facebook anda.
  • Klik tombol lanjutkan akun untuk menuju ke proses berikutnya.
  • Kemudian pada halaman integration, pilih facebook/facebook page yang ingin anda sambungkan dengan chatbot. Lalu klik integrate.
  • Setelah berhasil terhubung, akan muncul popup informasi yang menandakan Facebook Messenger sudah terhubung dengan omni messaging.

5. INTEGRATE WITH INSTAGRAM

Berikut ini adalah langkah – langkah yang dapat dilakukan untuk dapat terhubung dengan Instagram.

  • Pilih Integration Instagram, kemudian klik tombol Add.

  • Klik Login With Facebook
  • Kemudian, akan muncul popup yang mengarahkan ke halaman Facebook. Login ke akun Facebook anda dengan memasukkan Email dan Password akun Facebook anda.
  • Pilih akun Instagram yang ingin diintegrasikan.
  • Pilih Facebook page yang ingin diintergrasikan.
  • Izinkan semua pengaturan pada Facebook page.
  • Kemudian pada halaman integration, pilih facebook/facebook page yang udah terhubung dengan akun bisnis Instagram anda dan sambungkan dengan chatbot. Lalu klik integrate.

 

  • Setelah berhasil terhubung, akan muncul popup informasi yang menandakan Instagram sudah terhubung dengan omnichannel dan anda dapat berinteraksi dengan customer yang menghubungi anda ke Instagran Direct Message.

I. Aktivasi Direct Messages Instagram Ke Omnichannel

Aktivasi Direct Messages Instagram berfungsi agar Direct Messages dapat masuk ke Omnichannel. Untuk aktivasi dilakukan di Instagram mobile apps, berikut langkah-langkah aktivasi:

  1. Pilih menu setting pada Instagram mobile apps
  2. Pilih Privacy
  3. Pada menu Privacy, pilih Messages
  4. Pada Messages controls, aktifkan izinkan akses pesan (Allow access to messages)

6. INTEGRATE WITH TWITTER

Integrasi ke Twitter adalah membantu developer untuk menghubungkan agent dengan pengguna secara tepat waktu dan singkat.

Berikut ini adalah tahapan-tahapan yang dapat dilakukan untuk dapat terhubung dengan Twitter API.

I. Registrasi Akun Twitter Developer

  • Langkah pertama sebelum membuat akun Twitter Developer adalah anda harus memiliki akun Twitter. Jika belum ada, silahkan melakukan registrasi akun Twitter terlebih dahulu.
  • Jika anda sudah melakukan proses Login akun Twitter, buka tab baru dan ketikkan https://developer.twitter.com kemudian akan muncul halaman seperti gambar dibawah ini.

  • Selanjutnya klik “Product” kemudian anda dapat memilih “Twitter API”. Akan muncul halaman Twitter API. 
  • Kemudian scroll kebawah hingga menemukan button Get Started untuk memulai membuat API.
  • Anda akan diminta untuk memilih dropdown country dan use case, pilih negara dan pilih use case “Exploring the API” , klik checkbox dan kemudian klik “Let’s do this . Twitter Developer akan melakukan konfirmasi apakah akun anda sudah sesuai. Anda dapat mengecek pada halaman ini.
  • Accept agreement, lalu klik submit
  • Verifikasi email
  • Jika verifikasi berhasil maka halaman developer twitter akan menampilkan tampilan seperti dibawah:
  • Klik Get Started
  • Anda akan diminta untuk melengkapi data Negara yang anda tinggali, skill level dalam mengkoding dan Nama yang ingin anda tampilkan pada akun Twitter Developer. Anda juga dapat mengisi ataupun mengosongkan kolom checkbox untuk mendapatkan informas terbaru mengenai Twitter API.
  • Twitter Developer akan mengajukan pertanyaan mengenai bagaimana anda akan menggunakan Twitter API ataupun Twitter data. Anda harus menjelaskan rencana penggunaan Twitter API dalam Bahasa Inggris dan minimal berisi 200 karakter.
  • Scroll layar hingga akhir, isikan formulir tersebut untuk memenuhi kebijakan Twitter Developer. Anda dapat mengisi kolom yang sesuai dengan kebutuhan anda dalam penggunaan API Twitter. Jika sudah, klik Next. Akan muncul halaman Review.
  • Jika data yang anda masukkan sudah sesuai, klik tombol Next Untuk melanjutkan ke proses berikutnya.
  • Selanjutnya akan menampilkan halaman informasi persyaratan dan persetujuan untuk membuat API Twitter. Anda dapat scroll sampai menemukan persetujuan dari pengguna.
  • Kemudian akan muncul halaman Syarat dan Ketentuan, anda dapat melakukan tinjauan terlebih dahulu kemudian klik kolom checkbox untuk menyetujui Syarat dan Ketentuan yang berlaku. Klik Submit Application.

II. Set Up Twitter API

Setelah anda melakukan konfirmasi akun email, akan muncul halaman awal dari Portal Twitter Developer. silahkan anda dapat mengklik “Create Project” untuk mendapatkan Keys.

  • Langkah pertama masukan nama project yang anda ingin buat. jika sudah mengisi nama project sesuai keinginan anda maka anda dapat mengklik “Next” untuk langkah ke kedua atau selanjutnya. 

  • Langkah kedua yaitu anda akan diminta untuk memilih kasus yang ingin digunakan. Contoh sebagai “Student”.  Jika anda sudah memilih kasus yang diinginkan maka anda dapat mengklik “Next” untuk langkah ketiga atau selanjutnya. 

  • Langkah ketiga yaitu anda akan diminta untuk mengisikan kolom deskripsi untuk menjelaskan project yang anda ingin bangun. Jika anda sudah memilih kasus yang diinginkan maka anda dapat mengklik “Next” untuk langkah keempat atau selanjutnya.

  • Langkah terakhir atau langkah keempat yaitu anda akan diminta untuk menulis nama aplikasi anda yang ingin dibangun. Jika anda sudah memilih mengisi nama aplikasi yang ingin dibuat, anda dapat mengklik “Complete” untuk mengetahui API Key.  

  • Akan muncul kolom API key, API secret key dan Bearer token. Anda dapat melakukan tes endpoint ataupun Skip proses untuk menuju ke Dashboard. Namun sebelum Skip, pastikan anda sudah menyalin dan menyimpan kode dari kolom API key, API secret key dan Bearer token.

  • Jika anda ingin melihat kembali API Key yang telah dibuat. Anda dapat masuk ke menu Projects & Apps, kemudian pilih apps yang sudah anda buat. Pilih tab Keys and Tokens.

  • Akan menampilkan halaman Key and Tokens untuk melihat kode API key & secret dan Bearer token sudah didapatkan saat awal pembuatan apps, langkah selanjutnya adalah mendapatkan kode Access Token & secret. Klik Regenerate untuk mendapatkan kode.

  • Kemudian muncul popup untuk persetujuan melihat Key dan Tokens. Jika anda setuju maka anda dapat mengklik “Yes,  Regenerate”. 

  • Akan muncul popup kode Access Token & Secret. Pastikan anda sudah menyalin dan menyimpan kode Access token dan Access token secret. Jika sudah selesai, klik tombol Yes, I saved them.

  • Jika ingin mengubah perizinan informasi, maka anda dapat ke halaman Projects & Apps, masuk ke tab Setting. Kemudian ke pengaturan App Permissions. Klik Edit.

  • Akan muncul halaman Edit App Permission, pilih pengaturan Read + Write + Direct Messages. Kemudian klik tombol Save.

  • Langkah berikutnya adalah masuk ke menu Products. Kemudian pilih Account Activity API/Sandbox.

  • Klik tombol Set up dev environment, kemudian akan muncul Popup Set up Account.

  • Isikan kolom Dev environment label dan pilih App anda. Kemudian klik tombol Complete setup.

III. Integrasi Platform Lenna dengan Twitter API

Langkah-langkah untuk melakukan proses integrasi API:

  • Masuk ke Platform Lenna, pilih Lenna Production pada Platform Lenna yang akan diintegrasikan dengan App API. Pilih menu Integration kemudian pilih channel Twitter.
  • Pastikan anda sudah menyalin atau menyimpan kode akses dari akun Twitter Developer anda. Salin kode API key, API secret key dan Bearer token.

  • Klik Add Account. Lalu akan muncul tampilan pop up seperti dibawah:
  • Kemudian sisipkan kode pada kolom API key, API Key Secret dan Bearer Token yang berada pada menu Integration Twitter di Platform Lenna.
  • Pastikan kembali anda sudah menyalin dan menyimpan kode untuk Access Token dan Access Token Secret.
  • Sisipkan kode pada kolom Access Token dan Access Token Secret yang berada pada menu Integration Twitter di Platform Lenna.
  • Kembali ke portal Twitter Developer, salin Dev environment label.
  • Sisipkan atau ketikkan Dev environment label anda pada kolom Environment Name di Platform Lenna. Klik submit
  • Akan muncul popup notifikasi pada layar atas yang menandakan proses integrasi Twitter berhasil. Kemudian setelah berhasil terhubung, klik tombol configuration, lalu klik Set Webhook
  • Klik submit, maka akan muncul kembali popup notifikasi bahwa Webhook berhasil di terhubung.

7. INTEGRATE WITH WEBCHAT

Berikut untuk melakukan proses integrasi API adalah sebagai berikut:

  • Masuk ke platform Lenna yang akan diintegrasikan dengan Webchat  API. Pilih menu integration kemudian pilih channel Embeddable Web Chat.
  • Klik Add New Webchat

  • Masukkan nama Webchat yang ingin dibuat. Klik create

  • Aktifkan webchat yang sudah dibuat dengan mengklik Activate

  • Klik icon edit yang berada pada bagian kanan atas

  • Lalu halaman akan menampilkan script webchat yang sudah dibuat
  • Jika ingin menampilkan webchat pada website yang pengguna miliki, pengguna dapat menyalin script webchat pada platform lenna ke index dari website pengguna.
  • Jika ingin melakukan testing, kita dapat mencoba klik Preview. Namun pastikan anda sudah mengklik “Update” untuk menghubungkan ke Web chat.
  • Lalu, akan diteruskan ke halaman testing webchat, seperti dibawah:

  • Pengguna juga dapat mengatur tampilan webchat pada tab Custom UI Configuration, seperti background, avatar, logo, dan text.

 

8. INTEGRATE WITH EMAIL

Integrasi ke email adalah membantu developer untuk menghubungkan agent dengan pengguna secara tepat waktu dan singkat. Untuk integrasi email pengguna harus memiliki akun email business agar dapat terhubung denga platform Lenna.ai.

Untuk mengintegrasikan email dengan platform dapat dilakukan dengan langkah-langkah berikut:

  • Masuk ke platform Lenna yang akan diintegrasikan dengan email. 
  • Pilih menu integration kemudian pilih channel Email.
  • Klik Add

  • Menampilkan pop up add email integrations

  • Pada pop up terdapat email yang sedang digunakan pada platform. Pengguna dapat mengisikan email yang akan diintegrasikan pada kolom Email Address. 
  • Untuk mengetahui IMAP dan SMTP dari email yang ingin diintegrasikan, dapat dilakukan dengan cara berikut:
  • Buka menu settings pada email, lalu pilih tab Forwarding and POP/IMAP. Lalu klik Configuration Instructions pada kolom Pop Download. Kemudian halaman akan diteruskan ke halaman Gmail Help. Pada halaman Gmail Help terdapat informasi POP/IMAP dan SMTP email pengguna. 

Gambar POP/IMAP dan SMTP

Untuk memudahkan dapat mengunjungi link https://support.google.com/mail/answer/7104828?hl=en-gb&authuser=1

  • Untuk akses email dengan platform, POP/IMAP pada tab Forwarding and POP/IMAP harus di enable kan terlebih dahulu.
  • Lalu pada akun Google pengguna aktifkan fitur 2-Step Verification untuk memudahkan dalam akses IMAP dan STMPPada Google Account, klik Manage Your Google Account -> Security -> Signing In To Google -> aktifkan 2-Step Verification, lalu ikuti petunjuk selanjutnya untuk melakukan 2-Step Verification.
  • Jika POP/IMAP dan SMTP sudah didapatkan, salin dan sisipkan pada pop up add email integration pada platform Lenna.
  • Jika data sudah sesuai, klik Submit untuk menyimpan email. Contoh integrasi email yang sudah berhasil tersimpan:

 

Untuk menghubungkan email dengan platform, pengguna dapat mengaktifkan button ON/OFF 

Pengguna juga dapat menghapus email yang terintegrasi dengan mengklik titik tiga pada email yang ingin dihapus, klik Delete.

9. INTEGRATE WITH WEBPAGE

Web page adalah media live chat yang di embed pada mobile app yang akan menghubungkan customer dengan bot dan live agent. Web page dapat di hubungkan dengan/ tanpa bot. Dengan Web page user tidak diharuskan mengisi data-data seperti Nama, Email, dsb. Customer dapat menggunakan webpage dengan link Webpage App Lenna dengan menempelkan link tersebut ke mobile app yang dimiliki customer dengan menyesuaikan app id pada link dan project yang akan digunakan.

App id dan integration id bisa didapatkan dengan cara:

  1. Masuk ke omnichannel lenna dan masuk ke project yang dimiliki
  2. Pilih menu Integration, lalu pilih integration Webchat 
  3. Pilih edit Webchat
  4. Pada technical configuration, salin app id dan integration id pada script. Contoh: 
  5. Setelah app id dan integration id berhasil didapatkan, tempelkan pada contoh link berikut: https://v3.lenna.ai/webpage/?id=lejRej&integrationId=rb2XMe

Main Param : 

  • id => Insert your application id
  • integrationid => Insert your integration id

Additional Information (optional: for auto login) : 

  • clientid => insert memberid, user id or any unique id
  • deviceid => insert device id, or generated unique id
  • name => insert customer name
  • email=> insert customer email


10. INTEGRATE WITH TOKOPEDIA

Berikut langkah-langkah untuk integrasi Tokopedia

I. Registrasi Akun Tokopedia Developer Console

  1. Masuk ke akun seller Tokopedia.
  2. Maka, pengguna akan diarahkan untuk membuat Developer Console Tokopedia. Pengguna dapat mengikuti langkah selanjutnya pada proses pembuatan akun Developer Console Tokopedia.
  3. Atau pengguna dapat langsung masuk ke Tokopedia Console jika sudah memiliki akun Tokopedia Console.
  4. Pilih App Management
  5. Pada App Management, terdapat Live Apps. Klik Add Live Apps jika ingin membuat live app baru atau pilih live app yang sudah ada.
  6. Pengguna akan diarahkan ke halaman Aunthentication Management. Lalu salin informasi seperti, App ID, Client ID, dan Client Secret.
  7.  Informasi tersebut akan digunakan untuk autentifikasi di integrasi pengguna dengan Tokopedia.
  8. Buka tab IP Whitelist & Public Key dan whitelist server IP Platform Lenna (202.3.218.138) untuk mengizinkan permintaan masuk dari server.
  9. Pada tab Shop Management, tambahkan Tokopedia shop Pengguna. Pengguna dapat menambahkan lebih dari satu Tokopedia shop bila dibutuhkan.

Dengan mengikuti langkah-langkah tersebut, Pengguna dapat membuat aplikasi langsung di Tokopedia dan mengonfigurasi pengaturan yang diperlukan untuk integrasi dengan platform mereka. Penting untuk memastikan bahwa Pengguna memberikan informasi yang akurat dan lengkap selama proses penyiapan untuk memastikan pengalaman integrasi yang profesional dan lancar.

II. Set up Akun Tokopedia di Platform Lenna

  1. Log in akun pada Platform Lenna, lalu pilih project.
  2. Pilih menu Integration dan pilih Tokopedia integration.
  3. Buat integrasi Tokopedia baru dan masukan data yang diperlukan. Pengguna harus memberikan Channel secret dan token Channel access.
  4. Setelah integrasi baru berhasil dibuat, klik edit dan copy webhook URL (contoh: https://staging.lenna.ai/app/public/api/webhook/tokopedia). URL tersebut akan digunaka untuk mengirim events dari Tokopedia API ke Platform Lenna.

III. Set up Tokopedia Developer

  1. Pada akun Tokopedia Developer, pilih menu Webhook Settings.
  2. Aktifkan (enabled) chat_notofication.
  3. Sisipkan (paste) Webhook URL ke chat_notification di Webhook Setting. Hal tersebut akan memberitahukan Tokopedia API untuk mengirim events ke Platform Lenna.

11. INTEGRATE YOUR OWN APPS

Integrasi ini memungkinkan Anda untuk menghubungkan agen dengan pengguna melalui aplikasi. Berikut langkah-langkah yang harus dipersiapkan untuk integrasi aplikasi.

I. Dokumentasi API

Platform Lenna memerlukan dokumentasi lengkap mengenai API yang diperlukan dari klien. Dokumentasi ini harus mencakup:

  • Deskripsi lengkap setiap endpoint API yang diperlukan oleh Lenna.
  • Metode HTTP yang digunakan (GET, POST, PUT, DELETE, dll.).
  • Headers yang diperlukan dalam setiap permintaan (termasuk autentikasi jika diperlukan).
  • Parameter yang harus disertakan dalam setiap permintaan dan format data yang diharapkan.
  • Contoh konkret bagaimana mengirim permintaan API dengan benar.
  • Struktur respons yang akan diterima setelah permintaan berhasil.
  • Pengelolaan error: Bagaimana menangani respons error dan kode status yang mungkin diterima.

II. Mapping API Dengan Flow Chatbot

Setelah mendapatkan dokumentasi API dari klien, platform Lenna akan memetakan setiap langkah dari flow chatbot dengan endpoint-endpoint API yang diberikan dalam dokumentasi. Ini berarti mencocokkan titik-titik dalam percakapan chatbot di mana permintaan API harus dikirim atau respons API harus diinterpretasikan.

III. Register Function List

Platform Lenna akan mendaftarkan fungsi-fungsi yang sesuai dengan API yang diberikan dalam dokumentasi. Ini termasuk mengintegrasikan API ke dalam sistem Lenna agar dapat digunakan dalam percakapan chatbot.

IV. Buat Konten dan Parameter

Berdasarkan mapping yang dilakukan sebelumnya, platform Lenna akan mengisi konten percakapan dan parameter-parameter yang diperlukan sesuai dengan alur percakapan yang telah ditentukan. Parameter-parameter ini akan digunakan dalam permintaan API yang dikirim ke klien.



Was this article helpful?

What's Next