이 문서에서는 비즈니스용 RCS 플랫폼이 메시지 전송 및 기타 API 상호작용을 처리하는 방법을 설명하고 동기 작업과 비동기 작업을 구분합니다.
RBM API 상호작용은 일반적으로 HTTP 수준에서 동기 요청-응답 패턴을 따릅니다. 하지만 특히 메시지 전송과 같은 많은 API 호출의 결과는 웹훅을 통해 비동기적으로 처리됩니다. 자세한 내용은 다음 섹션을 참고하세요.
메시지 전송: 동기 요청, 비동기 전송
phones.agentMessages.create API 요청은 API 관점에서 동기식으로 처리됩니다. 비즈니스용 RCS 플랫폼에 HTTP 요청을 하면 서버는 요청이 수신되었는지, 유효한지 여부를 나타내는 표준 HTTP 상태 코드(예: 200 OK 또는 오류)로 거의 즉시 응답합니다.
하지만 최종 사용자에게 메시지를 실제로 전송하는 것은 비동기식으로 처리됩니다. 이 프로세스에 영향을 줄 수 있는 요인은 다음과 같습니다.
- 수신자 상태: 사용자가 오프라인 상태이거나 배터리가 부족하거나 RCS가 사용 설정되어 있지 않을 수 있습니다.
- 네트워크 상태: 이동통신사 네트워크 문제로 인해 메시지 전송이 지연되거나 전송되지 않을 수 있습니다.
비즈니스용 RCS 플랫폼은 웹훅을 통해 메시지 전송 상태 업데이트 (예: 전송 확인 및 수신 확인)를 비동기식으로 제공합니다.
따라서 초기 API 요청은 동기식이지만 비동기 웹훅 이벤트를 사용하여 메시지 전송을 추적해야 합니다. phones.agentMessages.create 응답에서 전송 상태를 즉시 확인할 수 있다고 기대하지 마세요.
기타 RBM API 상호작용
다른 대부분의 HTTP 기반 RBM API도 동기 요청-응답 모델로 작동합니다. 이러한 API는 요청 상태 (성공 또는 오류)를 나타내는 즉각적인 HTTP 응답을 제공합니다. 하지만 요청은 동기식인 반면 요청으로 인해 발생하는 작업에는 비동기 프로세스가 포함될 수 있습니다. 예를 들어 상담사 정보를 업데이트하는 API 호출에 대한 성공적인 응답이 있다고 해서 업데이트가 모든 곳에 즉시 반영되는 것은 아닙니다. 전파 지연이 발생할 수 있습니다.
웹훅 엔드포인트: 비동기 이벤트
다음 이벤트는 웹훅 엔드포인트에 비동기식으로 전송됩니다.
- 수신 사용자 메시지: 비즈니스용 RCS 플랫폼은 수신 사용자 메시지를 웹훅 엔드포인트로 푸시합니다. 수신 메일을 확인하세요.
- 전송 및 읽음 확인: 메시지 전송 및 읽음 상태 알림이 웹훅을 통해 전송됩니다.
- 대화 이벤트: 입력 표시기와 같은 일부 대화 관련 이벤트는 웹훅을 통해 전송됩니다.
- 메시지 만료 및 취소 이벤트: RCS for Business 플랫폼은 만료된 메시지가 성공적으로 취소되었는지 확인하는 이벤트를 전송합니다.