Getting Started
이 플러그인 설치 단계와 전체 마크다운 가이드를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-intercom`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/intercom/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
설치
설치AI 도움을 받아 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요.
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins그런 다음 다음 명령어를 사용하세요:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-intercom` plugin in my project.만약 Manual Setup을 선호한다면, 다음 명령어를 실행하고 아래 플랫폼별 지침을 따르세요:
bun add @capgo/capacitor-intercombunx cap syncImport
__CAPGO_KEEP_0__ 개요import { CapgoIntercom } from '@capgo/capacitor-intercom';API 개요
API 로드인터콤을 API 키와 함께 런타임에 초기화하세요. capacitor .config에서 키를 구성하지 않아도 되는 경우에 사용하세요.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.loadWithKeys({ appId: 'app-id-123', apiKeyIOS: 'api-key-ios', apiKeyAndroid: 'api-key-android',});registerIdentifiedUser
등록된 사용자 등록등록된 사용자를 Intercom에 등록합니다. 사용자 ID 또는 이메일 중 하나 이상을 제공해야 합니다.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.registerIdentifiedUser({ userId: 'user-id-123', email: 'user@example.com',});registerUnidentifiedUser
익명 사용자 등록익명 사용자를 Intercom에 등록합니다.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.registerUnidentifiedUser();updateUser
사용자 정보 업데이트Intercom에서 사용자 정보를 업데이트합니다.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.updateUser({ userId: 'user-id-123' });logout
로그아웃Intercom에서 사용자를 로그아웃합니다.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.logout();logEvent
로그 이벤트Intercom에서 사용자 지정 이벤트를 로깅합니다.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.logEvent({ name: 'example' });displayMessenger
메신저 열기메시지 작성을 위한 메신저 열기
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.displayMessenger();displayMessageComposer
도움말 열기도움말 열기
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.displayMessageComposer({ message: 'Hello from Capacitor' });displayHelpCenter
Intercom 도움말을 열어줍니다.Intercom에서 사용자 지정 이벤트를 로깅합니다.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.displayHelpCenter();hideMessenger
hideMessenger인터콤 메신저를 숨기세요.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.hideMessenger();displayLauncher
displayLauncher인터콤 런처 버튼을 표시하세요.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.displayLauncher();hideLauncher
hideLauncher인터콤 런처 버튼을 숨기세요.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.hideLauncher();displayInAppMessages
displayInAppMessages인터콤 인앱 메시지를 활성화하세요.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.displayInAppMessages();hideInAppMessages
hideInAppMessages애플리케이션 내 메시지 표시를 끕니다.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.hideInAppMessages();displayCarousel
displayCarousel특정 Intercom 카러셀을 표시합니다.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.displayCarousel({ carouselId: 'carousel-id-123' });displayArticle
displayArticle특정 Intercom 기사입니다.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.displayArticle({ articleId: 'article-id-123' });displaySurvey
displaySurvey특정 Intercom 설문조사를 표시합니다.
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.displaySurvey({ surveyId: 'survey-id-123' });setUserHash
setUserHash사용자 식별성을 위한 HMAC 설정
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.setUserHash({ hmac: 'hmac' });setUserJwt
setUserJwt안전한 메신저 인증을 위한 JWT 설정
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.setUserJwt({ jwt: 'jwt' });setBottomPadding
setBottomPadding인터콤 메신저 UI의 하단 패딩 설정
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.setBottomPadding({ value: 1 });sendPushTokenToIntercom
sendPushTokenToIntercom인터콤으로 푸시 알림 토큰 전송
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.sendPushTokenToIntercom({ value: 'value' });receivePush
받기받은 메시지 처리
import { CapgoIntercom } from '@capgo/capacitor-intercom';
await CapgoIntercom.receivePush({});getUnreadConversationCount
읽지 않은 대화 수 가져오기타입 참조
import { CapgoIntercom } from '@capgo/capacitor-intercom';
const result = await CapgoIntercom.getUnreadConversationCount();console.log(result);타입 참조
인터콤 로드 옵션IntercomLoadOptions
인터콤 식별된 사용자 옵션export interface IntercomLoadOptions { appId?: string; apiKeyIOS?: string; apiKeyAndroid?: string;}IntercomIdentifiedUserOptions
설명export interface IntercomIdentifiedUserOptions { userId?: string; email?: string;}IntercomUserUpdateOptions
인터콤 사용자 업데이트 옵션export interface IntercomUserUpdateOptions { userId?: string; email?: string; name?: string; phone?: string; languageOverride?: string; customAttributes?: { [key: string]: any }; companies?: IntercomCompany[];}IntercomLogEventOptions
인터콤 로그 이벤트 옵션export interface IntercomLogEventOptions { name: string; data?: { [key: string]: any };}IntercomMessageComposerOptions
인터콤 메시지 컴포저 옵션export interface IntercomMessageComposerOptions { message: string;}IntercomCarouselOptions
인터콤 캐러셀 옵션export interface IntercomCarouselOptions { carouselId: string;}IntercomArticleOptions
인터콤 기사 옵션export interface IntercomArticleOptions { articleId: string;}IntercomSurveyOptions
인터콤 설문 옵션export interface IntercomSurveyOptions { surveyId: string;}IntercomUserHashOptions
인터콤 사용자 해시 옵션export interface IntercomUserHashOptions { hmac: string;}IntercomUserJwtOptions
인터콤 사용자 JWT 옵션export interface IntercomUserJwtOptions { jwt: string;}IntercomBottomPaddingOptions
인터콤 하단 패딩 옵션export interface IntercomBottomPaddingOptions { value: number;}IntercomPushTokenOptions
인터콤 푸시 토큰 옵션export interface IntercomPushTokenOptions { value: string;}실제 데이터 원천
실제 데이터 원천이 페이지는 플러그인의 src/definitions.ts. API를 다시同步할 때 upstream의 API이 변경되면 다시 실행하세요.
Getting Started에서 계속하세요.
Getting Started에서 계속하세요.만약 __CAPGO_KEEP_0__을 사용하고 있다면 Getting Started API를 사용하여 대시보드와 API 운영을 계획하고 있다면 API를 __CAPGO_KEEP_1__와 연결하세요. Using @capgo/capacitor-intercom Using @capgo/capacitor-intercom API 개요 API Overview Introduction Introduction API 키 API 구현 세부 정보에 대한 키 기기 __CAPGO_KEEP_0__ 구현 세부 정보에 대한 기기