WhatsApp 云 API

从 Delphi/C++ Builder 通过 WhatsApp 云 API 发送模板、文本、媒体和交互式消息。内置 HTTPS Webhook 监听器用于接收入站事件。

TsgcWhatsApp_Client

WhatsApp 商业云 API 的 Delphi/C++ Builder 客户端。通过 HTTPS 发送消息,托管 Webhook 端点以接收送达和状态事件。

组件类

TsgcWhatsApp_Client

支持平台

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 云 API 客户端与内置 Webhook HTTPS 服务器结合,使单个 Delphi 进程处理出站和入站流量。

Send messages

SendTextMessageSendTemplateMessageSendMediaMessageSendInteractiveMessageSendLocationMessageSendContactMessage 涵盖主要云 API 内容类型。

Webhook 监听器

组件内嵌 TsgcWebSocketHTTPServer,用于托管 Meta 所需的验证 + 送达 webhook。OnInboundMessageOnStatusUpdate 传递类型化事件。

身份验证

通过 CloudOptions.AccessToken 进行 OAuth Bearer 身份验证;首次 webhook GET 探测时,自动对 CloudOptions.VerifyToken 进行令牌验证检查。

模板参数

SendTemplateMessage 接受命名/位置参数和语言代码,组件设置 Meta 所需的类型化结构。

媒体上传

当您使用本地文件路径调用 SendMediaMessage 时,组件处理多步骤云 API 媒体上传(上传 → 获取 media-id → 在发送中引用)。

TLS 安全 Webhook

配置内嵌服务器的 SSLOptions 以启用 HTTPS——Meta 要求 Webhook 可通过 TLS 访问。WatchDog 处理证书轮换时的端口重新绑定。

规范与参考

本组件实现的 API 的权威来源。

文档与演示

直接访问组件参考文档,获取即用型演示项目,并下载试用版。

在线帮助 — API_Whatsapp 本组件的完整属性、方法和事件参考。
演示项目 — Demos\50.Other\05.WhatsApp 即用型示例项目,随 sgcWebSockets 包提供——请在下方下载试用版。
技术文档 (PDF) 本组件的功能介绍、快速入门、Delphi & C++ Builder 代码示例及主要来源参考。
用户手册 (PDF) 涵盖库中所有组件的综合手册。

准备好发送 WhatsApp 消息了吗?

下载免费试用版,将 WhatsApp 云 API 集成到您的 Delphi 应用程序中。