概要

Cloudflare Workers をプラットフォームに採用した「微信客服 AI 助手（wxkfbot）」は、企業向け微信（WeCom）客服チャットを OpenAI GPT と連携して自動応答するためのサーバーレス実装です。微信から届くメッセージの受信・暗号化/復号化処理を備え、Cloudflare KV を用いて会話履歴を保持。導入は比較的シンプルで、Cloudflare アカウント、WeCom（微信企業号）側の設定、OpenAI API キーを揃えれば動作します。低遅延で高可用、メッセージ処理と AI 応答を一元化したソリューションを短期間で展開できます。

リポジトリの統計情報

スター数: 23
フォーク数: 7
ウォッチャー数: 23
コミット数: 4
ファイル数: 16
メインの言語: JavaScript

主な特徴

Cloudflare Workers ベースのサーバーレス設計でインフラ管理不要
OpenAI GPT と統合し自然言語での自動応答を実現
WeCom（微信企業號）向けのメッセージ受信・暗号化/復号化を内蔵
Cloudflare KV でセッション／会話履歴を永続化、ステートフルな応答が可能

技術的なポイント

wxkfbot は Cloudflare Workers をランタイムに採用することで低レイテンシかつスケーラブルなエンドポイントを実現しています。WeCom 側との双方向通信に必要なメッセージの署名検証と暗号化/復号化（プッシュ通知の検証やメッセージ体の取り扱い）を組み込み、外部サーバーや常時稼働のコンテナを必要としません。OpenAI API との連携は HTTP ベースで行い、受信したユーザーのメッセージをプロンプトとして送信、得られた応答を整形して WeCom に返信します。会話の文脈保持は Cloudflare KV に保存されたセッションデータで実現しており、短期的な会話履歴をロードして文脈-aware な応答が可能です。設定は主に Cloudflare Workers の環境変数（OpenAI キーや WeCom の鍵など）と WeCom 側のコールバック URL 設定で完結します。デプロイは Cloudflare のワンボタンサポートや wrangler 等で自動化でき、サーバー管理やコスト監視の手間を削減します。本リポジトリは JavaScript ベースで軽量に設計されており、Workers のイベントハンドラ、KV 操作、外部 API 呼び出し、メッセージ暗号化ロジックが中心的な実装ポイントです。

プロジェクトの構成

主要なファイルとディレクトリ：

.gitignore: file
README.md: file
WECOM.md: file
clients.js: file
config.js: file
index.js: file
encrypt.js: file
kv.js: file
openai.js: file
package.json: file
wrangler.toml: file
LICENSE: file
scripts/: directory
docs/: directory …他 11 ファイル

各ファイルの役割（簡潔に）

index.js: Workers のエントリポイント。リクエスト受信、ルーティング、レスポンス生成を行う。
clients.js: WeCom や OpenAI など外部 API クライアントのラッパーを収める。
config.js: 環境変数や設定値の管理。KV 名や API キーなどを参照する。
encrypt.js: WeCom メッセージの暗号化/復号化や署名検証ロジック。
kv.js: Cloudflare KV への読み書きユーティリティ（セッション保存など）。
openai.js: OpenAI API 呼び出しとプロンプト管理のユーティリティ。
WECOM.md: WeCom 側の設定手順や webhook 設定に関するドキュメント。
wrangler.toml / package.json: デプロイ設定と依存管理。

導入の流れ（概要）

Cloudflare アカウントを準備し Workers と KV を設定
WeCom（微信企業號）で客服アカウントと webhook を有効にする（WECOM.md を参照）
OpenAI API キーなど必要な環境変数を Cloudflare に登録
リポジトリをデプロイ（wrangler deploy または Cloudflare Deploy ボタン）
正常にイベント受信 → OpenAI 呼び出し → WeCom 返信が行われるか動作確認

まとめ

サーバーレスで手軽に WeCom 向け AI 客服を構築できる実用的なテンプレート。

リポジトリ情報：

名前: wxkfbot
説明: 説明なし
スター数: 23
言語: JavaScript
URL: https://github.com/bestK/wxkfbot
オーナー: bestK
アバター: https://avatars.githubusercontent.com/u/14979305?v=4

READMEの抜粋：

微信客服 AI 助手 (WxKF Bot)

基于 Cloudflare Worker 构建的微信客服 AI 聊天机器人，支持与 OpenAI GPT 模型对话。

功能特点

🚀 基于 Cloudflare Worker，无需服务器
🤖 集成 OpenAI GPT 模型，支持智能对话
💬 支持微信客服消息接收和回复
🔐 内置完整的消息加解密功能
💾 使用 Cloudflare KV 存储会话历史
⚡ 低延迟，高可用

快速开始

1. 配置要求

Cloudflare 账号
微信企业号客服配置
OpenAI API 密钥
加密服务部署…

微信客服 AI 助手 (wxkfbot)