Flutter客服支持插件zendesk_flutter_support的使用

Flutter客服支持插件zendesk_flutter_support的使用

本项目是一个新的Flutter插件包，它包括了针对Android和/或iOS平台的特定实现代码。

获取开始

本项目是Flutter的一个起点项目。对于Flutter开发的帮助，可以查看在线文档，其中提供了教程、示例、移动开发指导和完整的API参考。

使用示例

以下是一个使用zendesk_flutter_support插件的完整示例代码。该代码展示了如何初始化插件并打开聊天窗口。

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:zendesk_flutter_support/zendesk_flutter_support.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = '未知';
  final _zendeskPlugin = ZendeskFlutterSupport();

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
    initZendesk();
  }

  // 平台消息是异步的，因此我们在异步方法中进行初始化。
  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion =
          await _zendeskPlugin.getPlatformVersion() ?? '未知平台版本';
    } on PlatformException {
      platformVersion = '获取平台版本失败。';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  Future<void> initZendesk() async {
    if (!mounted) {
      return;
    }
    // 初始化Zendesk插件，需要提供相应的密钥和URL。
    await ZendeskFlutterSupport.initialize('账户密钥', '应用ID', '客户端ID', 'Zendesk URL');
    // 设置访客信息，如姓名、电子邮件、电话号码和部门。
    await ZendeskFlutterSupport.setVisitorInfo(
          name: '文本客户',
          email: 'testclient@example.com',
          phoneNumber: '0000000000',
          department: '支持');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Padding(
                padding: const EdgeInsets.all(16),
                child: Text(
                  '运行在: $_platformVersion\n在main.dart中用正确的密钥初始化示例',
                  textAlign: TextAlign.center,
                ),
              ),
              MaterialButton(
                onPressed: openChat,
                color: Colors.blueGrey,
                textColor: Colors.white,
                child: const Text('打开聊天'),
              )
            ],
          ),
        ),
      ),
    );
  }

  Future<void> openChat() async {
    try {
      // 打开聊天窗口，设置各种选项。
      await ZendeskFlutterSupport.startChat(
          isAgentAvailabilityEnabled: true,
          isChatTranscriptPromptEnabled: true,
          isOfflineFormEnabled: true,
          isPreChatFormEnabled: true);
    } on dynamic catch (ex) {
      print('发生错误 $ex');
    }
  }
}