Salam hangat dari Mekari Qontak,
Terima kasih telah memilih Mekari Qontak sebagai partner bisnis di perusahaan Anda
Kami ingin menginformasikan mengenai pembaruan pada endpoint API Mekari Qontak untuk mendapatkan akses token API. Pembaruan ini akan dilakukan pada 11 April 2025. Sebelum proses berlangsung, berikut ini beberapa hal yang perlu Anda perhatikan:
- Anda perlu menginformasikan kepada tim Engineering Anda untuk segera mengubah endpoint di konfigurasi Mekari Qontak API sesuai dengan Module dan Aktivitas yang Anda gunakan.
- Detail perubahan Endpoint:
| Mekari Qontak API OAuth URL Update | ||
| Detail (Production) | Old Endpoint | New Endpoint |
| Qontak CRM | https://app.qontak.com/api/ | https://api.mekari.com/qontak/crm/ |
| Qontak Omnichannel | https://service-chat.qontak.com{postfix}/ | https://api.mekari.com/qontak/chat/ |
- Sebelum melanjutkan panduan ini, pastikan akun Anda telah mendapatkan otorisasi untuk Mekari Developer (https://developers.mekari.com/). Jika anda tidak dapat mengakses Mekari Developer, berarti akun belum diotorisasi. Silakan hubungi spesialis atau tim support untuk mendapatkan akses.
- Untuk mendapatkan autentikasi API, login pada akun Mekari Developer anda, lalu ikuti panduan dibawah:
a. Buka Mekari Developer dan login dengan akun Mekari SSO Anda.
b. Pilih Applications (guide dokumentasi)
c. Buat aplikasi baru dengan mengisi nama aplikasi, nama perusahaan, dan memilih scope yang diperlukan.
- Pada bagian ‘Authorized Scope’ Anda perlu mencentang scope yang diperlukan untuk integrasi. Setiap scope mewakili endpoint API tertentu. Pilihlah hanya scope yang benar-benar dibutuhkan untuk aplikasi internal perusahaan Anda.
Anda dapat membuat dua aplikasi terpisah untuk scope Qontak Chat dan Qontak CRM jika diperlukan, guna meningkatkan keamanan, dengan menghasilkan Client ID & Client Secret yang berbeda.
d. Catat Client ID dan Client Secret.
e. Pilih HMAC Validator, lalu isi Client ID, Client Secret, HTTP Method, Full API URL, dan Date Header.
f. Klik Submit, lalu salin Authorization Header yang muncul.
- Selebihnya mengenai dokumen Open API dapat diakses melalui:
a. Qontak CRM: https://documenter.getpostman.com/view/22728681/2sAXxV6A5V#1476859d-d470-483a-b6bc-a04db4b2b027
b. Qontak Omnichannel: https://docs.qontak.com/docs/omnichannel-hub/3f11066e2ce6c-api-mekari-v1-0
Mengapa perlu diperbarui?
- Memastikan setiap permintaan API Anda terverifikasi dengan benar untuk mencegah akses tidak sah.
- Mengikuti Standar Terkini: Mempermudah pengelolaan dan kompatibilitas dengan pembaruan selanjutnya.
- Keamanan Data Lebih Kuat: Menambahkan lapisan perlindungan ekstra untuk menjaga keamanan pengguna.
Demikian yang dapat kami sampaikan. Apabila Anda memiliki pertanyaan lebih lanjut, silakan sampaikan ke support-qontak@mekari.com atau WhatsApp Hotline Support di 6285180971599.
