claytantor/apiai-smooch-docker

apiai-smooch-docker镜像说明

镜像概述

本镜像将API.ai（现Dialogflow）的自然语言处理能力与smooch.io的网站消息框架集成，包装为可直接部署的Docker容器，帮助网站快速实现与访客的智能聊天功能，无需复杂编程即可构建对话机器人。

核心功能

1. 数据驱动对话：依赖API.ai agent定义对话逻辑，无需额外代码开发
2. 自动Webhook配置：通过健康检查自动创建或验证Smooch的webhook端点
3. CLI测试工具：提供本地命令行工具，方便快速测试机器人对话效果
4. 灵活参数配置：通过外部配置文件自定义机器人名称、API密钥等参数

使用场景

• 网站访客智能咨询与自动回复
• 收集访客联系信息（如***）并引导后续沟通
• 快速搭建轻量级聊天机器人原型

配置说明

需在配置目录中放置smoochbot-apiai.properties文件，示例内容如下：

properties
# Smooch API凭证
SMOOCH_KEY_ID="你的Smooch密钥ID"
SMOOCH_SECRET="你的Smooch密钥"

# Webhook端点（替换为你的实际域名）
SMOOCH_WEBOOK_ENDPOINT="https://smoochbot.yourdomain.com/smooch/events"

# 机器人基础配置
SMOOCHBOT_NAME="smoochbot"
API_AI_TOKEN="你的API.ai令牌"
DEBUG="False"

部署示例

Docker Run命令

bash
docker run -t -d --name apiai-smooch-docker -v ${CONFIG_DIR}:/mnt/config -p 8079:8079 docker.xuanyuan.run/claytantor/apiai-smooch-docker:latest

初始化与验证

启动容器后，执行健康检查以完成webhook配置：

bash
curl http://localhost:8079/hc

返回{"message": "succeed"}表示初始化成功，容器日志将显示webhook创建信息。

CLI测试

使用本地CLI工具测试机器人对话（需安装Python）：

bash
python client-cli ./data/example_app_config.properties

输入消息与机器人交互，输入:q退出测试。

帮助链接

• Dronze官网：镜像开发团队
• Smooch REST API文档：Smooch接口参考
• API.ai REST API文档：API.ai对话接口参考