WhatsApp Cloud API

Delphi / C++Builder から WhatsApp Cloud API を介してテンプレート、テキスト、メディア、インタラクティブメッセージを送信できます。受信イベント用の組み込み HTTPS Webhook リスナーも備えています。

TsgcWhatsApp_Client

WhatsApp Business Cloud API 向けの Delphi / C++Builder クライアントです。HTTPS でメッセージを送信し、配信およびステータスイベント用の Webhook エンドポイントをホストします。

コンポーネントクラス

TsgcWhatsApp_Client

プロトコル

WhatsApp Cloud API

プラットフォーム

Windows, macOS, Linux, iOS, Android

エディション

Standard / Professional / Enterprise

トークンを設定し、メッセージを送信し、Webhook をホストする

AccessToken と PhoneNumberId を設定し、Webhook サーバーを TsgcWebSocketHTTPServer にバインドしたうえで、送信は SendMessage で、応答は OnInboundMessage で扱います。

uses
  sgcLibs;

var
  WA: TsgcWhatsApp_Client;
begin
  WA := TsgcWhatsApp_Client.Create(nil);
  WA.CloudOptions.AccessToken     := 'EAAG...';
  WA.CloudOptions.PhoneNumberId   := '123456789012345';
  WA.CloudOptions.VerifyToken     := 'my-webhook-secret';

  WA.OnInboundMessage := procedure(Sender: TObject;
    const aFrom, aText: string)
  begin
    Memo1.Lines.Add(aFrom + ': ' + aText);
  end;

  WA.Active := True;

  WA.SendTextMessage('+34666555444', 'hello from Delphi');
end;
// uses: sgcLibs
TsgcWhatsApp_Client *WA = new TsgcWhatsApp_Client(this);
WA->CloudOptions->AccessToken   = "EAAG...";
WA->CloudOptions->PhoneNumberId = "123456789012345";

WA->Active = true;
WA->SendTextMessage("+34666555444", "hello from Delphi");

主な構成

HTTPS Cloud API クライアントと組み込みの Webhook HTTPS サーバーを組み合わせ、単一の Delphi プロセスで送受信トラフィックの両方を処理できます。

メッセージ送信

SendTextMessageSendTemplateMessageSendMediaMessageSendInteractiveMessageSendLocationMessageSendContactMessage が Cloud API の主要なコンテンツタイプを網羅します。

Webhook リスナー

コンポーネントは TsgcWebSocketHTTPServer を組み込み、Meta が要求する検証および配信用 Webhook をホストします。OnInboundMessageOnStatusUpdate が型付きイベントを配信します。

認証

CloudOptions.AccessToken による OAuth Bearer 認証を行います。初回の Webhook GET プローブ時には CloudOptions.VerifyToken に対する verify-token チェックが自動的に実行されます。

テンプレートパラメーター

SendTemplateMessage は名前付き / 位置パラメーターおよび言語コードを受け付け、コンポーネントが Meta の要求する型付き構造を構築します。

メディアアップロード

ローカルファイルパスで SendMediaMessage を呼び出すと、コンポーネントが Cloud API の複数ステップのメディアアップロード (アップロード → media-id 取得 → 送信時に参照) を処理します。

TLS で保護された Webhook

組み込みサーバーの SSLOptions を HTTPS 用に設定してください。Meta は Webhook が TLS 経由で到達可能であることを要求します。証明書ローテーション時のポート再バインドはウォッチドッグが処理します。

仕様とリファレンス

本コンポーネントが実装する API の信頼できる一次情報源です。

ドキュメントとデモ

コンポーネントリファレンスへのディープリンク、すぐに実行可能なデモプロジェクト、体験版のダウンロードを提供します。

オンラインヘルプ — API_Whatsapp 本コンポーネントのプロパティ、メソッド、イベントの完全なリファレンスです。
デモプロジェクト — Demos\50.Other\05.WhatsApp すぐに実行可能なサンプルプロジェクトです。sgcWebSockets パッケージに同梱されています。以下から体験版をダウンロードしてください。
技術ドキュメント (PDF) 本コンポーネントに特化した機能解説、クイックスタート、Delphi および C++ Builder のコードサンプル、一次情報源リファレンスを収録しています。
ユーザーマニュアル (PDF) ライブラリ内のすべてのコンポーネントを網羅した総合マニュアルです。

WhatsApp メッセージを送信する準備はできましたか?

体験版をダウンロードして、WhatsApp Cloud API を Delphi アプリケーションに統合しましょう。