RCS 발송 추가

Author: wileyday

examples/javascript/webhooks/index.js

@@ -4,13 +4,28 @@ const asyncify = require("express-asyncify");
 const { SolapiMessageService } = require("solapi");
 const messageService = new SolapiMessageService("ENTER_YOUR_API_KEY", "ENTER_YOUR_API_SECRET");
 
+/**
+ * 웹훅 레퍼런스
+ * http://developers.solapi.com/references/webhook/
+ */
+
 // 넘어온 그룹 ID로 메시지 목록을 가져오는 API를 사용하므로 API Key, API Secret Key가 준비되어야 합니다.
 const app = asyncify(express());
 app.use(bodyParser.json({ extended: false }));
 app.use(bodyParser.urlencoded({ extended: false }));
 
-// 관리콘솔 내 등록한 webhook url로 입력해야 합니다.
-app.post("/report", async (req, res) => {
+// 메시지 리포트
+app.post("/single-report", async (req, res) => {
+  // body에 [] 형식으로 메시지정보 객체 목록이 들어옵니다.
+  for (const messageInfo of req.body) {
+    console.log("메시지 정보:", messageInfo);
+  }
+  // 200을 리턴해야 합니다. (200이 리턴되지 않으면 특정 시간 간격을 두고 총 5번이 호출됩니다)
+  return res.status(200).json({});
+});
+
+// 그룹 리포트
+app.post("/group-report", async (req, res) => {
   // body에 [] 형식으로 그룹정보 객체 목록이 들어옵니다.
   for (const groupInfo of req.body) {
     // 그룹ID로 메시지 목록을 가져옵니다.
@@ -28,6 +43,16 @@ app.post("/report", async (req, res) => {
   return res.status(200).json({});
 });
 
+// 팩스 수신
+app.post("/fax", async (req, res) => {
+  // body에 [] 형식으로 팩스수신정보 객체 목록이 들어옵니다.
+  for (const faxInfo of req.body) {
+    console.log("팩스 수신 정보:", faxInfo);
+  }
+  // 200을 리턴해야 합니다. (200이 리턴되지 않으면 특정 시간 간격을 두고 총 5번이 호출됩니다)
+  return res.status(200).json({});
+});
+
 app.listen(8080, () => {
   console.log(`Server is listening...`);
 });

src/models/message.ts

@@ -1,4 +1,5 @@
 import {KakaoOption, kakaoOptionRequest} from './kakao/kakaoOption';
+import {RcsOption, RcsOptionRequest} from './rcs/rcsOption';
 
 /**
  * @name MessageType 메시지 유형(단문 문자, 장문 문자, 알림톡 등)
@@ -36,6 +37,7 @@ export type MessageParameter = {
   subject?: string;
   autoTypeDetect?: boolean;
   kakaoOptions?: kakaoOptionRequest;
+  rcsOptions?: RcsOptionRequest;
   country?: string;
   customFields?: Record<string, string>;
   replacements?: Array<object>;
@@ -105,6 +107,11 @@ export class Message {
    */
   kakaoOptions?: KakaoOption;
 
+  /**
+   * RCS 메시지를 위한 프로퍼티
+   */
+  rcsOptions?: RcsOption;
+
   /**
    * 해외 문자 발송을 위한 국가번호(예) "82", "1" 등)
    */
@@ -140,7 +147,11 @@ export class Message {
     if (parameter.kakaoOptions != undefined) {
       this.kakaoOptions = new KakaoOption(parameter.kakaoOptions);
     }
+    if (parameter.rcsOptions != undefined) {
+      this.rcsOptions = new RcsOption(parameter.rcsOptions);
+    }
     this.customFields = parameter.customFields;
     this.replacements = parameter.replacements;
   }
 }
+

src/models/rcs/rcsButton.ts

@@ -0,0 +1,33 @@
+/**
+ * @name "RCS 버튼타입"
+ */
+export type RcsButtonType =
+  | 'WL' // (웹링크)
+  | 'ML' // (지도[좌표])
+  | 'MQ' // (지도[쿼리])
+  | 'MR' // (위치공유)
+  | 'CA' // (캘린더생성)
+  | 'CL' // (복사)
+  | 'DL' // (전화걸기)
+  | 'MS'; // (메시지보내기)
+
+export type RcsWebButton = {
+  buttonName: string;
+  buttonType: Extract<RcsButtonType, 'WL'>;
+  link: string;
+};
+
+export type RcsMapButton = {
+  buttonName: string;
+  buttonType: Extract<RcsButtonType, 'ML'>;
+  latitude: string;
+  longitude: string;
+};
+
+export type RcsDefaultButton = {
+  buttonName: string;
+  buttonType: Exclude<RcsButtonType, 'WL'>;
+  link: string;
+};
+
+export type RcsButton = RcsWebButton | RcsMapButton | RcsDefaultButton;

src/models/rcs/rcsOption.ts

@@ -0,0 +1,43 @@
+import {RcsButton} from './rcsButton';
+export type AdditionalBody = {
+  title: string;
+  description: string;
+  imaggeId?: string;
+  buttons?: Array<RcsButton>;
+}
+
+export type RcsOptionRequest = {
+  brandId: string;
+  templateId?: string;
+  copyAllowed?: boolean;
+  mmsType?: 'M3' | 'S3' | 'M4' | 'S4' | 'M5' | 'S5' | 'M6' | 'S6'; // (M: 중간 사이즈. S: 작은 사이즈. 숫자: 사진 개수)
+  commercialType?: boolean;
+  variables?: Record<string, string>;
+  disableSms?: boolean;
+  additionalBody?: AdditionalBody;
+  buttons: Array<RcsButton>;
+};
+
+export class RcsOption {
+  brandId: string;
+  templateId?: string;
+  copyAllowed?: boolean;
+  mmsType?: 'M3' | 'S3' | 'M4' | 'S4' | 'M5' | 'S5' | 'M6' | 'S6'; // (M: 중간 사이즈. S: 작은 사이즈. 숫자: 사진 개수)
+  commercialType?: boolean;
+  variables?: Record<string, string>;
+  disableSms?: boolean;
+  additionalBody?: AdditionalBody;
+  buttons: Array<RcsButton>;
+
+  constructor(parameter: RcsOptionRequest) {
+    this.brandId = parameter.brandId;
+    this.templateId = parameter.templateId;
+    this.copyAllowed = parameter.copyAllowed;
+    this.mmsType = parameter.mmsType;
+    this.commercialType = parameter.commercialType;
+    this.variables = parameter.variables;
+    this.disableSms = parameter.disableSms;
+    this.additionalBody = parameter.additionalBody;
+    this.buttons = parameter.buttons;
+  }
+}