그룹 메시지 추가

Request

PUT https://api.solapi.com/messages/v4/groups/:groupId/messages

그룹에 메시지를 추가합니다. 접수 실패건은 저장되지만 발송은 되지 않습니다.

그룹메시지 추가 API에 다음 3가지 제한사항이 있습니다.

  • 하나의 요청의 총 데이터 크기는 15MB를 넘을 수 없습니다.

  • 하나의 요청에 수신번호는 10,000 개를 넘을 수 없습니다.

  • 하나의 그룹에 담을 수 있는 메시지는 1,000,000 개 제한입니다.

홈페이지의 문자발송 내역에서 전송결과 내역을 확인하실 수 있습니다. (로그인 필요)

전송 내역(메시지 그룹, 메시지 목록)의 보관기간은 생성일 기준 6개월 입니다. 6개월이 지난 내역은 조회가 불가능합니다.

Authorization 인증 필요 [?]

계정 권한
회원 권한
계정 상태
회원 상태
계정 인증

message:write

role-message:write

ACTIVE

ACTIVE

Path Parameters

Name
Description

:groupId

메시지 그룹 아이디

Request Structure

{
    "messages": "Array"
}

Body Params

Name
Type
Required
Description

Array

O

발송할 메시지 내용

Body / messages

Name
Type
Required
Description

to

string

O

수신번호

from

string

O

발신번호 사전 등록된 전화번호만 사용 가능

text

string

O

메시지 내용 한글 1,000자, 영문 2,000자 제한

type

string

메시지 타입

country

string

국가번호 (기본: 82, 미국(캐나다):1, 중국: 86, 일본: 81)

subject

string

메시지 제목 한글 20자, 영문 40자 제한

imageId

string

Storage API에 등록된 이미지 아이디 참고

object

친구톡, 알림톡을 보내기 위한 옵션

object

네이버 스마트 알림을 보내기 위한 옵션

object

설명 없음

object

확장 필드로 사용. 키는 30자, 값은 100자 제한

autoTypeDetect

boolean

타입 설정이 없을 경우 자동으로 설정함. 기본 값은 true

replacementText

string

설명 없음

Body / messages / kakaoOptions

Name
Type
Required
Description

pfId

string

테스트에서 발급된 카카오톡 채널의 연동 아이디

pfGroupId

string

설명 없음

templateId

string

알림톡 템플릿 아이디

disableSms

boolean

대체 발송 여부

imageId

string

Storage API에 등록된 이미지 아이디 참고

array

알림톡 템플릿 버튼 목록

title

string

설명 없음

Body / messages / kakaoOptions / buttons

Name
Type
Required
Description

buttonName

string

O

버튼 이름

buttonType

string

O

버튼 종류(AL: 앱링크, WL: 웹링크, DS: 배송조회, BK: 키워드, MD: 전달

linkMo

string

모바일 링크(WL 웹링크)

linkPc

string

웹 링크(WL 웹링크)

linkAnd

string

안드로이드 링크(AL 앱링크)

linkIos

string

IOS 링크(AL 앱링크)

Body / messages / naverOptions

Name
Type
Required
Description

talkId

string

설명 없음

templateId

string

알림톡 템플릿 아이디

disableSms

boolean

대체 발송 여부

array

네이버 스마트 알림 템플릿 버튼 목록

Body / messages / naverOptions / buttons

Name
Type
Required
Description

buttonType

string

O

설명 없음

linkMo

string

모바일 링크

linkPc

string

웹 링크

Body / messages / rcsOptions

Name
Type
Required
Description

brandId

string

설명 없음

templateId

string

알림톡 템플릿 아이디

copyAllowed

boolean

설명 없음

object

설명 없음

commercialType

boolean

설명 없음

mmsType

string

설명 없음

disableSms

boolean

대체 발송 여부

array

설명 없음

array

설명 없음

Body / messages / rcsOptions / variables

Body / messages / rcsOptions / additionalBody

Name
Type
Required
Description

title

string

O

설명 없음

description

string

O

설명 없음

imageId

string

Storage API에 등록된 이미지 아이디 참고

array

설명 없음

Body / messages / rcsOptions / additionalBody / buttons

Name
Type
Required
Description

buttonType

string

O

설명 없음

link

string

설명 없음

latitude

string

설명 없음

longitude

string

설명 없음

label

string

설명 없음

query

string

설명 없음

title

string

설명 없음

startTime

date

설명 없음

endTime

date

설명 없음

text

string

메시지 내용 한글 1,000자, 영문 2,000자 제한

phone

string

설명 없음

Body / messages / rcsOptions / buttons

Name
Type
Required
Description

buttonType

string

O

설명 없음

link

string

설명 없음

latitude

string

설명 없음

longitude

string

설명 없음

label

string

설명 없음

query

string

설명 없음

title

string

설명 없음

startTime

date

설명 없음

endTime

date

설명 없음

text

string

메시지 내용 한글 1,000자, 영문 2,000자 제한

phone

string

설명 없음

Body / messages / customFields


Response

Response Structure

Response Description

Response /

Name
Type
Should Return
Description

errorCount

number

접수 실패 카운트

array

모든 메시지의 접수 결과 목록

Response / resultList

Name
Type
Should Return
Description

to

string

O

수신번호

from

string

O

발신번호 사전 등록된 전화번호만 사용 가능

type

string

O

메시지 타입

country

string

O

국가번호 (기본: 82, 미국(캐나다):1, 중국: 86, 일본: 81)

messageId

string

O

메시지 아이디

statusCode

string

O

상태 코드 참고

statusMessage

string

O

상태 메시지 참고

accountId

string

O

계정 고유 아이디


Samples

단문문자(SMS) 추가

Sample Request

Sample Response

Sample Code


장문문자(LMS) 추가

Sample Request

Sample Response

Sample Code


포토문자(MMS) 추가

Sample Request

Sample Response

Sample Code


알림톡(ATA) 추가

Sample Request

Sample Response

Sample Code


친구톡(CTA) 추가

Sample Request

Sample Response

Sample Code


친구톡 이미지 (CTI) 추가

Sample Request

Sample Response

Sample Code


커스텀 필드 사용

Sample Request

Sample Response

Sample Code


to가 String일 경우

Sample Request

Sample Response

Sample Code


to가 Array일 경우

Sample Request

Sample Response

Sample Code


to가 String인 경우와 Array인 경우가 합쳐진 경우

Sample Request

Sample Response

Sample Code


문서 생성일 : 2021-11-16

Last updated

Was this helpful?