알림톡 발송 접수

# 접수 성공 응답은 202 입니다 (200 이 아닙니다).
# 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
curl -X POST 'https://api.directalk.io/public/v1/messages/alimtalk' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 9f1c2b7e-4a63-4f18-9d0b-5e7c8a1f2d34' \
  --data-raw '{
    "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": "문자열"
    }
  }'

// 접수 성공 응답은 202 입니다 (200 이 아닙니다).
// 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
const response = await fetch(
  "https://api.directalk.io/public/v1/messages/alimtalk",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json",
      "Idempotency-Key": "9f1c2b7e-4a63-4f18-9d0b-5e7c8a1f2d34",
    },
    body: JSON.stringify({
      "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": "문자열"
      }
    }),
  },
);

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

# 접수 성공 응답은 202 입니다 (200 이 아닙니다).
# 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
response = requests.post(
    "https://api.directalk.io/public/v1/messages/alimtalk",
    headers={
        "Authorization": "Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
        "Content-Type": "application/json",
        "Idempotency-Key": "9f1c2b7e-4a63-4f18-9d0b-5e7c8a1f2d34",
    },
    json={
        "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": "문자열",
        },
    },
)

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

// 접수 성공 응답은 202 입니다 (200 이 아닙니다).
// 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
$payload = [
    "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" => "문자열",
    ],
];
$ch = curl_init("https://api.directalk.io/public/v1/messages/alimtalk");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
        "Content-Type: application/json",
        "Idempotency-Key: 9f1c2b7e-4a63-4f18-9d0b-5e7c8a1f2d34",
    ],
    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);

# 접수 성공 응답은 202 입니다 (200 이 아닙니다).
# 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
curl -X POST 'https://api.directalk.io/public/v1/messages/alimtalk' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 9f1c2b7e-4a63-4f18-9d0b-5e7c8a1f2d34' \
  --data-raw '{
    "recipients": [
      {
        "phone": "01012345678"
      }
    ],
    "channelId": "@우리브랜드",
    "templateCode": "TPL_ORDER_01"
  }'

// 접수 성공 응답은 202 입니다 (200 이 아닙니다).
// 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
const response = await fetch(
  "https://api.directalk.io/public/v1/messages/alimtalk",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json",
      "Idempotency-Key": "9f1c2b7e-4a63-4f18-9d0b-5e7c8a1f2d34",
    },
    body: JSON.stringify({
      "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

# 접수 성공 응답은 202 입니다 (200 이 아닙니다).
# 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
response = requests.post(
    "https://api.directalk.io/public/v1/messages/alimtalk",
    headers={
        "Authorization": "Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
        "Content-Type": "application/json",
        "Idempotency-Key": "9f1c2b7e-4a63-4f18-9d0b-5e7c8a1f2d34",
    },
    json={
        "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

// 접수 성공 응답은 202 입니다 (200 이 아닙니다).
// 응답은 봉투에 싸여 옵니다 — 알맹이는 data 안에 있습니다.
$payload = [
    "recipients" => [
        [
            "phone" => "01012345678",
        ],
    ],
    "channelId" => "@우리브랜드",
    "templateCode" => "TPL_ORDER_01",
];
$ch = curl_init("https://api.directalk.io/public/v1/messages/alimtalk");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
        "Content-Type: application/json",
        "Idempotency-Key: 9f1c2b7e-4a63-4f18-9d0b-5e7c8a1f2d34",
    ],
    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);