WhatsApp Cloud API
Delphi/C++Builder에서 WhatsApp Cloud API를 통해 템플릿, 텍스트, 미디어, 인터랙티브 메시지를 전송하세요. 인바운드 이벤트를 위한 내장 HTTPS Webhook 리스너 포함.
Delphi/C++Builder에서 WhatsApp Cloud API를 통해 템플릿, 텍스트, 미디어, 인터랙티브 메시지를 전송하세요. 인바운드 이벤트를 위한 내장 HTTPS Webhook 리스너 포함.
WhatsApp Business Cloud API용 Delphi/C++Builder 클라이언트. HTTPS로 메시지를 보내고, 배달 및 상태 이벤트를 위한 Webhook 엔드포인트를 호스팅해요.
TsgcWhatsApp_Client
Windows, macOS, Linux, iOS, Android
Standard / Professional / Enterprise
WhatsAppOptions.Token과 PhoneNumberId를 설정하고, SendMessage... 메서드로 메시지를 보낸 다음, StartServer를 호출하고 OnMessageReceived를 연결해 응답을 수신하세요.
uses
sgcLibs;
var
WhatsApp: TsgcWhatsApp_Client;
begin
WhatsApp := TsgcWhatsApp_Client.Create(nil);
WhatsApp.WhatsAppOptions.PhoneNumberId := '123456789012345';
WhatsApp.WhatsAppOptions.Token := 'EAAG...';
WhatsApp.SendMessageText('+34666555444', 'hello from Delphi');
WhatsApp.OnMessageReceived := WhatsAppMessageReceived;
WhatsApp.StartServer;
end;
procedure TForm1.WhatsAppMessageReceived(Sender: TObject;
const aMessage: TsgcWhatsApp_Receive_Message;
var aMarkAsRead: Boolean);
begin
Memo1.Lines.Add(aMessage.RawMessage);
aMarkAsRead := True;
end;// include: sgcLibs.hpp
TsgcWhatsApp_Client *WhatsApp = new TsgcWhatsApp_Client(this);
WhatsApp->WhatsAppOptions->PhoneNumberId = "123456789012345";
WhatsApp->WhatsAppOptions->Token = "EAAG...";
WhatsApp->SendMessageText("+34666555444", "hello from Delphi");
WhatsApp->OnMessageReceived = WhatsAppMessageReceived;
WhatsApp->StartServer();
void __fastcall TForm1::WhatsAppMessageReceived(TObject *Sender,
TsgcWhatsApp_Receive_Message * const aMessage, bool &aMarkAsRead)
{
Memo1->Lines->Add(aMessage->RawMessage);
aMarkAsRead = true;
}HTTPS Cloud API 클라이언트와 내장 Webhook HTTPS 서버를 결합해 하나의 Delphi 프로세스가 발신 및 인바운드 트래픽을 모두 처리해요.
SendMessageText, SendMessageTemplate, SendMessageImage/Document/Audio/Video, SendMessageInteractiveList, SendMessageInteractiveButtons, SendMessageLocation 및 SendMessageContact가 Cloud API의 주요 콘텐츠 유형을 포괄해요.
컴포넌트는 자체 내장 HTTPS 서버(ServerOptions로 구성하는 StartServer/StopServer)를 시작해 Meta가 요구하는 검증 및 배달 webhook을 호스팅해요. OnMessageReceived와 OnMessageSent가 타입화된 이벤트를 전달하고, OnRawMessage는 가공되지 않은 JSON을 노출해요.
WhatsAppOptions.Token을 통해 OAuth Bearer 인증을 수행해요. webhook 검증 핸드셰이크는 ServerOptions.WebhookOptions.Token과 자동으로 대조되고, OnBeforeSubscribe가 앱에 구독을 수락하거나 거부할 마지막 기회를 줘요.
SendMessageTemplate은 명명/위치 매개변수와 언어 코드를 받고, 컴포넌트가 Meta가 요구하는 타입 구조를 생성해요.
로컬 파일 경로로 SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo, SendFileSticker 중 하나를 호출하면 컴포넌트가 UploadMedia를 통해 파일을 업로드하고 반환된 media id를 자동으로 참조해요. DownloadMedia와 DeleteMedia는 이미 Meta 서버에 있는 자산을 관리해요.
인바운드 webhook을 위해 ServerOptions.SSLOptions를 구성하세요 — Meta는 webhook이 TLS로 접근 가능할 것을 요구해요. 최상위 TLSOptions는 Graph API로의 아웃바운드 HTTPS 호출을 별도로 담당해요.
이 컴포넌트가 구현하는 API의 공식 출처.
컴포넌트 레퍼런스로 바로 이동하고, 실행 가능한 데모 프로젝트를 받고, 체험판을 다운로드하세요.
| 온라인 도움말 — API_Whatsapp 이 컴포넌트의 전체 속성, 메서드, 이벤트 레퍼런스. | 열기 | |
| 데모 프로젝트 — Demos\50.Other\05.WhatsApp 실행 가능한 예제 프로젝트. sgcWebSockets 패키지에 포함돼 있어요 — 아래에서 체험판을 다운로드하세요. | 열기 | |
| 기술 문서 (PDF) 이 컴포넌트의 기능, 빠른 시작, Delphi 및 C++ Builder 코드 샘플, 1차 출처 참고 자료. | 열기 | |
| 사용자 설명서 (PDF) 라이브러리의 모든 컴포넌트를 다루는 종합 설명서. | 열기 |