알림톡 다건 발송 접수

# 성공 응답은 200 입니다.
# 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
curl -X POST 'https://api.directalk.io/public/v1/messages/alimtalk/batch' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "items": [
      {
        "recipients": [
          {
            "phone": "01012345678",
            "variables": {
              "이름": "김철수",
              "주문번호": "A-1001"
            }
          }
        ],
        "removeDuplicates": false,
        "variables": {
          "회사명": "타이탄즈"
        },
        "scheduledAt": "2026-08-20T10:00:00+09:00",
        "tags": [
          "API"
        ],
        "channelId": "@우리브랜드",
        "templateCode": "TPL_ORDER_01",
        "fallback": {
          "enabled": true,
          "channel": "SMS",
          "senderNumber": "0212345678",
          "title": "문자열",
          "message": "문자열"
        },
        "idempotencyKey": "course-123-student-456-v2"
      }
    ]
  }'

// 성공 응답은 200 입니다.
// 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
const response = await fetch(
  "https://api.directalk.io/public/v1/messages/alimtalk/batch",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "items": [
        {
          "recipients": [
            {
              "phone": "01012345678",
              "variables": {
                "이름": "김철수",
                "주문번호": "A-1001"
              }
            }
          ],
          "removeDuplicates": false,
          "variables": {
            "회사명": "타이탄즈"
          },
          "scheduledAt": "2026-08-20T10:00:00+09:00",
          "tags": [
            "API"
          ],
          "channelId": "@우리브랜드",
          "templateCode": "TPL_ORDER_01",
          "fallback": {
            "enabled": true,
            "channel": "SMS",
            "senderNumber": "0212345678",
            "title": "문자열",
            "message": "문자열"
          },
          "idempotencyKey": "course-123-student-456-v2"
        }
      ]
    }),
  },
);

const envelope = await response.json();

// 모든 응답이 { success, message, data, correlationId, ... } 봉투에 싸여 옵니다.
if (!envelope.success) {
  // correlationId 를 함께 남겨 두면 문의할 때 바로 추적할 수 있습니다.
  throw new Error(`[${envelope.code}] ${envelope.message} (${envelope.correlationId})`);
}

// 알맹이는 여기 있습니다. response.json() 결과를 그대로 쓰면 undefined 를 만납니다.
const data = envelope.data;
console.log(data);

import requests

# 성공 응답은 200 입니다.
# 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
response = requests.post(
    "https://api.directalk.io/public/v1/messages/alimtalk/batch",
    headers={
        "Authorization": "Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
        "Content-Type": "application/json",
    },
    json={
        "items": [
            {
                "recipients": [
                    {
                        "phone": "01012345678",
                        "variables": {
                            "이름": "김철수",
                            "주문번호": "A-1001",
                        },
                    },
                ],
                "removeDuplicates": False,
                "variables": {
                    "회사명": "타이탄즈",
                },
                "scheduledAt": "2026-08-20T10:00:00+09:00",
                "tags": [
                    "API",
                ],
                "channelId": "@우리브랜드",
                "templateCode": "TPL_ORDER_01",
                "fallback": {
                    "enabled": True,
                    "channel": "SMS",
                    "senderNumber": "0212345678",
                    "title": "문자열",
                    "message": "문자열",
                },
                "idempotencyKey": "course-123-student-456-v2",
            },
        ],
    },
)

envelope = response.json()

# 모든 응답이 { success, message, data, correlationId, ... } 봉투에 싸여 옵니다.
if not envelope["success"]:
    # code 는 없을 수도 있습니다 — 프레임워크가 먼저 거절한 요청에는 붙지 않습니다.
    raise RuntimeError(
        f"[{envelope.get('code')}] {envelope['message']} ({envelope['correlationId']})"
    )

# 알맹이는 여기 있습니다.
data = envelope["data"]
print(data)

<?php

// 성공 응답은 200 입니다.
// 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
$payload = [
    "items" => [
        [
            "recipients" => [
                [
                    "phone" => "01012345678",
                    "variables" => [
                        "이름" => "김철수",
                        "주문번호" => "A-1001",
                    ],
                ],
            ],
            "removeDuplicates" => false,
            "variables" => [
                "회사명" => "타이탄즈",
            ],
            "scheduledAt" => "2026-08-20T10:00:00+09:00",
            "tags" => [
                "API",
            ],
            "channelId" => "@우리브랜드",
            "templateCode" => "TPL_ORDER_01",
            "fallback" => [
                "enabled" => true,
                "channel" => "SMS",
                "senderNumber" => "0212345678",
                "title" => "문자열",
                "message" => "문자열",
            ],
            "idempotencyKey" => "course-123-student-456-v2",
        ],
    ],
];
$ch = curl_init("https://api.directalk.io/public/v1/messages/alimtalk/batch");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS     => json_encode($payload, JSON_UNESCAPED_UNICODE),
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 모든 응답이 { success, message, data, correlationId, ... } 봉투에 싸여 옵니다.
$envelope = json_decode($response, true);

if (empty($envelope["success"])) {
    // code 는 없을 수도 있습니다 — 그때는 HTTP 상태를 보세요.
    throw new RuntimeException(
        sprintf("[%s] %s (%s)", $envelope["code"] ?? $status, $envelope["message"], $envelope["correlationId"])
    );
}

// 알맹이는 여기 있습니다.
$data = $envelope["data"];
var_dump($data);

# 성공 응답은 200 입니다.
# 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
curl -X POST 'https://api.directalk.io/public/v1/messages/alimtalk/batch' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "items": [
      {
        "recipients": [
          {
            "phone": "01012345678"
          }
        ],
        "channelId": "@우리브랜드",
        "templateCode": "TPL_ORDER_01"
      }
    ]
  }'

// 성공 응답은 200 입니다.
// 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
const response = await fetch(
  "https://api.directalk.io/public/v1/messages/alimtalk/batch",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "items": [
        {
          "recipients": [
            {
              "phone": "01012345678"
            }
          ],
          "channelId": "@우리브랜드",
          "templateCode": "TPL_ORDER_01"
        }
      ]
    }),
  },
);

const envelope = await response.json();

// 모든 응답이 { success, message, data, correlationId, ... } 봉투에 싸여 옵니다.
if (!envelope.success) {
  // correlationId 를 함께 남겨 두면 문의할 때 바로 추적할 수 있습니다.
  throw new Error(`[${envelope.code}] ${envelope.message} (${envelope.correlationId})`);
}

// 알맹이는 여기 있습니다. response.json() 결과를 그대로 쓰면 undefined 를 만납니다.
const data = envelope.data;
console.log(data);

import requests

# 성공 응답은 200 입니다.
# 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
response = requests.post(
    "https://api.directalk.io/public/v1/messages/alimtalk/batch",
    headers={
        "Authorization": "Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
        "Content-Type": "application/json",
    },
    json={
        "items": [
            {
                "recipients": [
                    {
                        "phone": "01012345678",
                    },
                ],
                "channelId": "@우리브랜드",
                "templateCode": "TPL_ORDER_01",
            },
        ],
    },
)

envelope = response.json()

# 모든 응답이 { success, message, data, correlationId, ... } 봉투에 싸여 옵니다.
if not envelope["success"]:
    # code 는 없을 수도 있습니다 — 프레임워크가 먼저 거절한 요청에는 붙지 않습니다.
    raise RuntimeError(
        f"[{envelope.get('code')}] {envelope['message']} ({envelope['correlationId']})"
    )

# 알맹이는 여기 있습니다.
data = envelope["data"]
print(data)

<?php

// 성공 응답은 200 입니다.
// 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
$payload = [
    "items" => [
        [
            "recipients" => [
                [
                    "phone" => "01012345678",
                ],
            ],
            "channelId" => "@우리브랜드",
            "templateCode" => "TPL_ORDER_01",
        ],
    ],
];
$ch = curl_init("https://api.directalk.io/public/v1/messages/alimtalk/batch");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS     => json_encode($payload, JSON_UNESCAPED_UNICODE),
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 모든 응답이 { success, message, data, correlationId, ... } 봉투에 싸여 옵니다.
$envelope = json_decode($response, true);

if (empty($envelope["success"])) {
    // code 는 없을 수도 있습니다 — 그때는 HTTP 상태를 보세요.
    throw new RuntimeException(
        sprintf("[%s] %s (%s)", $envelope["code"] ?? $status, $envelope["message"], $envelope["correlationId"])
    );
}

// 알맹이는 여기 있습니다.
$data = $envelope["data"];
var_dump($data);