はじめに
Square Cloud で を開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。前提条件
- Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
- 有効な有料プラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。
プロジェクトの作成
ボットの認証と連携には、WhatsApp がインストールされ設定されている必要があります。アプリをお持ちでない場合は、WhatsApp 公式サイトからダウンロードしてセットアップしてください。WhatsApp Web のリモートパス設定
WhatsApp Web のリモートパス設定
実装で WhatsApp Web バージョンのリモートパスにアクセスする必要がある場合は、次の技術的な手順に従ってください:
- wa-version リポジトリにアクセスします
- 目的のバージョンを選択します(常に最新版の使用を推奨します)
- 「Raw」をクリックしてファイルを表示します
- 生成された URL を後で使用するためにコピーします
プロジェクトの開発
- Node.js の確認: Node.js がシステムにインストールされていることを確認してください。ない場合は、Node.js 公式サイトからダウンロードしてください。
- プロジェクトの初期化: 初期化コマンドを実行して、新しい Node.js プロジェクトをセットアップします:
Terminal
- 依存関係のインストール: ボットの機能に必要な基本ライブラリをインストールします:
Terminal
- メインファイルの作成: ボットの基本構造を含む
index.jsファイルを作成します:
index.js
デプロイ
プロジェクトファイルの準備が完了したら、それらを Square Cloud にアップロードしてプロジェクトをホスティングできます。 そのためには、すべてのプロジェクトファイルを含む ZIP ファイルを作成してください。ダッシュボード経由
1
アップロードページにアクセス
アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
2
環境を設定
zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
3
プロジェクトをデプロイ
最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。

4
アプリが稼働していることを確認
最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで
ウェブサイトや API をデプロイした場合は、ブラウザで
https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
CLI 経由
この方法を使用するには、プロジェクトのルートディレクトリにsquarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。
設定ファイルガイド
アプリケーションの環境を定義する
squarecloud.app 設定ファイルの作成方法を学びます。1
CLI をインストール
まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:
- Windows
- Linux, macOS, and WSL
2
認証
次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください:
3
プロジェクトをアップロード
最後に、CLI を使用してアプリケーションを Square Cloud にデプロイするには、次のコマンドを実行する必要があります:または、zip を手動で作成した場合は、次を使用できます:
4
アプリが稼働していることを確認
最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。ウェブサイトや API をデプロイした場合は、ブラウザで
https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
ボットのテスト
Square Cloud ダッシュボードでアプリケーションのログを確認してください。初回起動時には QR コード生成のログが表示され、スマートフォンの WhatsApp でスキャンすると、WhatsApp client successfully initialized! メッセージが表示されてセッションがアクティブになったことを確認できます。次に、リンクした WhatsApp アカウントに別の番号から !ping を送信し、pong - Bot working correctly! と返信されることを確認してください。
whatsapp-web.js の代わりに Baileys を使う
Baileys は、ヘッドレスブラウザを起動せずに、WebSocket 経由で直接 WhatsApp のマルチデバイス API に接続する代替ライブラリです。Chromium/Puppeteer のインスタンスを実行する必要がないため、whatsapp-web.js よりも大幅に少ない RAM で動作します。 Baileys にはフォールバックできるブラウザセッションがないため、再起動をまたいで独自の認証状態(auth フォルダ内のcreds.json ファイルと鍵)を永続化する必要があります。そうしないと、再デプロイのたびにリンクされたデバイスのセッションが失われ、QR コードを再度スキャンする必要があります。再デプロイ後もセッションを維持できるよう、Square Cloud Blob Storage のような永続ストレージに、その auth フォルダをコミットすることをお勧めします。
- ライブラリをインストールします。
Terminal
makeWASocketとuseMultiFileAuthStateを使ってセッションを読み込み・永続化するindex.jsファイルを作成します。
index.js
MEMORY の値を使用できます。
squarecloud.config

