chatopera / sdk
Chatopera企业聊天机器人
Requires
- php: >=5.3.3
Requires (Dev)
README
低代码或无代码方式定制智能对话机器人!
Chatopera 提供聊天机器人开发者平台,Chatopera Php SDK 用于在 PHP 应用中集成 聊天机器人服务。
本教程介绍如何使用 Chatopera 机器人开发者平台的 PHP SDK 与机器人进行集成,阅读本教程需要 20 分钟时间。
安装
composer 是一个优秀的 PHP 项目包管理工具,Chatopera PHP SDK 可通过 composer 直接下载,包文件发布在 packagist。
composer require chatopera/sdk
【注意】如果项目不使用 composer 管理,那么可直接下载安装 Chatbot.php 文件到项目中。
创建机器人
点击“立即使用”
第一登录输入“邮箱”和“密码”,点击“回车键”,完成账户创建。
创建聊天机器人
点击“创建机器人”,并填入下面各项:
【提示】其它项如兜底回复,问候语可以在创建后,设置页面修改。
下载知识库文件
下载知识库示例文件 chatopera_faq_samples.json,保存文件名为 chatopera_faq_samples.json。
在该示例文件中,用 JSON 数组的形式存储了 100 个问答对,字段含义如下:
导入知识库
选择 chatopera_faq_samples.json,这时,会显示问答对列表,点击“提交”,在进度条完成后,知识库导入成功。
测试知识库
输入: 下雨天在屋外烧电焊注意什么
确认得到回复。
获取 ClientId 和 Secret
通过 SDK 集成机器人服务的方式是通过 SDK,每个机器人实例需要通过 ClientId 和 Secret 初始化,完成认证和授权。打开机器人【设置】页面,拷贝 ClientId 和 Secret。
执行示例程序
假设您已经
-
准备好 ClientId 和 Secret 了;
-
安装了 chatopera/sdk,
那么,可以用以下代码测试。
<?php include_once __DIR__ . "/vendor/autoload.php"; $appId = "YOUR CLIENT ID"; $secret = "YOUR SECRET"; $chatbot = new Chatopera\SDK\Chatbot($appId, $secret); print_r($chatbot->command("GET", "/"));
接口概述
各接口的详细描述请访问 开发者平台文档中心。
同时提供 PHP Docs 为使用参考。
贡献
单元测试
./vendor/bin/phpunit --bootstrap vendor/autoload.php test/ChatbotTest.php
卸载
从项目中卸载 SDK。
composer remove chatopera/sdk
更多 SDK
开源许可协议
版权 (2018-2021) 北京华夏春松科技有限公司
版权 2018-2021, 北京华夏春松科技有限公司. 所有权利保留。此软件和相关文档在许可协议下提供,包含使用和披露的限制,并受知识产权法保护。除非您的许可协议明确允许或法律允许,否则您不得使用、复制、复制、翻译、广播、修改、许可、传输、分发、展示、表演、发布或以任何方式显示任何部分,形式或手段。除非法律要求用于互操作性,否则禁止对该软件进行反向工程、反汇编或反编译。