Lebih cepat ke konten utama
@capgo/capacitor-intercom Komunikasi Terbuka sumber

Intercom Plugin Capacitor

Integrasikan chat langsung Intercom, pusat bantuan, dan alur kerja dukungan di aplikasi Capacitor Anda

Pasang

bun add @capgo/capacitor-intercom bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-intercom
  • pnpm add @capgo/capacitor-intercom
  • yarn add @capgo/capacitor-intercom

Panduan

Cara menggunakan Intercom di Capacitor

Uji coba di perangkat

Unduh aplikasi Capgo, kemudian scan kode QR code.

Tautan QR pratinjau plugin code Intercom

Menggunakan @capgo/capacitor-intercom

Plugin Intercom Capacitor.

Pasang

bun add @capgo/capacitor-intercom
bunx cap sync

bunx cap sync Menggandakan kode native plugin code ke proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.

Impor

import { CapgoIntercom } from '@capgo/capacitor-intercom';

Pandangan singkat API

Metode Deskripsi
loadWithKeys Mulai Intercom dengan API kunci pada waktu runtime. Gunakan ini jika Anda lebih suka tidak mengonfigurasi kunci di capacitor.config.
registerIdentifiedUser Daftarkan pengguna yang diketahui dengan Intercom. Setidaknya salah satu userId atau email harus disediakan.
registerUnidentifiedUser Daftarkan pengguna anonim dengan Intercom.
updateUser Perbarui atribut pengguna di Intercom.
logout Keluar dari Intercom.
logEvent Log acara kustom di Intercom.
displayMessenger Buka pesan Intercom.
displayMessageComposer Buka komposer pesan dengan pesan yang sudah diisi.
displayHelpCenter Buka pusat bantuan Intercom.
hideMessenger Tutup pesan Intercom.
displayLauncher Tampilkan tombol peluncur Intercom.
hideLauncher Tutup tombol peluncur Intercom.
displayInAppMessages aktifkan pesan dalam aplikasi dari Intercom.
hideInAppMessages nonaktifkan pesan dalam aplikasi dari Intercom.
displayCarousel tampilkan carousel Intercom tertentu.
displayArticle tampilkan artikel Intercom tertentu.
displaySurvey tampilkan survei Intercom tertentu.
setUserHash atur HMAC untuk verifikasi identitas.
setUserJwt atur JWT untuk autentikasi pesan aman.
setBottomPadding atur jarak bawah untuk antarmuka UI pesan Intercom.
sendPushTokenToIntercom Kirimkan token notifikasi push ke Intercom.
receivePush proses notifikasi push yang diterima dari Intercom.
getUnreadConversationCount ambil jumlah percakapan yang belum dibaca untuk pengguna saat ini.

Contoh-Contoh

loadWithKeys()

Mulai Intercom dengan API kunci pada waktu runtime. Gunakan ini jika Anda lebih suka tidak mengkonfigurasi kunci di capacitor.config.

import { CapgoIntercom } from '@capgo/capacitor-intercom';

await CapgoIntercom.loadWithKeys({
  appId: 'app-id-123',
  apiKeyIOS: 'api-key-ios',
  apiKeyAndroid: 'api-key-android',
});

registerIdentifiedUser()

Daftarkan pengguna yang diketahui dengan Intercom. Setidaknya salah satu userId atau email harus disediakan.

import { CapgoIntercom } from '@capgo/capacitor-intercom';

await CapgoIntercom.registerIdentifiedUser({
  userId: 'user-id-123',
  email: 'user@example.com',
});

registerUnidentifiedUser()

Daftarkan pengguna anonim dengan Intercom.

import { CapgoIntercom } from '@capgo/capacitor-intercom';

await CapgoIntercom.registerUnidentifiedUser();

updateUser()

Perbarui atribut pengguna di Intercom.

import { CapgoIntercom } from '@capgo/capacitor-intercom';

await CapgoIntercom.updateUser({ userId: 'user-id-123' });

logout()

Keluar dari Intercom.

import { CapgoIntercom } from '@capgo/capacitor-intercom';

await CapgoIntercom.logout();

logEvent()

Logkan acara kustom di Intercom.

import { CapgoIntercom } from '@capgo/capacitor-intercom';

await CapgoIntercom.logEvent({ name: 'example' });

Tabel di atas menampilkan 23 metode inti. Bantuan listener dan versi, serta kontrak lengkap dari setiap metode, dapat dilihat dalam repository GitHub.

kembali sebuah handle. Panggil

addListener ketika layar dihapus, atau handle.remove() untuk menghapus setiap pendengar. CapgoIntercom.removeAllListeners() Menghapus semua pendengar.

Referensi lengkap

Teruskan dari Menggunakan @capgo/capacitor-intercom

Jika Anda menggunakan Menggunakan @capgo/capacitor-intercom untuk merencanakan pekerjaan plugin native, hubungkannya dengan @capgo/capacitor-intercom untuk detail implementasi di @capgo/capacitor-intercom Mulai Menggunakan untuk detail implementasi di Mulai, Capgo Direktori Plugin untuk alur kerja produk di Capgo Direktori Plugin Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin oleh Capgo, dan Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin.

FAQ

FAQ untuk Plugin Intercom

Bagaimana cara menginstal plugin Intercom di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-intercom" (atau "npm install @capgo/capacitor-intercom"), kemudian jalankan "bunx cap sync" agar proyek iOS dan Android dapat menangkap native code. Import dari "@capgo/capacitor-intercom" di aplikasi code.

Apakah @capgo/capacitor-intercom dapat digunakan dengan React, Vue, dan Angular?

Iya. Intercom adalah paket Capacitor, sehingga dapat digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-intercom?

Plugin Capgo mengikuti versi utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menyebutkan versi yang masih dipelihara.

Apakah @capgo/capacitor-intercom gratis dan sumber terbuka?

Ya. Sumber code tersedia secara publik di GitHub di https://github.com/Cap-go/capacitor-intercom/ dan paketnya dapat diinstal secara gratis dari npm. Laporan bug dan permintaan pull selalu welcome.

Apakah saya bisa memperbarui code yang menggunakan Intercom tanpa melalui ulasan App Store?

Pemasangan atau pembaruan plugin mengubah native code, sehingga memerlukan build toko baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin dapat berlalu-lalang dengan Capgo live updates.

Kirim perubahan Intercom tanpa harus menunggu tinjauan aplikasi

Once the plugin is in your store build, Capgo live updates push your JavaScript, HTML and CSS changes to users in minutes.

Mulai dengan Capgo