WhatsApp Cloud API 클라이언트 — sgcWebSockets

한눈에 보기

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 프로세스가 발신 및 인바운드 트래픽을 모두 처리해요.

메시지 전송

SendTextMessage, SendTemplateMessage, SendMediaMessage, SendInteractiveMessage, SendLocationMessage, SendContactMessage가 Cloud API의 주요 콘텐츠 유형을 포괄해요.

Webhook 리스너

컴포넌트는 Meta가 요구하는 검증 + 배달 webhook을 호스팅하기 위해 TsgcWebSocketHTTPServer를 내장해요. OnInboundMessage와 OnStatusUpdate가 타입화된 이벤트를 전달해요.

인증

CloudOptions.AccessToken을 통한 OAuth Bearer 인증. 첫 webhook GET 요청 시 CloudOptions.VerifyToken에 대한 verify-token 검사가 자동으로 수행돼요.

템플릿 매개변수

SendTemplateMessage는 명명/위치 매개변수, 언어 코드를 받고 컴포넌트가 Meta가 요구하는 타입 구조를 설정해요.

미디어 업로드

로컬 파일 경로로 SendMediaMessage를 호출하면 컴포넌트가 다단계 Cloud API 미디어 업로드(업로드 → media-id 획득 → 전송 시 참조)를 처리해요.

TLS 보안 Webhook

HTTPS를 위해 내장 서버의 SSLOptions를 구성하세요 — Meta는 Webhook이 TLS로 접근 가능할 것을 요구해요. WatchDog는 인증서 회전 시 포트 재바인딩을 처리해요.

표준

사양 및 참고 자료

이 컴포넌트가 구현하는 API의 공식 출처.

리소스

문서 및 데모

컴포넌트 레퍼런스로 바로 이동하고, 실행 가능한 데모 프로젝트를 받고, 체험판을 다운로드하세요.

	온라인 도움말 — API_Whatsapp 이 컴포넌트의 전체 속성, 메서드, 이벤트 레퍼런스.	열기
	데모 프로젝트 — Demos\50.Other\05.WhatsApp 실행 가능한 예제 프로젝트. sgcWebSockets 패키지에 포함돼 있어요 — 아래에서 체험판을 다운로드하세요.	열기
	기술 문서 (PDF) 이 컴포넌트의 기능, 빠른 시작, Delphi 및 C++ Builder 코드 샘플, 1차 출처 참고 자료.	열기
	사용자 설명서 (PDF) 라이브러리의 모든 컴포넌트를 다루는 종합 설명서.	열기