Freshdesk 反应原生 SDK

"现代售票软件 你的销售和客户业务约定团队会喜欢。" 原生反应 本地新办公桌的包装 iOS系统 财务报告和审定财务报表 机器人 SDKs——客户支持,直播 聊天, 和知识库 为您的 React Industrial app .

特征

• 现场聊天和支持家庭
• 知识库/财务问题
• 打开特定主题
• 未读信件计数( 一发和实时)
• 用户和售票属性
• JWT 用户认证
• 用户事件跟踪
• 内容配置/ 本地化
• 自定义链接处理
• 按下通知( 在主机应用程序中本地配置)

所需资源

• 原生反应 QQ 0.75 (单位:千美元)peerDependencies.react-native 实值 >=0.75.0) (中文(简体) ). 打开 RN < 0.75, 继续使用 ~1.4.3 ——这是1.4.x已经实际坐过的地方.
• 支持新架构 . 模块是后相兼容的:一个涡轮模块 当启用了新架构时,则使用经典桥模。 没有 JavaScript API或代码需要修改,无论是哪种方式.
• iOS 15.0+——作为销售商的本地SDK船 FreshdeskSDK.xcframework (无 Swift 软件包管理器 /) use_frameworks! 要求).
• Android API 26+ (英语:minSdkVersion 26, (中文(简体) ), compileSdkVersion 35,Android Gradle插件 8.6+) 中,该插件可以使用
• 1.12+ (iOS) 可可胶囊

从1.4.x升级? 见 MIGRATION.md iOS Podfile / (英语) Gemfile变化是主要步骤.

少数方法(resetUser, (中文(简体) ), enableDebugLogs, (中文(简体) ), getUnreadCount行为 android vs iOS上略有不同 因为两个本地的SDK没有 暴露同样的能力——见 PLATFORM_DIFFERENCES.md 在依靠他们准确的运行时间行为之前.

安装

npm install @freshworks/react-native-freshdesk-sdk
# or
yarn add @freshworks/react-native-freshdesk-sdk

库会使用自動連接- React Introduct 0.60+不需要手动连接.

iOS系统

设置您的部署目标 Podfile 并安装吊舱——无 use_frameworks! 需要(作为X框架销售商的自来自来自来自来自来自来自来自来自来自来自去自来自来自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自去自自去自自自去自自自去自自去自自去自自自去自自自去自自自自自自去自自去自自自自自去自出自自出自自出自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自自 cockspec 构建为静态框架 :

platform :ios, '15.0'

cd ios && pod install

保留 use_frameworks! 璶 其他项目 依赖性需要它 - 偏好 :linkage => :static从1.4.x升级? 1.4.x Podfile / Gemfile 需要文件 首先删除的 SPM 线条——参见 MIGRATION.md。 。 。 .

完整指南(部署目标指针,将框架嵌入您的应用程序捆绑、推) 装有货包的船只——见 docs/integration/installation.md (即说. node_modules/@freshworks/react-native-freshdesk-sdk/docs/integration/installation.md 一次 ),或浏览而不安装在 unpkg.com/browse/@freshworks/resact-native-freshdesk-sdk/docs/整合/安装.md。 。 。 .

机器人

保证 mavenCentral() 在你的仓库里 minSdkVersion 为 26+。 本地依赖性 (单位:千美元)com.freshworks.sdk:freshdesk自动列入.

allprojects {
  repositories {
    google()
    mavenCentral()
  }
}

文档

你从Freshdesk入口处得到你的证书: 管理设置 — 移动聊天 SDK — 您的 SDK (单位:千美元)token, (中文(简体) ), host, (中文(简体) ), sdkId) (中文(简体) ). 对于 JWT 强制SDK , 您还需要一个用户 jwt。 。 。 .

初始化

在您的应用生命周期中尽早初始化一次 。 所有其他方法都要求 初始化为先.

要求 : token, (中文(简体) ), host,以及 sdkId 从Freshdesk门户. 可选 : locale, (中文(简体) ), jwt (仅限JWT强制部件), debugMode (Android) (英语). 推动通知设置(Firebase, APN、传送门按键) 没有 初始化的一部分——SDK用于应用中的支持 ; 当您需要托盘通知时, 单独配置按键.

包装套装 hostPlatform 改为 reactnative sDK 遥测头的内部 (单位:千美元)x-fd-mobile-sdk; 应用程序不通过或配置此选项.

import FreshdeskSDK from '@freshworks/react-native-freshdesk-sdk';

await FreshdeskSDK.initialize({
  token: 'your-account-token',
  host: 'your-host.freshdesk.com',
  sdkId: 'your-sdk-id',
  locale: 'en',        // optional, default 'en' (applied at init only)
  jwt: 'your-jwt',     // required only for JWT-enforced SDKs
  debugMode: false,    // optional, Android only
});

推进通知是可选的 。 推,SDK也必须被初始化 本土 在应用 启动,因为设备标志在JS层运行前到达. 见 推动通知. 应用中支持工程不推接线.

启动支助经验

// Support home
await FreshdeskSDK.openSupport();

// Knowledge base / FAQ
await FreshdeskSDK.openKnowledgeBase();

// A specific topic (topicId is optional)
await FreshdeskSDK.openTopic({ topicName: 'Orders', topicId: '12345' });

// Dismiss any open Freshdesk view
await FreshdeskSDK.dismiss();

未读数

// One-shot value
const count = await FreshdeskSDK.getUnreadCount();

// Real-time updates
const sub = FreshdeskSDK.addUnreadCountListener((event) => {
  console.log('Unread count:', event.count);
});

// Clean up when done
sub?.remove();

用户和售票属性

对于非JWT强制SDK,在初始化后设置用户属性. (财产必须是: 在链接部件的联系人/勾选字段下列出白名单 。)

await FreshdeskSDK.setUserProperties({
  name: 'Jane Doe',
  email: '[email protected]',
  phone: '+1234567890',
});

await FreshdeskSDK.setTicketProperties({
  subject: 'Product Enquiry',
  priority: 3,
});

// Read current user
const user = await FreshdeskSDK.getUser();

关于JWT强制自毁K,用户特性通过JWT有效载荷更新——见下文.

JWT 认证

Freshdesk使用JSON Web Tokens只允许认证的用户开始对话.

1. 通过 jwt 期间 initialize() (JWT-强制SDKs的强制性规定).
2. 查看用户状态变化 .
3. 更新/更新代号为 authenticateAndUpdate。 。 。 .

const sub = FreshdeskSDK.addUserStateListener((event) => {
  // States: 'authenticated', 'authExpired', 'notAuthenticated',
  //         'identifierUpdated', 'jwtNotPresent', 'undefined'
  console.log('User state:', event.state);
});

// Refresh or update the user with a new JWT (also updates user/ticket properties from payload)
await FreshdeskSDK.authenticateAndUpdate('new-jwt-token');

重置用户

调用登录( 或在切换账户前) 来清除用户的会话和数据 .

const result = await FreshdeskSDK.resetUser();
// { success: boolean; message?: string; error?: string }

跟踪用户事件

跟踪事件,以用作互动环境、触发消息或分割.

await FreshdeskSDK.trackEvent('add_to_cart', { productId: '12345', quantity: 2 });

内容配置/ 本地化

覆盖静态部件文本(标题、占位符、票单、隐私政策、响应时间) [原件:英 您省略的任何字段都会保留部件默认; 通过 {} 重置为默认值。 变化仍在继续 立即生效.

await FreshdeskSDK.setContentConfiguration({
  headers: {
    chat: 'Talk to our team',
    faq: 'Help Centre',
    ticketForm: { title: 'Raise a ticket', submitBtnTitle: 'Submit' },
  },
  placeholders: {
    replyField: 'Type your reply...',
    searchField: 'Search articles...',
  },
  privacyPolicySetting: {
    privacyPolicyMessage: 'We respect your privacy',
    privacyPolicyLinkText: 'Privacy Policy',
    privacyPolicyLink: 'https://example.com/privacy',
  },
});

自定义链接处理器

控制SDK内部所压的链接(如深链接).

import { Linking } from 'react-native';

const sub = FreshdeskSDK.setLinkHandler((event) => {
  if (event.url.startsWith('myapp://')) {
    // handle deep link
    return;
  }
  Linking.openURL(event.url);
});

sub?.remove();

事件和清理

import FreshdeskSDK, { FreshdeskEvents } from '@freshworks/react-native-freshdesk-sdk';

FreshdeskSDK.addUnreadCountListener(/* ... */);
FreshdeskSDK.addUserStateListener(/* ... */);
FreshdeskSDK.addUserCreatedListener(/* ... */); // iOS only

// Remove every listener (e.g. on unmount)
FreshdeskSDK.removeAllListeners();

// Event name constants
FreshdeskEvents.UNREAD_COUNT_CHANGED; // 'unreadCountChanged'
FreshdeskEvents.USER_STATE_CHANGED;   // 'userStateChanged'
FreshdeskEvents.USER_CREATED;         // 'userCreated'
FreshdeskEvents.ON_LINK_PRESSED;      // 'onLinkPressed'

推动通知

推车搞定了 本土 ——没有JavaScript push API. 主机应用程序必须初始化 SDK 在启动时以本地方式转发设备令牌/ 发送信件 :

• iOS系统 ——APNs .p8 认证密钥, 推动通知+背景模式能力, 以及本地 输入 AppDelegate。 。 。 .
• 机器人 - 消防队(google-services.json), Google 服务插件, 以及本地输入 MainApplication.onCreate() 加一个 FirebaseMessagingService。 。 。 .

SDK源寄存器中的样本应用是参考线条(Freshworks GitHub access) 要求: 样本( a)) (中文(简体) ). 带包裹的全程飞船——见 docs/integration/installation.md#push-notifications,或 浏览到 unpkg.com/browse/@freshworks/resact-native-freshdesk-sdk/docs/整合/安装.md。 。 。 .

SDK 资讯

const version = await FreshdeskSDK.getSDKVersion();

诊断

校验或调试您的整合 :

await FreshdeskSDK.enableDebugLogs(true);
const report = await FreshdeskSDK.runDiagnostics();
console.log(report.prettyPrinted);

在iOS上,它运行着本土结构化诊断(FreshdeskSDK 1.3+). 在Android的包装上 在本地诊断对土地进行平等使用之前进行回返综合检查 debugMode: true 财务报告和审定财务报表 显示更深的信号.

AI 整合工具箱

Npm 包装一个 AI 整合工具箱 教授编码代理(Cursor, Claude, 副驾驶, Codex, Kiro) 如何将 SDK 集成并调试到您的 React Introduct app中.

安装后 :

cp -R node_modules/@freshworks/react-native-freshdesk-sdk/ai-integration-kit/. /path/to/your-app/

然后问你的AI工具:"使用新鲜的桌面-反应-内在-整合技能并连接新鲜的桌面 支持。"

警棍技能(用于SDK维护者): ai-integration-kit/ai/skills/freshdesk-react-native-integration/SKILL.md。 。 。 . 再生成工具副本 npm run sync:ai-kit。 。 。 .

全套工具绘图和使用指导船舶使用该包——见 ai-integration-kit/README.md (即说. node_modules/@freshworks/react-native-freshdesk-sdk/ai-integration-kit/README.md ),或浏览而不安装 unpkg.com/browse/@refreshworks/resact-native-refreshdesk-sdk/ai-Institution-kit/README.md 互联网档案馆的存檔,存档日期2013-12-22。 。 。 .

处理错误

所有的方法都回报承诺。 常见错误代码 :

完整文档

这些导航船,包裹在 docs/integration/ (即说. node_modules/@freshworks/react-native-freshdesk-sdk/docs/integration/ (已安装). 你们可以 也可以不安装即通过unpkg浏览:

• 安装
• 初始化
• API 参考
• 解决问题

许可证

麻省理工学院

支助

• 电子邮件 : 支持@ refreshdesk.com
• 支助门户
• 报告问题 (需要 Freshworks GitHub 访问; 使用上方的支持门户)