(상태코드 : 1011)Format Error 간헐적 발생

[comjs]

사용 중인 프로그래밍 언어 및 버전

Node.js v21.2.0

SDK 버전

SOLAPI Node.js SDK v5.3.1

운영 환경

AWS/클라우드/호스팅 서버 등 상용 웹 서버

질문/문제 설명

버튼이 존재하는 메시지의 경우 간헐적인 1011 오류 발생
최초 오류 발생 시각: 2025.05.02 11:16:26

동일한 코드로 1년간 문제없이 전송되고 있었으나, 금일 최초 발생하였습니다.

WL 버튼에 linkMo값이 존재하는데 아래와 같은 오류메시지 출력

$091ca2771f174553$export$b75729dbe9bbac3a [MessagesNotReceivedError]: 1개의 메시지가 접수되지 못했습니다. 자세한 에러 메시지는 해당 에러 내 failedMessageList를 확인해주세요.
    at /***/node_modules/solapi/dist/index.js:453:99
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async KakaoAlarm.send (/***/.next/server/chunks/7327.js:853:24) {
  failedMessageList: [
    {
      to: '***',
      from: '***',
      type: 'ATA',
      statusMessage: "1011 buttons 필드에 필수값이 없거나 잘못된 값이 들어가 있습니다. buttonType이 'WL'일 땐 'linkMo', 'AL'일 땐 'linkIos', 'linkAnd' 값이 필수입니다.",
      country: '***',
      messageId: '***',
      statusCode: '1011',
      accountId: '***'
    }
  ]
}

1011 오류가 발생한 메시지의 RAW Data 일부 발췌

"buttons":[
  {
    "targetOut":false
    "buttonType":"WL"
    "buttonName":"주문내역 보기"
    "linkMo":"https://***/mypage/shopping/order/20250502-00000173"
    "linkPc":"https://***/mypage/shopping/order/20250502-00000173"
  }
]

성공한 메시지의 RAW Data 일부 발췌

"buttons":[
  {
    "buttonType":"WL"
    "buttonName":"주문내역 보기"
    "linkMo":"https://***/mypage/shopping/order/20250502-00000148"
    "linkPc":"https://***/mypage/shopping/order/20250502-00000148"
  }
]

코드 예시

const msg = new SolapiMessageService(this.key, this.secret)
await msg.send([
  {
    to: '***',
    from:'***',
    kakaoOptions: {
      pfId: this.pfId,
      templateId: '***',
      variables: {
        '#{고객명}':'***',
        '#{상품명}': '***',
        '#{주문번호}': '***',
        '#{상품고유번호}': '***,
      },
    },
  },
])

• 템플릿에 링크가 지정되어있으며 https://***/mypage/shopping/order/#{주문번호} 형태로 들어감

시도한 해결 방법

No response

기대하는 결과

전송이 성공할 때도 있고, 실패할 때도 있으나
모든 메시지가 성공적으로 전송되어야합니다.

확인사항

• 관련 문서를 확인했습니다
• 이전 토론/이슈에서 유사한 질문이 없는지 확인했습니다
• 문의 전 읽어야 하는 사항(문의 전 꼭 읽어봐주세요! #7)을 확인했습니다

[garudanish]

같은 이슈로 솔라피 채널톡으로 문의했는데 해당 이슈는 해결되었다고 답변을 받았습니다.

[Palbahngmiyine]

안녕하세요, 솔라피 기술지원팀입니다.
답변이 지연되어 송구하다는 말씀 드리며, 회원님들께서 문의하시고 댓글 남겨주신 상황과 같이 내부 알림톡 기능 추가 과정에서 모종의 데이터 충돌 문제가 발생하여 관련한 문제가 발생했었습니다.

현재로서는 모두 해결되었음을 안내드리며, 이용에 불편을 끼쳐드려 대단히 죄송합니다.

남겨주신 내용들은 모두 내부 개발팀에 건의하여 차후 동일한 문제가 발생되지 않도록 최선의 조치를 다하겠습니다.