Cloudflare-WX-APIはGitHubでホストされているオープンソースプロジェクトで、開発者がWeChat Service NumberとCloudflareプラットフォームを組み合わせて、CAPTCHAログイン、コードスイープログイン、Large Language Model(LLM)に基づくインテリジェントな自動返信機能を実現することを目的としています。Tinger-Xによって開発されたこのプロジェクトは、個人開発者や小規模チームがWeChat Service Numberの自動化機能を迅速に構築するのに適しています。このプロジェクトはCloudflare Workersを使用して効率的なサーバーサイドのサポートを提供し、WeChat APIと組み合わせてユーザー認証とメッセージ処理を実現する。LLMを統合することで、開発者はインテリジェントなメッセージ返信を実現し、ユーザーとのインタラクション体験を向上させることができる。プロジェクト全体はシンプルで使いやすく、オープンなコードと明確なドキュメントで、一定のプログラミングの基礎があるユーザーに適していることを目指している。
機能一覧
- WeChatサービス番号アクセス:WeChatサービス番号の迅速な設定をサポートし、完全なAPIドッキング。
- CAPTCHAログイン:WeChatベースのCAPTCHAログイン機能を提供し、ユーザー認証プロセスを簡素化します。
- スキャンコードログイン:WeChatのスキャンコードによるログインをサポートし、様々な場面での迅速な本人確認に適している。
- インテリジェントな自動応答:文脈に応じたインテリジェントなメッセージ返信のための大規模言語モデリング(LLM)の統合。
- Cloudflare Workers Support: Cloudflareのサーバーレスアーキテクチャを活用し、効率的で低コストのデプロイを実現。
- オープンソースコード:開発者が機能をカスタマイズできるように、完全なコードとドキュメントが提供されています。
- 軽量コンフィギュレーション:初期設定はシンプルなコンフィギュレーション・ファイルで行うことができる。
ヘルプの使用
インストールと設定
Cloudflare-WX-APIを利用するには、まず以下の環境を用意する必要があります:
- GitHubアカウントアクセス
https://github.com/Tinger-X/cloudflare-wx-api
Fork "または "Clone "をクリックして、プロジェクトをローカルにダウンロードする。 - クラウドフレアアカウントCloudflare アカウントに登録し、Workers 機能を有効にします。Cloudflare ダッシュボードにログインし、「Workers」ページに移動して新しいプロジェクトを作成します。
- WeChat開発者プラットフォームWeChatパブリックプラットフォームアカウントに登録し、サービス番号を作成し、AppIDとAppSecretを取得します。
- Node.js環境プロジェクトの実行とテストのために、Node.js(推奨バージョン16以上)がローカルにインストールされていることを確認する。
インストール手順::
- プロジェクトをローカルにクローンする:
git clone https://github.com/Tinger-X/cloudflare-wx-api.git cd cloudflare-wx-api
- 依存関係をインストールします:
npm install
- 環境変数を設定する:
- プロジェクトのルート・ディレクトリに
.env
ファイルに以下を追加する:WECHAT_APP_ID=你的微信AppID WECHAT_APP_SECRET=你的微信AppSecret CLOUDFLARE_API_TOKEN=你的Cloudflare API令牌 LLM_API_KEY=你的LLM服务API密钥
- プロジェクトのルート・ディレクトリに
- Cloudflare Workersにデプロイする:
- Wrangler CLIツール(クラウドフレアのコマンドラインツール)を使ってログインします:
npx wrangler login
- 配備プロジェクト:
npx wrangler deploy
- デプロイが完了すると、WranglerはURLを返します。
https://your-project.workers.dev
マイクロソフトのサービス番号設定用)。
- Wrangler CLIツール(クラウドフレアのコマンドラインツール)を使ってログインします:
WeChatサービス番号の設定::
- WeChat Public Platformにログインし、"Development - Basic Configuration "に進みます。
- Server Configuration "で、以下のフィールドに入力する:
- サーバーアドレス(URL)Cloudflare Workersが提供するURLを記入してください。
- トークンプロジェクト・コンフィギュレーション・ファイルの設定をカスタマイズします。
- メッセージの暗号鍵と復号鍵ランダムキーを生成して保存する。
- 設定を送信し、サーバーがWeChatサービス番号に正常に接続されていることを確認します。
機能 操作の流れ
CAPTCHAログイン
- ユーザーはフロントエンドでログイン要求をトリガーし、システムはユーザーのWeChatに認証コードを送信する。
- ユーザーは検証コードを入力し、プロジェクトはパスする。
/verify
エンドポイントのチェックサム検証コード。 - 認証に成功すると、その後の操作のためにユーザー認証情報(OpenIDなど)が返される。
- 操作例:ユーザーがあなたのウェブページにアクセスし、「WeChatログイン」をクリックし、受け取った認証コードを入力すると、システムが自動的に本人確認を完了します。
スワイプでログイン。
- このプロジェクトは、ユーザーがWeChatを使ってスキャンするダイナミックなQRコードを生成する。
- スキャン後、WeChatサーバーはプロジェクトが設定したURLをコールバックし、ユーザーID情報を渡す。
- システムはユーザーログインを完了するためにコールバックを処理します。
- 操作例:ユーザーがウェブページのQRコードをスキャンすると、WeChatは認証ページにジャンプし、確認後自動的にログインする。
インテリジェント自動応答
- ユーザーがWeChatのサービス番号にメッセージを送信すると、Cloudflare Workersがそのメッセージを処理する。
- プロジェクトは、LLM API(OpenAIや他のモデルなど)を呼び出して、文脈に応じた応答を生成する。
- 返信はWeChat API経由でユーザーに返される。
- 操作例:ユーザーが "明日の天気は?"と送信すると、サービス番号は "都市名を入力してください。と送信すると、サービス番号は「都市名を入力してください。
カスタマイズ
デベロッパーは、以下を変更することができる。 index.js
ファイルでカスタムロジックを追加することができます。例えば、メッセージフィルタリング、キーワードトリガー、多言語サポートなどを追加できます。このプロジェクトはモジュール式の拡張をサポートしており、開発者は要求に応じて他のAPIにアクセスすることができます。
ほら
- 安全性を確保する。
.env
ファイル内の鍵は公開されず、公開リポジトリへのアップロードは避けられる。 - テスト中にコンポーネントを調整する使用
npx wrangler dev
Workers の機能をローカルでテストする。 - 文書参照詳細なドキュメントは、プロジェクトのGitHubページにあります。
README.md
歌で応えるDOCS
フォルダー - アップデート・メンテナンスCloudflare WorkersとWeChat API間のバージョン互換性を定期的にチェックしてください。
アプリケーションシナリオ
- 個人開発者がWeChatサービス番号を素早く構築
個人の開発者はCloudflare-WX-APIを使用することで、複雑なサーバー設定をすることなく、WeChatサービス番号ログインとメッセージ返信機能を素早く実装することができ、迅速なプロトタイピングに適しています。 - Eコマース・プラットフォームのユーザー認証
電子商取引ウェブサイトは、スキャンコード・ログインや検証コード・ログインによって、ユーザー認証プロセスを簡素化し、ユーザー体験を向上させ、登録の敷居を下げることができる。 - インテリジェント・カスタマー・サービス・システム
企業はインテリジェント・オートレスポンダーを使って24時間365日対応のカスタマーサービス・システムを構築し、よくある質問に答えたり、手作業によるカスタマーサービスにかかる負担を軽減したりすることができます。 - 教育またはコミュニティ交流プラットフォーム
オンライン教育やコミュニティ・プラットフォームは、WeChatのサービス番号を通じてユーザーと対話し、コースのリマインダーやイベント通知をプッシュし、LLMを通じてパーソナライズされた応答を提供することができる。
品質保証
- サーバーが必要ですか?
必要ない。このプロジェクトはCloudflare Workersをベースにしているため、従来のサーバーは必要なく、導入も簡単で安価です。 - どのような大きな言語モデルに対応していますか?
このプロジェクトは、OpenAIやAnthropicなど、APIを提供するあらゆるLLMをサポートしている。.env
APIキーを - マイクロソフトのコールバックをデバッグするには?
利用するnpx wrangler dev
ローカルサーバーを起動し、WeChatパブリックプラットフォームテスト番号と連動してコールバック機能を検証する。 - 多言語での対応に対応していますか?
中国語応答のデフォルトサポート、開発者は多言語LLMまたは翻訳APIにアクセスするようにコードを変更することができます。