Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】I built a lightweight WhatsApp gateway that stores nothing

2026年10月14日に「Dev.to」が公開したITニュース「I built a lightweight WhatsApp gateway that stores nothing」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

Whapprは、AIエージェントがWhatsAppと連携するための軽量なゲートウェイだ。公式APIの複雑さを避け、Dockerで簡単に導入できる。メッセージを保存せず、WebhookとREST APIでエージェントとの安全な対話を実現し、開発者がWhatsApp連携機能を素早く構築できる。

ITニュース解説

Whapprは、人工知能(AI)を活用した「エージェント」、例えばChatGPTのようなAIアシスタントや、特定のタスクを自動実行するプログラムが、人気のあるメッセージングアプリであるWhatsAppと簡単に連携できるように設計された軽量なツールだ。通常、エージェントをWhatsAppに接続するには、Metaが提供する公式のCloud APIを利用する方法がある。しかし、この公式APIは、ビジネス認証の厳しさ、メッセージテンプレートの必要性、会話ごとの料金体系など、開発の初期段階にあるプロトタイプや、企業内で使う小規模なアシスタントには負担が大きいという課題があった。

また、WAHAやOpenWAといった非公式ツールも存在するが、これらはWhatsApp全体の自動化や多数のアカウント管理を主な目的としており、エージェントがユーザーとスムーズに「会話」することに特化した設計ではない。そこで開発されたのがWhapprだ。Whapprは、エージェントがユーザーと自然にコミュニケーションを取るための機能に焦点を当て、不要な複雑さを排除することで、開発者が迅速にWhatsApp連携を実現できるように作られている。

Whapprは、自己ホスト型のDockerコンテナとして動作する。Dockerは、アプリケーションとその実行環境を一つにまとめる技術で、誰でも簡単にWhapprを自分のサーバーで動かせることを意味する。Whapprの仕組みは、普段皆が利用しているWhatsApp Webとよく似ており、専用のWhatsAppアカウントをQRコードでスキャンするだけで連携が完了する。

Whapprの主な役割は二つある。一つは「インバウンド」、つまりWhatsAppからのメッセージやリアクション、メッセージ編集といったすべてのイベントを、エージェントにリアルタイムで通知することだ。この通知は「ウェブフック」という仕組みを使って行われる。ウェブフックとは、特定のイベントが発生したときに、その情報を自動的に特定のURLへ送信する仕組みのことで、WhapprはHMAC署名という技術を使って、送られてくる情報が改ざんされていないことや、Whapprから送られた正規のものであることを保証し、セキュリティを確保している。もう一つは「アウトバウンド」、エージェントがユーザーからのメッセージに対して返信する際に、WhapprのREST APIを通じてその返信内容をWhatsAppへ送ることだ。REST APIは、プログラム間でデータをやり取りするための標準的な方法で、このAPIもトークンで保護されている。

Whapprの設計思想で最も重要なのは、一切のデータをデータベースに保存しない「ステートレス」な点だ。メッセージはWhapprを通過するだけで、その内容はエージェント自身が記憶し、管理する。これにより、プライバシーが保護され、エージェントは自分自身の記憶を完全にコントロールできる。また、エージェントがユーザーと自然に会話できるよう、「入力中…」の表示、メッセージの既読表示、引用返信、さらには音声メモの送受信といった機能も組み込まれている。WhatsAppのステータス更新やグループ管理、支払い、通話といった機能は意図的に省かれており、エージェントとの会話に必要な機能に絞り込まれている。

Whapprの導入は非常に簡単で、Dockerコマンドでゲートウェイを起動し、専用のWhatsApp番号をQRコードでペアリングするだけで、わずか数分で準備が整う。エージェント側では、Whapprから送られてくるウェブフックを受け取るプログラムを作成する。このプログラムは、まずウェブフックの署名を検証し、メッセージが正当なものであることを確認する。そして、メッセージを受け取ったらすぐにWhapprに「受け取った」という応答を返すことが重要だ。これにより、後続のメッセージ処理が滞るのを防ぎ、イベントが順番通りに処理されることを保証する。エージェントが返信を生成している間、WhapprはWhatsApp上で「入力中…」という表示を維持し、ユーザーにエージェントが準備中であることを伝える。返信が完成したら、エージェントはWhapprのAPIを通じてメッセージを送信する。

Whapprは、エージェントの能力をさらに高めるための便利な機能も提供している。例えば、音声メッセージをBlob形式でダウンロードし、音声認識サービスに渡すことで内容をテキスト化できる。また、テキストから音声メモを作成して返信することも可能だ。セキュリティの観点からは、エージェントが返信する際に、特定のチャット(会話)にのみメッセージを送るように制限する機能が用意されている。これにより、悪意のある入力(プロンプトインジェクション)によってエージェントが意図せず他のユーザーにメッセージを送ってしまうといった問題を未然に防げる。さらに、エージェントが受け取るウェブフックのイベントタイプや、通知対象のチャットをWhappr側でフィルタリングすることで、エージェントの負荷を軽減し、より効率的な運用が可能になる。

WhatsAppと連携する非公式ツールはWhappr以外にもWAHAやOpenWAがあるが、それぞれ異なる目的と強みを持っている。WAHAは、多数のWhatsAppアカウントを効率的に管理したい場合や、ブラウザを必要としないエンジンで運用したい場合、N8Nのような自動化ツールと連携したい場合に適している。OpenWAは、メッセージ履歴を保存するデータベース機能、管理ダッシュボード、複数のプログラミング言語向けSDK、独自のサーバー機能など、より広範なWhatsAppプラットフォームを構築したい場合に選択肢となる。一方、Whapprは、TypeScriptを使用する開発者が、シンプルで、データベースを持たず、メッセージを保存しない、プライバシーを重視したゲートウェイを通じて、特定のエージェントを一つのWhatsAppアカウントに連携させたい場合に最適だ。

しかし、これらの非公式ツールを利用する際にはいくつかの注意点がある。Whapprを含むこれらのツールは、WhatsApp Webの仕組みを利用しているため、Metaの公式APIとは異なり、利用規約に違反したと判断された場合、連携しているWhatsAppアカウントが一時的または永久的に利用停止(BAN)されるリスクがある。そのため、業務で利用する場合は公式APIを検討し、Whapprを利用する際は専用の番号を用意し、相手がメッセージを期待している場合のみ利用するといった慎重な運用が求められる。また、Whapprのウェブフックは一度しか送信されず、自動での再試行機能がないため、エージェント側のウェブフックハンドラーは堅牢に設計し、メッセージを確実に処理する必要がある。さらに、Whapprは内部でウェブブラウザの技術(Chromium)を使用するため、それなりのメモリ(RAM)を消費することを考慮し、サーバーリソースを適切に計画することが重要だ。現在はまだバージョン1.0未満で活発に開発が続いているため、将来的に機能の変更や互換性のない更新が含まれる可能性がある。安定した運用のためには、Dockerイメージやnpmパッケージの正確なバージョンを固定して利用することが推奨される。

関連コンテンツ

関連IT用語