mcpField
W
whapi

whapi

github.com/whapi-cloud開発3170 回インストール30 週間前に更新
リポジトリ

whapi について

WHAPI.cloud で WhatsApp 連携を構築する AI エージェント向けの実用ガイドです。メッセージ、グループ、チャンネル、コミュニティ、Webhook のルールに加え、whapi-mcp の状態確認とツールスキーマの参照方法を示します。

主な機能

  1. 017 分野の API 利用ルール
  2. 02MCP のセットアップと接続状態の確認
  3. 03メッセージ送信と Webhook の手順
  4. 04グループ、チャンネル、コミュニティの管理
  5. 05パラメーターを推測しないためのルール

活用シーン

  1. 01Cursor や Claude Desktop での WHAPI MCP 設定
  2. 02WhatsApp のメッセージ機能や一斉送信システムの構築
  3. 03Webhook によるメッセージ受信の設定
  4. 04WHAPI API の予期しない動作の調査

MCP 対応

タスク開始前に whapi-mcp を確認し、その状態に応じて接続、ペアリング、認証の問題に対処するよう求めます。whapi-mcp は API メソッドを提供し、このスキルは利用方法とパラメーター検証のルールを補います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/whapi-cloud/whapi-whatsapp-api-skill --skill whapi

インストール後、Claude Code で/whapiを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

AGENTS.md
CLAUDE.md
README.md
references/
_contributing.md
_sections.md
_template.md
channels-management.md
communities-management.md
core-auth.md
core-chat-id.md
core-mcp-setup.md
groups-management.md
msg-interactive.md
msg-media.md
msg-text.md
msg-type-selection.md
pattern-bot.md
pattern-broadcast.md
recv-history.md
recv-webhooks.md

詳細

WHAPI.cloud WhatsApp API — エージェントスキル

WHAPI.cloud を使用して WhatsApp 連携を構築する AI エージェント向けの実践ガイドです。 最も頻繁に発生するミスを防ぎ、最もよく使われる API 機能を網羅するため、7 つのカテゴリにわたるルールを優先度順にまとめています。

前提条件 — MCP のセットアップ確認

タスクを開始する前に、whapi-mcp MCP サーバーが利用可能であることを確認してください。

  1. checkHealth ツールの呼び出しを試みます。
  2. 正常に応答した場合は、続行します。
  3. ツールが見つからない場合、MCP サーバーはインストールされていません。 インストール手順をユーザーに案内してください：references/core-mcp-setup.md。
  4. ツールが 404（「Channel not found」）を返した場合、トークンが無効か、チャネルが存在しません。ユーザーに次の項目を案内してください：references/core-mcp-setup.md の 「Token is Missing or Invalid」セクション。
  5. ツールが応答した場合、レスポンスの status.text を確認します。
status.text意味対応
AUTH接続済みで、動作しています続行
QRQR コードのスキャン待ちチャネルのダッシュボードを開き、QR コードをスキャンしてペアリングします
INITサーバーの初期化中40～50 秒待ちます。解消しない場合は WHAPI サポートに問い合わせてください
LAUNCHWhatsApp アカウントに接続中数秒待ちます。解消しない場合は WHAPI サポートに問い合わせてください
STOPチャネルが無効化されていますpanel.whapi.cloud/dashboard でサブスクリプションの状態を確認します
SYNC_ERROR同期に失敗していますチャネルからログアウトして再接続します。解決するまで GET リクエストは失敗します

QR のペアリングについては、references/core-mcp-setup.md の「Where to Get Your API Token」セクションを参照してください。

適用する場面

以下の場合に、このガイドラインを参照してください。

  • Cursor、Claude Desktop、または MCP 互換クライアントで WHAPI MCP をセットアップする
  • メッセージ（テキスト、メディア、インタラクティブメッセージ、投票）を送信する
  • Webhook 経由で受信メッセージを受け取る
  • グループ、チャネル（ニュースレター）、またはコミュニティを管理する
  • ボット、ブロードキャストシステム、または CRM 連携を構築する
  • 想定外の API の動作をトラブルシューティングする

API の対象範囲と MCP のフォールバック

このスキルでは、最もよく使われる操作を取り上げ、よくあるミスを防ぎます。 WHAPI のすべてのエンドポイントを説明しているわけではありません。

必要な操作がどのリファレンスファイルにも記載されていない場合：

  1. 利用可能な MCP ツールを確認します。whapi-mcp はすべての API メソッドを直接公開しています。
  2. エンドポイントにかかわらず、Chat ID の形式には core-chat-id.md のルールを適用します。
  3. エンドポイントにかかわらず、認証には core-auth.md のルールを適用します。
  4. MCP ツールのスキーマに記載されたパラメーター名のみを使用し、パラメーターを作り出さないでください。
  5. 不明な点がある場合は、WHAPI API Reference と照合します。

利用可能なメソッドの情報源は MCP です。正しい使用パターンとハルシネーション防止ルールの情報源は、このスキルです。

優先度別のルールカテゴリ

優先度カテゴリ影響度プレフィックス
1基本概念重大core-
2メッセージング重大msg-
3受信重大recv-
4グループ高groups-
5チャネル高channels-
6コミュニティ中communities-
7パターン高pattern-

使い方

詳細な説明とコード例については、各リファレンスファイルをお読みください。

1. references/core-mcp-setup.md      ← install and configure the MCP first
2. references/core-chat-id.md        ← understand Chat ID formats (most common error)
3. references/core-auth.md           ← authenticate direct REST calls
4. references/msg-type-selection.md  ← choose the right send tool
5. references/recv-webhooks.md       ← set up receiving messages

各リファレンスファイルには、次の内容が含まれています。

  • 重要な理由（1～2文）
  • 解説付きの誤った例
  • 解説付きの正しい例
  • ハルシネーション防止チェックリスト（存在しないパラメーター）
  • WHAPI 固有の注意事項

リファレンス

コメント

Markdown 対応