PHPackages                             chatopera/sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. chatopera/sdk

ActiveLibrary[Utility & Helpers](/categories/utility)

chatopera/sdk
=============

Chatopera企业聊天机器人

2.1.0(4y ago)5575proprietaryPHPPHP >=5.3.3CI failing

Since Nov 20Pushed 4y ago2 watchersCompare

[ Source](https://github.com/chatopera/chatopera-php-sdk)[ Packagist](https://packagist.org/packages/chatopera/sdk)[ Docs](https://github.com/chatopera/chatopera-php-sdk)[ RSS](/packages/chatopera-sdk/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (4)Dependencies (2)Versions (7)Used By (0)

[Chatopera Php SDK](https://github.com/chatopera/chatopera-php-sdk)
===================================================================

[](#chatopera-php-sdk)

低代码或无代码方式定制智能对话机器人！

[Chatopera](https://www.chatopera.com/) 提供聊天机器人开发者平台，Chatopera Php SDK 用于在 PHP 应用中集成[聊天机器人服务](https://bot.chatopera.com/)。

本教程介绍如何使用 Chatopera 机器人开发者平台的[PHP SDK](https://packagist.org/packages/chatopera/sdk)与机器人进行集成，阅读本教程需要 20 分钟时间。

[安装](#%E5%AE%89%E8%A3%85)

[创建机器人](#%E5%88%9B%E5%BB%BA%E6%9C%BA%E5%99%A8%E4%BA%BA)

[执行程序](#%E6%89%A7%E8%A1%8C%E7%A8%8B%E5%BA%8F)

[帮助](#%E5%B8%AE%E5%8A%A9)

[更多 SDK](#%E6%9B%B4%E5%A4%9ASDK)

[开源许可协议](#%E5%BC%80%E6%BA%90%E8%AE%B8%E5%8F%AF%E5%8D%8F%E8%AE%AE)

安装
--

[](#安装)

[*composer*](https://getcomposer.org)是一个优秀到 PHP 项目包管理工具，Chatopera PHP SDK 可通过 composer 直接下载，包文件发布在[packagist](https://packagist.org/packages/chatopera/sdk)。

```
composer require chatopera/sdk

```

【注意】**如果项目不使用[*composer*](https://getcomposer.org)管理，那么可直接下载安装[Chatbot.php](https://github.com/chatopera/chatopera-php-sdk/blob/master/src/chatopera/sdk/Chatbot.php)文件到项目中。**

创建机器人
-----

[](#创建机器人)

 **登录Chatopera聊天机器人平台**
 [ ![](https://user-images.githubusercontent.com/3538629/48039685-e35fcc00-e1b0-11e8-81a9-f26d744fcd1d.png) ](http://bot.chatopera.com/)

### 点击“立即使用”

[](#点击立即使用)

第一登录输入“邮箱”和“密码”，点击“回车键”，完成账户创建。

### 创建聊天机器人

[](#创建聊天机器人)

点击“创建机器人”，并填入下面各项：

项目值描述机器人名称小松机器人的名字描述机器人示例机器人的描述语言zh\_CN机器人的语言，目前支持中文(zh\_CN)和英文(en\_US)【提示】其它项如兜底回复，问候语可以在创建后，设置页面修改。

### 下载知识库文件

[](#下载知识库文件)

下载知识库示例文件[chatopera\_faq\_samples.json](https://static-public.chatopera.com/bot/faq/chatopera_faq_samples.json)，保存文件名为*chatopera\_faq\_samples.json*。

 **知识库文件格式**
 [![](https://user-images.githubusercontent.com/3538629/88005551-396ad380-cb3c-11ea-8318-e70615bec281.png)](https://user-images.githubusercontent.com/3538629/88005551-396ad380-cb3c-11ea-8318-e70615bec281.png)

在该示例文件中，用 JSON 数组的形式存储了 100 个问答对，字段含义如下：

keytyperequireddescriptioncategories\[string\]false分类名称，支持层级比如 `["一级", "二级"]`，服务器端自动创建对应分类enabledbooleantrue是否启用，代表该问答对导入后是否支持来访者检索poststringtrue问答对的标准问replies\[object\]true问答对的回答，数组长度大于 0, `content`是文本内容，`rtype`为`plain`表示`content`为纯文本; `rtype`为`html`表示`content`为富文本similarQuestions\[string\]false问答对里的相似问### 导入知识库

[](#导入知识库)

 **上传知识库文件**
 [ ![](https://user-images.githubusercontent.com/3538629/88005421-f7da2880-cb3b-11ea-9ceb-bb132652963d.png) ](http://bot.chatopera.com/)

选择*chatopera\_faq\_samples.json*，这时，会显示问答对列表，点击“提交”，在进度条完成后，知识库导入成功。

### 测试知识库

[](#测试知识库)

 **知识库测试窗口**
 [ ![](https://user-images.githubusercontent.com/3538629/48043965-5161be80-e1c4-11e8-99c6-53f36fc5e29a.png) ](http://bot.chatopera.com/)

**输入：** 下雨天在屋外烧电焊注意什么

确认得到回复。

### 获取*ClientId*和*Secret*

[](#获取clientid和secret)

集成机器人服务的方式是通过 SDK，每个机器人实例需要通过*ClientId*和*Secret*初始化，完成认证和授权。打开机器人【设置】页面，拷贝*ClientId*和*Secret*。

 **显示Secret**
 [ ![](https://user-images.githubusercontent.com/3538629/48044641-f4680780-e1c7-11e8-889e-01df6b0cbd7f.png) ](http://bot.chatopera.com/)

执行示例程序
------

[](#执行示例程序)

假设您已经:

1. 准备好**ClientId**和**Secret**了；
2. 安装了[chatopera/sdk](https://packagist.org/packages/chatopera/sdk)，

那么，可以用以下代码测试。

```