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,每个机器人实例需要通过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
开源许可协议
Copyright (2018-2021) 北京华夏春松科技有限公司
Copyright 2018-2021, 北京华夏春松科技有限公司. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.