> For the complete documentation index, see [llms.txt](https://nurigo.gitbook.io/solapi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nurigo.gitbook.io/solapi/api-reference/messages/groups/sendgroupmessage.md). # 발송 요청 ## Request ``` POST https://api.solapi.com/messages/v4/groups/:groupId/send ``` 그룹 메시지 발송을 요청합니다. 정상 접수된 메시지만 발송을 시도합니다. ### Authorization 인증 필요 [\[?\]](https://docs.solapi.com/authentication/overview#authorization) | 계정 권한 | 회원 권한 | 계정 상태 | 회원 상태 | 계정 인증 | | --------------- | -------------------- | -------- | -------- | :---: | | `message:write` | `role-message:write` | `ACTIVE` | `ACTIVE` | | ### Path Parameters | Name | Description | | :------: | :---------: | | :groupId | 메시지 그룹 아이디 | *** ## Samples ### sendGroupMessage > **Sample Request** ```json {} ``` > **Sample Response** ```json { "count": { "total": 0, "sentTotal": 0, "sentFailed": 0, "sentSuccess": 0, "sentPending": 0, "sentReplacement": 0, "refund": 0, "registeredFailed": 0, "registeredSuccess": 1 }, "countForCharge": { "sms": { "82": 1 }, "lms": {}, "mms": {}, "ata": {}, "cta": {}, "cti": {}, "nsa": {}, "rcs_sms": {}, "rcs_lms": {}, "rcs_mms": {}, "rcs_tpl": {} }, "balance": { "requested": 0, "replacement": 0, "refund": 0, "sum": 0 }, "point": { "requested": 50, "replacement": 0, "refund": 0, "sum": 0 }, "app": { "profit": { "sms": 0, "lms": 0, "mms": 0, "ata": 0, "cta": 0, "cti": 0, "nsa": 0, "rcs_sms": 0, "rcs_lms": 0, "rcs_mms": 0, "rcs_tpl": 0 }, "appId": null, "version": null }, "serviceMethod": "MT", "sdkVersion": null, "osPlatform": null, "log": [ { "message": "메시지 그룹이 생성되었습니다.", "createAt": "2021-11-16T05:09:39.731Z" }, { "message": "국가코드(82)의 단문문자(SMS) 1 건이 추가되었습니다.", "createAt": "2021-11-16T05:09:39.731Z" }, { "createAt": "2021-11-16T05:09:46.771Z", "message": "메시지를 발송했습니다.", "oldBalance": 100, "newBalance": 100, "oldPoint": 100, "newPoint": 50, "totalPrice": 20 } ], "status": "SENDING", "dateSent": "2021-11-16T05:09:46.771Z", "dateCompleted": null, "isRefunded": false, "flagUpdated": false, "prepaid": true, "strict": true, "masterAccountId": null, "allowDuplicates": false, "_id": "G4V20180307105937H3PTASXMNJG2JIO", "groupId": "G4V20180307105937H3PTASXMNJG2JIO", "accountId": "12925149", "apiVersion": "4", "price": { "82": { "sms": 20, "lms": 50, "mms": 200, "ata": 19, "cta": 13 } }, "customFields": {}, "hint": {}, "dateCreated": "2021-11-16T05:09:39.734Z", "dateUpdated": "2021-11-16T05:09:46.772Z" } ``` > **Sample Code** {% tabs %} {% tab title="NODE" %} ```javascript var request = require('request'); var options = { headers: { Authorization: 'HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4' }, method: 'POST', json: true, url: 'http://api.solapi.com/messages/v4/groups/G4V20180307105937H3PTASXMNJG2JIO/send' }; request(options, function(error, response, body) { if (error) throw error; console.log('result :', body); }); ``` {% endtab %} {% tab title="PHP" %} ```php array( 'header' => "Authorization: HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4\r\n", 'method' => 'POST' ) ); $context = stream_context_create($options); $result = file_get_contents($url, false, $context); var_dump($result); ``` {% endtab %} {% tab title="PYTHON" %} ```python import requests url = "http://api.solapi.com/messages/v4/groups/G4V20180307105937H3PTASXMNJG2JIO/send" headers = { "Authorization": "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4" } response = requests.post(url, headers=headers) print(response.status_code) print(response.text) ``` {% endtab %} {% tab title="CURL" %} ``` #!/bin/bash curl -X POST \ -H 'Authorization: HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4' \ http://api.solapi.com/messages/v4/groups/G4V20180307105937H3PTASXMNJG2JIO/send ``` {% endtab %} {% tab title="RUBY" %} ```ruby require 'net/http' require 'uri' require 'json' uri = URI.parse("http://api.solapi.com/messages/v4/groups/G4V20180307105937H3PTASXMNJG2JIO/send") headers = { "Authorization": "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4" } http = Net::HTTP.new(uri.host, uri.port) request = Net::HTTP::Post.new(uri.request_uri, headers) response = http.request(request) puts response.code puts response.body ``` {% endtab %} {% tab title="GO" %} ```go package main import ( "fmt" "io/ioutil" "net/http" "strings" ) func main() { uri := "http://api.solapi.com/messages/v4/groups/G4V20180307105937H3PTASXMNJG2JIO/send" req, err := http.NewRequest("POST", uri, nil) if err != nil { panic(err) } req.Header.Set("Authorization", "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4") client := &http.Client{} resp, err := client.Do(req) if err != nil { panic(err) } defer resp.Body.Close() bytes, _ := ioutil.ReadAll(resp.Body) str := string(bytes) fmt.Println(str) } ``` {% endtab %} {% tab title="JAVA" %} ```java package solapi; import java.io.BufferedReader; import java.io.DataOutputStream; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; public class Request { public static void main(String[] args) throws Exception { String targetUrl = "http://api.solapi.com/messages/v4/groups/G4V20180307105937H3PTASXMNJG2JIO/send"; URL url = new URL(targetUrl); HttpURLConnection con = (HttpURLConnection) url.openConnection(); con.setRequestMethod("POST"); con.setRequestProperty("Authorization", "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4"); con.setDoOutput(true); DataOutputStream wr = new DataOutputStream(con.getOutputStream()); wr.writeBytes(parameters); wr.flush(); wr.close(); int responseCode = con.getResponseCode(); BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream())); String line; StringBuffer response = new StringBuffer(); while ((line = in.readLine()) != null) { response.append(line); } in.close(); System.out.println("HTTP response code : " + responseCode); System.out.println("HTTP body : " + response.toString()); } } ``` {% endtab %} {% endtabs %} *** > 문서 생성일 : 2021-11-16