@essent/nativescript-iadvize

一个将 iAdvize 聊天集成到 Android/iOS 应用的 NativeScript 插件。

这是一个显示 iAdvize 聊天对话的插件，使用 iAdvize SDK（Android v2.2.2，iOS v2.2.5）。

要求

• iOS 12.0 或更高版本，以及 Xcode 12.5
• 最低 Android 版本 API 19，以及 Kotlin 1.5.10
• NativeScript CLI 7.x
• iAdvize 账户

安装

从您的项目根目录运行以下命令

npm install @essent/nativescript-iadvize

激活

当用户登录到您的应用时，使用您的凭证调用 activate（我们的示例 home.component.ts）

IAdvize.activate(XXXX, 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'userId', () => {
  console.log('IAdvize conversation activated.');
});

聊天

要打开聊天窗口，请调用 presentChat()

IAdvize.presentChat();

可选功能

隐藏默认聊天按钮

要隐藏默认聊天按钮，请调用 hideDefaultChatButton()

IAdvize.hideDefaultChatButton();

UI 定制

要自定义聊天窗口 UI，请调用 customize()

const configuration: ChatConfiguration = {
  automaticMessage: 'Any question? Say Hello to Smart and we will answer you as soon as possible! 😊',
  font: 'fontPath',
  incomingMessageAvatar: 'avatar-icon',
  mainColor: '#4103fc',
  navigationBarBackgroundColor: '#4103fc',
  navigationBarMainColor: '#ffffff',
  navigationBarTitle: 'Chat Title',
};
IAdvize.customize(configuration);

注销

为保护用户对话的机密性，请调用 logout()。

IAdvize.logout();

对话事件

要添加实时通知对话事件的监听器，请调用 registerConversationListener()。

IAdvize.registerConversationListener(
  (url: string) => {
    console.log('Handle clicked url - ' + url);
    return false;
  },
  (hasOngoingConversation: boolean) => {
    console.log('Ongoing conversation status changed - ' + hasOngoingConversation);
  }
);

推送通知

当您的应用未运行时，要接收聊天消息的通知，请调用 registerPushToken()

IAdvize.registerPushToken('your-token', isProduction);