PHP SDK 가이드

PHP에서 카카오 알림톡, 브랜드메시지, SMS를 가장 쉽게 발송하는 순수 PHP SDK

sendgo/php는 Sendgo 알림 API를 위한 순수 PHP SDK입니다. Laravel 등 특정 프레임워크에 의존하지 않으며, ext-curl과 ext-json만으로 동작합니다.

---

설치

composer require sendgo/php

---

빠른 시작

<?php

use Sendgo\Php\Sendgo;

$sendgo = new Sendgo([
    'access_key'       => $_ENV['SENDGO_ACCESS_KEY'],
    'secret_key'       => $_ENV['SENDGO_SECRET_KEY'],
    'kakao_sender_key' => $_ENV['SENDGO_KAKAO_SENDER_KEY'],
    'sms_sender_key'   => $_ENV['SENDGO_SMS_SENDER_KEY'],
    'api_version'      => 'v2',
]);

// 알림톡 발송
$sendgo->alimtalk->send([
    'templateCode' => 'ORDER_CONFIRM_001',
    'contacts'     => [
        ['contact' => '01012345678', 'name' => '홍길동', 'var1' => 'ORD-001', 'var2' => '29,000원'],
    ],
]);

// SMS 발송
$sendgo->sms->sendSms([
    'content'  => '[Sendgo] 인증번호: 123456 (5분 이내 입력)',
    'contacts' => [['contact' => '01012345678']],
]);

---

알림톡 상세 사용법

<?php

// 다건 발송
$sendgo->alimtalk->send([
    'templateCode' => 'ORDER_CONFIRM_001',
    'contacts'     => [
        ['contact' => '01011111111', 'name' => '홍길동', 'var1' => 'ORD-001', 'var2' => '29,000원'],
        ['contact' => '01022222222', 'name' => '김철수', 'var1' => 'ORD-002', 'var2' => '15,000원'],
        ['contact' => '01033333333', 'name' => '이영희', 'var1' => 'ORD-003', 'var2' => '52,000원'],
    ],
]);

// 예약 발송
$sendgo->alimtalk->send([
    'templateCode' => 'PROMO_SUMMER_2026',
    'scheduleType' => 'SCHEDULED',
    'at'           => '2026-07-28 09:00:00',
    'contacts'     => [['contact' => '01012345678', 'var1' => '여름 한정 50% 할인']],
]);

// 알림톡 실패 시 SMS 자동 대체 발송
$sendgo->alimtalk->send([
    'templateCode' => 'DELIVERY_START_001',
    'replaceSms'   => 'Y',
    'smsSubject'   => '[배송 시작 안내]',
    'smsContent'   => "주문하신 상품이 출고되었습니다.\n송장번호: #{var2}",
    'contacts'     => [['contact' => '01012345678', 'var1' => 'ORD-001', 'var2' => '1234567890']],
]);

---

친구톡 사용법

⚠️ Deprecated — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다. 2026-01-01 부터 친구톡 발송 요청은 카카오 측에서 브랜드메시지(자유형) 로 자동 대체 발송됩니다. 호출은 계속 성공하며, 자유 본문 타입(FT/FI/FW)을 개별 수신자에게 보내는 경로는 현재 이것뿐이므로 기존 코드를 당장 바꿀 필요는 없습니다.

다음의 경우에는 브랜드메시지를 사용하세요.

• 템플릿 기반 리치 타입 (FL/FC/FM/FP/FA)
• 채널 친구가 아닌 수신자 (targeting = N / I)
• 수신 동의한 전체 채널 친구 동보 (targeting = F)

메시지 타입은 1:1 대응되며 변환은 서버가 처리합니다 — FT→BT, FI→BI, FW→BW, FL→BL, FC→BC, FM→BM, FP→BP, FA→BA.

<?php

// 텍스트형
$sendgo->friendtalk->send([
    'content'  => '안녕하세요! 7월 한정 특가 이벤트를 확인해보세요.',
    'contacts' => [['contact' => '01012345678']],
]);

// 이미지형
$sendgo->friendtalk->send([
    'messageType' => 'FI',
    'content'     => '이번 주 특가 상품을 확인하세요!',
    'imageUrl'    => 'https://cdn.example.com/banner.jpg',
    'imageLink'   => 'https://example.com/event',
    'contacts'    => [['contact' => '01012345678']],
]);

// 버튼 포함
$sendgo->friendtalk->send([
    'content'  => '7월 쿠폰이 도착했습니다! 지금 바로 사용하세요.',
    'buttons'  => [
        ['name' => '쿠폰 받기', 'type' => 'WL', 'linkMo' => 'https://example.com/coupon'],
    ],
    'contacts' => [['contact' => '01012345678']],
]);

---

브랜드메시지 사용법

브랜드메시지는 친구톡의 후속 채널입니다. 메시지 타입이 친구톡과 1:1 대응되며 (FT→BT, FI→BI, FW→BW, FL→BL, FC→BC, FM→BM, FP→BP, FA→BA), 요청에는 친구톡 코드를 그대로 넘기고 변환은 서버가 처리합니다.

친구톡과 달리 다음이 가능합니다.

• 채널 친구가 아닌 수신자에게 발송 (targeting: N)
• 수신 동의한 전체 채널 친구 동보 발송 (targeting: F, 수신자 목록 불필요)
• 리스트·캐러셀·커머스·동영상 등 템플릿 기반 리치 메시지

v2 전용입니다. 자유 본문 타입(FT/FI/FW)을 개별 수신자에게 보낼 때는 여전히 친구톡 API 를 쓰세요 — 이 엔드포인트는 그 조합에 NOT_A_BRAND_MESSAGE 를 반환합니다. 친구톡 요청은 카카오 측에서 브랜드메시지(자유형)로 대체 발송됩니다.

<?php

// 단건 발송 — 채널 친구 대상
$sendgo->brandMessage->send([
    'targeting'          => 'M',
    'messageType'        => 'FL',
    'friendTemplateUuid' => '9cd5460b-6458-4edc-9b11-c26d3013c340',
    'contacts'           => [['contact' => '01012345678', 'var1' => '29,000원']],
]);

// 동보 발송 — 수신 동의한 전체 채널 친구 (contacts 불필요)
$sendgo->brandMessage->broadcast([
    'messageType'        => 'FW',
    'friendTemplateUuid' => '9cd5460b-6458-4edc-9b11-c26d3013c340',
]);

// 캠페인 조회
$list = $sendgo->brandMessage->campaigns(['count' => 10]);
$one  = $sendgo->brandMessage->campaign('1f0a6d0e-6b3b-4f0f-9b2f-2f6f6a1b7c11');

---

SMS / LMS / MMS 사용법

<?php

// SMS (90자 이하)
$sendgo->sms->sendSms([
    'content'  => '[Sendgo] 인증번호: 123456 (5분 이내 입력)',
    'contacts' => [['contact' => '01012345678']],
]);

// LMS (장문, 2,000자 이하)
$sendgo->sms->sendLms([
    'subject'  => '[중요] 서비스 점검 안내',
    'content'  => "안녕하세요. 서비스 점검이 예정되어 있습니다.\n\n■ 일시: 2026-07-25 02:00 ~ 06:00\n■ 영향: 전체 서비스",
    'contacts' => [['contact' => '01012345678']],
]);

// MMS (이미지 포함)
$sendgo->sms->sendMms([
    'subject'  => '[이벤트] 7월 특가',
    'content'  => '이번 달 특가 상품을 확인하세요!',
    'contacts' => [['contact' => '01012345678']],
]);

// 예약 문자
$sendgo->sms->sendSms([
    'content'      => '[알림] 예약 미팅을 확인해주세요.',
    'scheduleType' => 'SCHEDULED',
    'at'           => '2026-07-23 08:00:00',
    'contacts'     => [['contact' => '01012345678']],
]);

---

프레임워크 통합

Symfony

<?php
// src/Service/NotificationService.php

namespace App\Service;

use Sendgo\Php\Sendgo;
use Sendgo\Php\Exception\SendgoException;

class NotificationService
{
    public function __construct(private Sendgo $sendgo) {}

    public function sendOrderConfirm(string $phone, string $orderNo): void
    {
        $this->sendgo->alimtalk->send([
            'templateCode' => 'ORDER_CONFIRM_001',
            'contacts'     => [['contact' => $phone, 'var1' => $orderNo]],
        ]);
    }

    public function sendShippingAlert(string $phone, string $trackingNo): void
    {
        $this->sendgo->alimtalk->send([
            'templateCode' => 'SHIPPING_001',
            'replaceSms'   => 'Y',
            'smsContent'   => "배송이 시작되었습니다.\n송장번호: {$trackingNo}",
            'contacts'     => [['contact' => $phone, 'var1' => $trackingNo]],
        ]);
    }
}

Slim Framework

<?php
// bootstrap/app.php

use DI\Container;
use Sendgo\Php\Sendgo;

$container = new Container();
$container->set(Sendgo::class, fn() => new Sendgo([
    'access_key'       => $_ENV['SENDGO_ACCESS_KEY'],
    'secret_key'       => $_ENV['SENDGO_SECRET_KEY'],
    'kakao_sender_key' => $_ENV['SENDGO_KAKAO_KEY'],
    'api_version'      => 'v2',
]));

WordPress / WooCommerce

<?php

use Sendgo\Php\Sendgo;
use Sendgo\Php\Exception\SendgoException;

function get_sendgo(): Sendgo {
    static $instance = null;
    if ($instance === null) {
        $instance = new Sendgo([
            'access_key'       => get_option('sendgo_access_key'),
            'secret_key'       => get_option('sendgo_secret_key'),
            'kakao_sender_key' => get_option('sendgo_kakao_key'),
            'api_version'      => 'v2',
        ]);
    }
    return $instance;
}

// WooCommerce 주문 완료 시 알림톡 발송
add_action('woocommerce_order_status_completed', function (int $orderId) {
    $order = wc_get_order($orderId);
    try {
        get_sendgo()->alimtalk->send([
            'templateCode' => 'ORDER_CONFIRM_001',
            'contacts'     => [
                ['contact' => $order->get_billing_phone(), 'var1' => $order->get_order_number()],
            ],
        ]);
    } catch (SendgoException $e) {
        error_log("Sendgo 알림 실패: {$e->getMessage()}");
    }
});

---

예외 처리

<?php

use Sendgo\Php\Exception\SendgoException;

try {
    $sendgo->alimtalk->send([
        'templateCode' => 'ORDER_CONFIRM_001',
        'contacts'     => [['contact' => '01012345678']],
    ]);
} catch (SendgoException $e) {
    echo "발송 실패: HTTP {$e->getStatusCode()} [{$e->getErrorCode()}]" . PHP_EOL;

    match ($e->getErrorCode()) {
        'INVALID_ACCESS_KEY',
        'INVALID_SECRET_KEY'    => alertOps('Sendgo 인증키를 확인하세요.'),
        'INVALID_TEMPLATE_CODE' => logger('존재하지 않는 템플릿'),
        'PAYMENT_REQUIRED'      => alertOps('Sendgo 크레딧이 부족합니다.'),
        'IP_NOT_ALLOWED'        => alertOps('허용되지 않은 IP'),
        default                 => logger('알 수 없는 오류: ' . $e->getMessage()),
    };
}

---

설정 옵션

파라미터	타입	필수	기본값	설명
access_key	string	필수	—	Sendgo 액세스 키
secret_key	string	필수	—	Sendgo 시크릿 키
kakao_sender_key	string|null	선택	null	카카오 발신프로필 키
sms_sender_key	string|null	선택	null	SMS 발신자 키
api_version	string	선택	'v1'	API 버전 (v1 | v2)
url	string	선택	'https://sendgo.io'	API 기본 URL

---

짧은 URL

짧은 URL 은 메시지 본문의 링크를 줄이고, 그 링크가 실제로 눌렸는지 집계합니다. 문자는 바이트 수가 요금과 직결되므로 링크를 줄이면 그만큼 본문을 더 쓸 수 있습니다.

같은 원본 URL 을 다시 줄이면 기존 링크가 그대로 반환됩니다. 캠페인별로 반응을 따로 집계하려면 forceNew 로 새 코드를 만드세요.

deactivate 는 링크를 삭제하지 않고 리다이렉트만 중지합니다. 이미 발송한 메시지의 링크를 무효화할 때 쓰며, 누적 통계는 남고 이후 접속은 410 Gone 이 됩니다.

// 짧은 URL 생성 (v2 전용)
$short = $sendgo->shortUrl->create([
    'targetUrl' => 'https://example.com/promotions/summer-sale',
    'title'     => '여름 세일 랜딩',
]);

$link = $short['data']['shortUrl'];   // 문자/알림톡 본문에 넣을 짧은 링크
$code = $short['data']['code'];

// 반응 통계 — 일별 추이 + 디바이스/유입경로/국가별 분해
$stats = $sendgo->shortUrl->stats($code, ['from' => '2026-08-01']);

$sendgo->shortUrl->list(['count' => 10]);
$sendgo->shortUrl->show($code);
$sendgo->shortUrl->deactivate($code);   // 리다이렉트만 중지, 통계는 남는다

stats 는 일별 추이(daily)와 디바이스(byDevice)·유입경로(byReferer)·국가(byCountry)별 분해를 반환합니다. 일별 추이는 사전 집계 표에서 읽으므로 클릭이 많아도 응답 시간이 일정합니다.

관리 API — 채널·템플릿·발신번호 등록 (v2 전용)

발송은 처음부터 API였지만 등록과 심사는 콘솔에서만 되던 것들이 있었습니다. 1.3.0 부터 그 작업도 코드로 처리합니다.

서비스	하는 일	계정
$sendgo->kakaoSenders	카카오 채널 인증·등록·동기화, 브랜드메시지 M/N 신청	기업
$sendgo->noticeTemplates	알림톡 템플릿 CRUD, 검수 요청·취소, 승인 취소, 휴면 해제	기업
$sendgo->brandTemplates	브랜드메시지(구 친구톡) 템플릿 CRUD, 동기화, 가져오기	기업
$sendgo->senderRegistration	발신번호 등록 신청, 중복 확인, 유형 안내	개인·기업
$sendgo->messageTemplates	문자 상용구 템플릿 CRUD	개인·기업
$sendgo->kakaoImages	카카오 이미지 업로드 — 템플릿용 URL 발급	기업
$sendgo->rejectedNumbers	수신거부(080) 번호 조회	개인·기업
$sendgo->webhook	이벤트 웹훅 구독 — 심사 결과 수신	개인·기업

sendgo.io 콘솔에 들어올 일이 없습니다. 고객의 채널·발신번호·템플릿을 여러분 화면만으로 끝까지 처리할 수 있습니다. 휴대폰 발신번호는 콘솔의 PASS 본인인증 대신 신분증 사본(identityDocument)을 받아 sendgo 운영자가 대신 심사합니다.

사람이 개입하는 지점은 카카오 채널 인증번호 하나뿐이고, 그마저도 여러분 화면에서 입력받으면 됩니다 — 카카오가 관리자 휴대폰으로 직접 보내는 확인이라 없앨 수 없습니다.

심사가 붙는 것들은 비동기입니다. 등록 호출이 성공했다는 건 "접수됐다"는 뜻이지 "쓸 수 있다"는 뜻이 아닙니다 — 웹훅을 구독해 결과를 받으세요.

카카오 채널 등록

// 1단계 — 카카오가 관리자 휴대폰으로 인증번호를 SMS 발송한다 (응답에 번호는 없다)
$sendgo->kakaoSenders->requestToken('@my-channel', '01012345678');

// 2단계 — 사람이 받은 인증번호로 발신프로필 생성
$created = $sendgo->kakaoSenders->create([
    'token'        => '123456',
    'yellowId'     => '@my-channel',
    'phoneNumber'  => '01012345678',
    'categoryCode' => '001001',          // categories() 로 조회
]);

$kakaoSenderKey = $created['data']['sender']['kakaoSenderKey'];

$sendgo->kakaoSenders->categories();     // 카테고리 코드 목록
$sendgo->kakaoSenders->list();
$sendgo->kakaoSenders->sync();           // 전체 상태 동기화 (하루 한 번 권장)
$sendgo->kakaoSenders->sync($kakaoSenderKey);

채널이 카카오 쪽에서 차단되면 발송이 조용히 실패하기 시작합니다. sync() 를 주기적으로 돌리고 block: true 인 채널을 감시하세요.

알림톡 템플릿 등록과 검수

$created = $sendgo->noticeTemplates->create([
    'kakaoSenderKey'        => $kakaoSenderKey,
    'templateName'          => '주문 접수 안내',
    'templateContent'       => '#{name}님, 주문 #{orderNo}이 접수되었습니다.',
    'templateMessageType'   => 'BA',      // BA 기본형 / EX 부가정보형 / AD 채널추가형 / MI 복합형
    'templateEmphasizeType' => 'NONE',    // NONE / TEXT / ITEM_LIST / IMAGE
    'categoryCode'          => '001001',

    // sendgo 자체 정책 게이트 — 카카오 심사와 별개이며 빠뜨리면 거절된다
    'messagePurpose'        => 'order_delivery',
    'legalBasis'            => 'transaction',
    'benefitOrigin'         => 'none',
    'expiryType'            => 'none',
    'optInReviewConfirmed'  => true,
    'ctaClearConfirmed'     => true,
    'policyConfirmed'       => true,
]);

$code = $created['data']['template']['templateCode'];

// 검수 요청 — 증빙이 필요하면 파일도 붙인다 (첨부가 있으면 comment 필수)
$sendgo->noticeTemplates->requestInspection($code);
$sendgo->noticeTemplates->requestInspection($code, '주문 확인 화면 첨부', ['/path/to/proof.png']);

// 결과는 비동기다. 웹훅이 없으므로 폴링한다
$synced = $sendgo->noticeTemplates->sync($code);
$status = $synced['data']['template']['inspectionStatus'];  // REG → REQ → APR / REJ

정책 필드 조합이 본문과 어긋나면 저장 단계에서 POLICY_VALIDATION_FAILED 로 막힙니다. 응답 errors.reasons 에 사유가 한국어로 담기니 그대로 사용자에게 보여 주면 됩니다. 여기서 걸리는 문안은 카카오 심사에서도 거의 반려되므로, 며칠 기다렸다 반려당하는 것보다 즉시 아는 편이 낫습니다.

$sendgo->noticeTemplates->list(['kakaoSenderKey' => $kakaoSenderKey, 'inspectionStatus' => 'APR']);
$sendgo->noticeTemplates->show($code);
$sendgo->noticeTemplates->update($code, [...]);   // 본문이 바뀌면 재검수 필요
$sendgo->noticeTemplates->cancelInspection($code);
$sendgo->noticeTemplates->cancelApproval($code);
$sendgo->noticeTemplates->release($code);         // 휴면 해제
$sendgo->noticeTemplates->delete($code);          // sendgo 목록에서만 삭제된다
$sendgo->noticeTemplates->categories();

이미지 템플릿은 multipart 로 나갑니다.

$sendgo->noticeTemplates->createWithImage([
    'kakaoSenderKey' => $kakaoSenderKey,
    'templateName'   => '이벤트 안내',
    // ... 나머지 필드 동일
], '/path/to/banner.jpg');

삭제 동작이 채널마다 다릅니다. 알림톡 템플릿은 카카오에 삭제 API 가 없어 sendgo 목록에서만 빠지고 동기화하면 되살아납니다. 브랜드메시지 템플릿은 카카오 쪽에서도 실제로 삭제됩니다.

브랜드메시지 템플릿

알림톡과 달리 검수 요청 단계가 없습니다. templateType 은 친구톡 표기를 그대로 쓰고 서버가 chatBubbleType 으로 변환합니다.

$created = $sendgo->brandTemplates->create([
    'kakaoSenderKey'  => $kakaoSenderKey,
    'templateName'    => '여름 세일 안내',
    'templateType'    => 'FI',            // FT/FI/FW/FL/FC/FM/FP/FA
    'templateContent' => '여름 세일이 시작되었습니다.',
    'imageUrl'        => 'https://mud-kage.kakao.com/....jpg',
]);

// 동보 발송(targeting=F)에는 변수가 없는 템플릿만 쓸 수 있다
$created['data']['template']['containsVariables'];

$sendgo->brandTemplates->list(['kakaoSenderKey' => $kakaoSenderKey]);
$sendgo->brandTemplates->sync($templateCode);
$sendgo->brandTemplates->import($kakaoSenderKey);   // 카카오에 있는 템플릿 가져오기
$sendgo->brandTemplates->delete($templateCode);     // 카카오에서도 삭제된다

발신번호 등록 신청

// 계정 종류에 맞는 유형과 유형별 필수 서류
$types = $sendgo->senderRegistration->numberTypes();

// 형식·중복 미리 확인
$check = $sendgo->senderRegistration->validate('02-1234-5678', 'team_main');

$created = $sendgo->senderRegistration->create(
    [
        'senderAlias'      => '고객센터 대표번호',
        'senderNumberType' => 'team_main',   // personal_other / team_main / team_other_company
        'phoneE164'        => '02-1234-5678',
        // $check['data']['duplicationReasonRequired'] 가 true 면 필수
        // 'duplicationReason' => '부서별 분리 운영',
    ],
    ['csuCertificate' => '/path/to/csu.pdf'],
);

$created['data']['sender']['status'];   // PENDING — 운영자 승인 후 SUCCESS

$sendgo->senderRegistration->list();     // 심사 상태 확인
$sendgo->senderRegistration->update($senderKey, ['senderAlias' => '새 이름']);
$sendgo->senderRegistration->delete($senderKey);

휴대폰 유형도 API 로 접수할 수 있습니다. 콘솔의 PASS 본인인증 대신 신분증 사본(identityDocument)을 첨부하면 sendgo 운영자가 직접 확인합니다. 이 경로로 접수된 건은 응답의 identityVerificationMethod 가 document 이고 자동 승인되지 않습니다 — 운영자 확인 전까지 PENDING 입니다.

유형별 필수 서류는 numberTypes() 응답의 requiredDocuments 로 확인하세요. 반려되면 rejectionReason 에 사유가 담깁니다.

문자 템플릿

$sendgo->messageTemplates->create([
    'messageTranType'    => 'LMS',
    'messageTranSubject' => '주문 안내',    // LMS·MMS 는 필수
    'messageTranMsg'     => '주문이 접수되었습니다.',
]);

$sendgo->messageTemplates->list(['messageType' => 'LMS']);
$sendgo->messageTemplates->update($templateKey, [...]);
$sendgo->messageTemplates->delete($templateKey);

이벤트 웹훅 — 심사 결과를 밀어 받기

등록·심사는 비동기입니다. 구독해 두면 폴링하지 않아도 됩니다.

$created = $sendgo->webhook->subscribe('https://reseller.example.com/hooks/sendgo');

// 시크릿은 이 응답에서 한 번만 나온다. 즉시 저장한다.
$secret = $created['data']['secret'];

$sendgo->webhook->show();          // 구독 설정 + 마지막 전송 결과
$sendgo->webhook->test();          // 배선 확인
$sendgo->webhook->unsubscribe();

받는 쪽에서는 원본 바이트로 서명을 검증합니다.

$raw = file_get_contents('php://input');

if (! Sendgo\Php\WebhookService::verifySignature($raw, $_SERVER['HTTP_X_SENDGO_SIGNATURE'] ?? '', $secret)) {
    http_response_code(401);
    exit;
}

$payload = json_decode($raw, true);
// $payload['event'] — sender.status_changed / notice_template.inspection_status_changed / ...

이벤트: sender.status_changed, notice_template.inspection_status_changed, kakao_sender.status_changed, kakao_sender.brand_message_status_changed.

카카오 이미지 업로드

브랜드메시지 템플릿의 imageUrl 은 카카오가 호스팅하는 URL 이어야 합니다.

$uploaded = $sendgo->kakaoImages->upload('default', '/path/to/banner.jpg');

$sendgo->brandTemplates->create([
    'kakaoSenderKey' => $kakaoSenderKey,
    'templateName'   => '여름 세일 안내',
    'templateType'   => 'FI',
    'imageUrl'       => $uploaded['data']['imageUrl'],
]);

// 캐러셀·와이드 아이템 리스트는 여러 장을 한 번에
$sendgo->kakaoImages->uploadMany('carousel_feed', ['/a.jpg', '/b.jpg', '/c.jpg']);
$sendgo->kakaoImages->types();   // 유형별 필드·최대 개수

수신거부(080) 동기화

// 증분만 가져간다. 하루 한 번이면 충분하다.
$sendgo->rejectedNumbers->list(['since' => '2026-09-01', 'count' => 500]);

---

변경 사항

1.3.0 (2026-09-11)

• 관리 API 추가 — 콘솔에서만 되던 등록·심사를 코드로 처리합니다. $sendgo->kakaoSenders(채널 인증·등록·동기화, 브랜드메시지 M/N 신청), $sendgo->noticeTemplates(알림톡 템플릿 CRUD·검수 요청·승인 취소·휴면 해제), $sendgo->brandTemplates(브랜드메시지 템플릿 CRUD·동기화·가져오기), $sendgo->senderRegistration(발신번호 등록 신청·중복 확인·유형 안내), $sendgo->messageTemplates(문자 상용구 템플릿 CRUD).
• HttpClient 에 put()·patch()·postMultipart() 를 추가했습니다. 서류 첨부와 이미지 템플릿은 JSON 으로 보낼 수 없습니다.
• 휴대폰 발신번호도 API 로 접수됩니다. 콘솔의 PASS 본인인증 대신 identityDocument(신분증 사본)를 첨부하면 sendgo 운영자가 확인합니다. 이 경로는 자동 승인되지 않고 항상 PENDING 으로 시작합니다.
• 리셀러는 sendgo.io 콘솔에 들어올 일이 없습니다. 사람이 개입하는 지점은 카카오 채널 인증번호 하나뿐이고, 그것도 리셀러 화면에서 입력받으면 됩니다.
• 이벤트 웹훅 추가 — 발신번호 승인, 알림톡 검수 결과, 채널 차단, 브랜드메시지 타겟팅 결과를 구독해 받습니다. 서명은 받은 원본 바이트로 검증합니다(SDK 에 검증 헬퍼 포함).
• 카카오 이미지 업로드 추가 — 브랜드메시지 템플릿의 imageUrl 은 카카오가 호스팅하는 URL 이어야 하는데, 그 URL 을 얻는 길이 콘솔에만 있었습니다.
• 수신거부(080) 조회 추가 — 자기 DB 의 수신 상태를 맞출 수 있습니다.

1.2.1 (2026-08-14)

• 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다. npm/PyPI/Packagist/Maven/NuGet/RubyGems 검색 결과에 그대로 찍히는 문자열이라 종료된 채널을 계속 홍보하고 있었습니다.
• 검색 키워드에 brand-message 를 추가했습니다 (friendtalk 은 유입 검색어라 유지).

1.2.0 (2026-08-14)

• 친구톡 Deprecated 표기 — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었고, 2026-01-01 부터 발송 요청이 브랜드메시지(자유형)로 자동 대체 발송됩니다. 관련 API 에 각 언어의 표준 deprecation 표기를 달았습니다.
• 자유 본문 타입(FT/FI/FW)의 개별 발송 경로는 아직 친구톡 API 뿐이라는 점을 문서에 명시했습니다 — 브랜드메시지 API 는 그 조합에 NOT_A_BRAND_MESSAGE 를 반환합니다.
• 브랜드메시지 전환 안내와 메시지 타입 1:1 대응표를 README 에 추가했습니다.

1.1.0 (2026-08-11)

• 짧은 URL 추가 — $sendgo->shortUrl (생성/목록/상세/반응통계/중지)
• HttpClient::delete() 추가
• Sendgo::__call 에 shortUrl/short_url 포워딩 추가 (Laravel 파사드 대응)

라이선스

MIT License © 2026 Sendgo

---

패키지 정보

• 패키지: sendgo/php (Packagist)
• 저장소: send-go/php
• 레지스트리: https://packagist.org/packages/sendgo/php
• 라이선스: MIT

API 키 발급 방법

샌드고에 로그인한 뒤 연동하기 → 연동 정보 메뉴에서 액세스 키와 시크릿 키를 발급받고, 같은 화면에서 호출을 허용할 IP 를 등록합니다 — 등록되지 않은 주소에서 온 요청은 거부됩니다. 알림톡·브랜드메시지를 사용하려면 발신프로필 관리 메뉴에서 발신프로필을 등록해 kakao_sender_key를 발급받고, 문자를 사용하려면 발신번호 관리 메뉴에서 발신번호를 등록해야 합니다.