Skip to main content

はじめに

Square Cloud で を開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。

前提条件

  • Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
  • 有効な有料プラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。

プロジェクトの作成

ボットの認証と連携には、WhatsApp がインストールされ設定されている必要があります。アプリをお持ちでない場合は、WhatsApp 公式サイトからダウンロードしてセットアップしてください。
実装で WhatsApp Web バージョンのリモートパスにアクセスする必要がある場合は、次の技術的な手順に従ってください:
  1. wa-version リポジトリにアクセスします
  2. 目的のバージョンを選択します(常に最新版の使用を推奨します)
  3. 「Raw」をクリックしてファイルを表示します
  4. 生成された URL を後で使用するためにコピーします
設定された URL の例:

プロジェクトの開発

  1. Node.js の確認: Node.js がシステムにインストールされていることを確認してください。ない場合は、Node.js 公式サイトからダウンロードしてください。
  2. プロジェクトの初期化: 初期化コマンドを実行して、新しい Node.js プロジェクトをセットアップします:
Terminal
  1. 依存関係のインストール: ボットの機能に必要な基本ライブラリをインストールします:
Terminal
  1. メインファイルの作成: ボットの基本構造を含む index.js ファイルを作成します:
index.js

デプロイ

プロジェクトファイルの準備が完了したら、それらを Square Cloud にアップロードしてプロジェクトをホスティングできます。 そのためには、すべてのプロジェクトファイルを含む ZIP ファイルを作成してください。

ダッシュボード経由

1

アップロードページにアクセス

アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
2

環境を設定

zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
3

プロジェクトをデプロイ

最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。
Square Cloud へのアプリケーションのアップロード
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか?よくある原因と修正方法はトラブルシューティングガイドを参照してください。

CLI 経由

この方法を使用するには、プロジェクトのルートディレクトリに squarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。

設定ファイルガイド

アプリケーションの環境を定義する squarecloud.app 設定ファイルの作成方法を学びます。
1

CLI をインストール

まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:
すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:
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 フォルダをコミットすることをお勧めします。
  1. ライブラリをインストールします。
Terminal
  1. makeWASocketuseMultiFileAuthState を使ってセッションを読み込み・永続化する index.js ファイルを作成します。
index.js
Baileys はブラウザを必要としないため、Square Cloud 上の設定ファイルでは、上記の whatsapp-web.js の例よりも低い MEMORY の値を使用できます。
squarecloud.config

追加リソース

whatsapp-web.js を使用した WhatsApp ボット開発についてさらに理解を深めるには、whatsapp-web.js 公式ライブラリのドキュメントを参照してください。このドキュメントでは、詳細な技術ガイド、高度なチュートリアル、そして実装の可能性を最大化するための完全な API リファレンスを提供しています。

お問い合わせ

技術的な問題が解決しない場合は、専門のサポートチームがお手伝いします。お問い合わせいただければ、どのような問題でも喜んで解決をサポートいたします — サポートの質の高さも、開発者が Google と Trustpilot で Square Cloud に402 件のレビューで 4.9/5という評価をつけている理由の 1 つです。