Saltare al contenuto principale
@capgo/capacitor-intercom Comunicazione Sorgente aperta

Intercom Plugin Capacitor

Integra il live chat, il centro aiuto e le workflow di supporto di Intercom nel tuo Capacitor app

Installare

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

Guida

Come utilizzare Intercom in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansa il codice QR code.

Collegamento QR di anteprima del plugin code Intercom

Utilizza @capgo/capacitor-intercom

Plugin Intercom Capacitor

Installa

bun add @capgo/capacitor-intercom
bunx cap sync

bunx cap sync Copia il nativo code del plugin nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

Vedi API in un colpo d'occhio

Metodo Descrizione
loadWithKeys Inizializza Intercom con API chiavi in esecuzione. Utilizza questo se preferisci non configurare le chiavi in capacitor.config.
registerIdentifiedUser Registra un utente noto con Intercom. Almeno uno dei valori userId o email deve essere fornito.
registerUnidentifiedUser Registra un utente anonimo con Intercom.
updateUser Aggiorna gli attributi dell'utente in Intercom.
logout Effettua il logout dell'utente da Intercom.
logEvent Racchiuda un evento personalizzato in Intercom.
displayMessenger Apri il messaggero di Intercom.
displayMessageComposer Apri il compositore di messaggi con un messaggio precompilato.
displayHelpCenter Apri il centro aiuto di Intercom.
hideMessenger Nascondi il messaggero di Intercom.
displayLauncher Mostra il pulsante di lancio di Intercom.
hideLauncher Nascondi il pulsante di lancio di Intercom.
displayInAppMessages Abilita messaggi in-app da Intercom.
hideInAppMessages Disabilita messaggi in-app da Intercom.
displayCarousel Mostra un carosello Intercom specifico.
displayArticle Mostra un articolo Intercom specifico.
displaySurvey Mostra un sondaggio Intercom specifico.
setUserHash Imposta l'HMAC per la verifica dell'identità.
setUserJwt Imposta JWT per l'autenticazione del messaggero sicura.
setBottomPadding Imposta lo spazio inferiore per l'interfaccia utente del messaggero Intercom.
sendPushTokenToIntercom Inviare un token di notifica push a Intercom.
receivePush Gestisci una notifica push ricevuta da Intercom.
getUnreadConversationCount Ottieni il numero di conversazioni non lette per l'utente corrente.

Esempi

loadWithKeys()

Avvia Intercom con API chiavi in esecuzione. Utilizza questo se preferisci non configurare le chiavi in capacitor.config.

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

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

registerIdentifiedUser()

Registra un utente noto con Intercom. Almeno uno dei campi userId o email deve essere fornito.

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

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

registerUnidentifiedUser()

Registra un utente anonimo con Intercom.

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

await CapgoIntercom.registerUnidentifiedUser();

updateUser()

Aggiorna gli attributi dell'utente in Intercom.

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

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

logout()

Disconnetti l'utente da Intercom.

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

await CapgoIntercom.logout();

logEvent()

Racconta un evento personalizzato in Intercom.

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

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

La tabella sopra elenca le 23 metodologie di base. Gli ascoltatori e gli aiuti di versione, e la piena contrattazione di ogni metodo, sono documentati nel GitHub repository.

Ascolta gli eventi

addListener ritorna un handle. Chiama handle.remove() quando lo schermo viene smontato, o CapgoIntercom.removeAllListeners() per cancellare tutti gli ascoltatori.

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-intercom

Se stai utilizzando Utilizzo di @capgo/capacitor-intercom per pianificare il lavoro del plugin nativo, connettilo con @capgo/capacitor-intercom per i dettagli di implementazione in @capgo/capacitor-intercom Avvio rapido per i dettagli di implementazione in Avvio rapido, Capgo Directory dei Plugin per il workflow del prodotto in Capgo Directory dei Plugin Capacitor Plugin da Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo, e Aggiungere o Aggiornare i Plugin per i dettagli di implementazione in Aggiungere o Aggiornare i Plugin.

FAQ

Domande frequenti sul plugin Intercom

Come posso installare il plugin Intercom in un'app Capacitor?

Esegui "bun add @capgo/capacitor-intercom" (o "npm install @capgo/capacitor-intercom"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il nativo code. Importalo da "@capgo/capacitor-intercom" nella tua app code.

Funziona @capgo/capacitor-intercom con React, Vue e Angular?

Sì. Intercom è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione Capacitor supportata da @capgo/capacitor-intercom?

I plugin Capgo seguono la versione maggiore di Capacitor: utilizza la versione del plugin maggiore che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È @capgo/capacitor-intercom gratuito e open source?

Sì. Il codice sorgente di code è pubblico su GitHub in https://github.com/Cap-go/capacitor-intercom/ e il pacchetto è gratuito per l'installazione da npm. I segnalazioni di bug e le richieste di pull sono benvenute.

Può aggiornare code che utilizza Intercom senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il codice nativo di code, quindi richiede una nuova costruzione del negozio. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con gli aggiornamenti live di Capgo.

Invia modifiche a Intercom senza dover attendere la revisione dell'app

Una volta che il plugin è stato caricato nella tua store build, le Capgo live updates inviano le tue modifiche JavaScript, HTML e CSS ai utenti in pochi minuti

Inizia con Capgo