WhatsApp Business Platform의 클라우드 호스팅 버전을 사용하여 메시지를 전송하고 및 수신합니다. Cloud API를 사용하면 자체 서버 호스팅 비용 없이 WhatsApp Business API를 구현할 수 있으며, 비즈니스 메시징을 더 쉽게 확장할 수 있습니다. Cloud API는 초당 최대 80개의 메시지(텍스트 및 미디어 메시지 포함) 전송 및 수신을 지원합니다.
WhatsApp Business API를 사용하면 중대형 기업이 대규모로 고객과 소통할 수 있습니다. API를 사용하여, 기업은 수천 명의 고객을 상담원 또는 봇과 연결하는 시스템을 구축하여 프로그래밍 방식과 수동 통신을 모두 가능하게 할 수 있습니다. 또한, CRM 및 마케팅 플랫폼과 같은 수많은 백엔드 시스템과 API를 통합할 수 있습니다.
기업은 Cloud API에서 모든 새 기능을 더 빠르게 얻을 수 있습니다. 현재 WhatsApp Business Cloud API에는 WhatsApp Business API에서 사용 가능한 모든 기능이 포함되어 있습니다.
WhatsApp Cloud API의 유용한 기능:
테스트 번호를 사용하여 첫 번째 메시지를 송수신하려면 다음 단계를 완료하십시오:
1. Developer Assets 및 Platform Access 설정
Meta 앱 생성: developers.facebook.com > My Apps > Create App으로 이동하십시오. "Business" 유형을 선택하고 화면의 안내를 따르십시오.
App Dashboard에서 WhatsApp에 연결하려는 앱을 클릭하십시오. 아래로 스크롤하여 "WhatsApp" 제품을 찾고 Set up을 클릭하십시오.
다음으로, 기존 Business Manager를 선택하는 옵션(보유한 경우)이 표시되거나, 원하는 경우 온보딩 프로세스가 자동으로 생성할 수 있습니다(나중에 필요한 경우 비즈니스를 사용자 지정할 수 있습니다). 선택한 다음 Continue를 클릭하십시오.
Continue를 클릭하면, 온보딩 프로세스는 다음 작업을 수행합니다:
2. 테스트 메시지 보내기
이제 IDE를 열고 새 프로젝트를 생성할 수 있습니다. TsgcWhatsapp_Client 구성 요소를 배치하고 다음 속성을 채우십시오.
이 2개의 속성이 올바르게 구성되면 SendTest 메서드를 호출하여 Whatsapp Business Platform을 사용하여 전화번호로 첫 번째 메시지를 보내십시오.
oClient := TsgcWhatsapp_Client.Create(nil);
oClient.WhatsappOptions.PhoneNumberId := '107809351952205';
oClient.WhatsappOptions.Token := 'EAAO4OpgZAs98BAGj3nCFGr...ZB2t8mmLB2LRXJkte2Y5PMNh2';
oClient.SendTest('34605889421');
3. Webhook 구성
메시지를 받거나 메시지의 상태가 변경되었을 때 알림을 받으려면 앱에 Webhooks 엔드포인트를 설정해야 합니다. Webhooks를 설정해도 전화번호의 상태에는 영향을 주지 않으며 메시지 전송 또는 수신을 방해하지 않습니다.
시작하려면 먼저 엔드포인트를 생성해야 하므로, 먼저 WhatsApp Client 구성 요소의 ServerOptions 속성을 구성하고 다음 속성을 구성하십시오:
서버를 구성한 후 StartServer 메서드를 사용하여 서버를 시작하고 들어오는 요청을 수락할 수 있습니다.
oClient := TsgcWhatsapp_Client.Create(nil);
oClient.ServerOptions.WebhookOptions.Endpoint := '/webhook';
oClient.ServerOptions.WebhookOptions.Token := 'MySecretToken';
oClient.StartServer();
엔드포인트가 준비되면 App Dashboard로 이동하십시오.
App Dashboard에서 WhatsApp 제품을 찾아 Configuration을 클릭하십시오. 그런 다음 webhooks 섹션을 찾아 Configure a webhook을 클릭하십시오. 클릭하면 화면에 대화 상자가 나타나 두 가지 항목을 요청합니다.
정보를 추가한 후 Verify and Save를 클릭하십시오.
App Dashboard로 돌아가서 왼쪽 패널에서 WhatsApp > Configuration 을 클릭하십시오. Webhooks 아래에서 Manage를 클릭하십시오. 알림을 받을 수 있는 모든 객체가 있는 대화 상자가 열립니다. 사용자로부터 메시지를 받으려면 messages에 대해 Subscribe 를 클릭하십시오.
4. 테스트 메시지 수신
새 메시지가 수신될 때마다 클라이언트 이벤트 OnMessageReceived가 호출됩니다.
procedure OnMessageReceived(Sender: TObject; const aMessage: TsgcWhatsapp_Receive_Message; var aMarkAsRead: Boolean);
begin
DoLog('Received: ' + aMessage.Messages._Message[0].Id);
end;
이제 Webhook이 설정되었으므로, 사용한 테스트 번호로 메시지를 보내십시오. 메시지 내용과 함께 Webhooks 알림을 즉시 받아야 합니다!
WhatsApp API는 이전에(최근 24시간 이내) 연락한 적이 없는 전화로 자유 텍스트 메시지를 보내는 것을 허용하지 않습니다. 개발자 계정 번호로 문자를 보낸 적이 없는 전화로 텍스트 메시지를 보내는 유일한 방법은 (Meta가 사전 승인한) Template을 보내는 것입니다. 자유 텍스트 메시지 테스트를 위해 이 제한을 재정의하려면, 먼저 대상 번호에서 개발자 계정 번호로 WhatsApp 메시지를 보내십시오. 그러면 24시간 동안 자유 텍스트 메시지를 보낼 수 있습니다.
OnBeforeSendMessage
이 이벤트는 메시지가 WhatsApp 서버로 전송되기 전에 호출됩니다. RawMessage 매개변수를 통해 내부 메시지에 액세스할 수 있습니다.
OnBeforeSubscribe
이 이벤트는 서버가 토픽을 구독하기 전에 호출됩니다. Accept 매개변수를 사용하여 구독을 허용하거나 거부하십시오. 기본적으로 서버는 요청된 모든 이벤트를 구독합니다.
OnRawMessage
이 이벤트는 서버가 아직 파싱되지 않은 새 메시지를 수신할 때 호출되므로 원시 메시지에 접근할 수 있습니다.
OnMessageReceived
이 이벤트는 서버가 새 메시지를 수신하고 구문 분석한 후에 호출됩니다. MarkAsRead 매개변수를 True로 설정하면, 발신자는 이중 확인 표시를 받게 됩니다.
OnMessageSent
이 이벤트는 서버가 이전에 보낸 메시지에 대한 새 상태 메시지를 수신할 때마다 호출됩니다. 메시지가 전송, 전달 또는 읽음 처리되었는지 알려면 Status 속성을 읽으십시오.