Download the PHP package techigh/sendgo-notification without Composer
On this page you can find all versions of the php package techigh/sendgo-notification. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download techigh/sendgo-notification
More information about techigh/sendgo-notification
Files in techigh/sendgo-notification
Download techigh/sendgo-notification
More information about techigh/sendgo-notification
Files in techigh/sendgo-notification
Vendor techigh
Package sendgo-notification
Short Description Notification Package for Laravel
License MIT
Package sendgo-notification
Short Description Notification Package for Laravel
License MIT
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
Informations about the package sendgo-notification
SendGo Notification — Laravel 카카오톡·SMS 연동 패키지
Laravel에서 카카오 알림톡, 친구톡, SMS / LMS / MMS를 전송하는 공식 Notification 패키지입니다. SendGo.io API v1 / v2를 모두 지원합니다.
목차
- 요구사항
- 설치
- 환경 설정
- 사용 방법
- 수신자 전달 방식
- 알림톡 (AlimTalk)
- 친구톡 (FriendTalk)
- SMS / LMS / MMS
- 예제 문서
- 변경 이력
- 예외 처리
- 큐 비동기 발송
- v1 → v2 마이그레이션
- 에러 코드
- 트러블슈팅
요구사항
- PHP 8.2+
- Laravel 8.x | 9.x | 10.x | 11.x
- SendGo 계정 (sendgo.io)
설치
설정 파일 발행 (선택):
환경 설정
.env 파일에 추가:
API 키는 SendGo.io 콘솔 → 연동 정보에서 확인할 수 있습니다.
사용 방법
수신자 전달 방식
to(array $to)는 단일 수신자 전용입니다.
여러 수신자를 한 번에 보내려면 toMany(array $to)를 사용해야 합니다.
각 수신자 항목은 contact를 필수로 가지며, 필요에 따라 name, var1~var8를 추가할 수 있습니다.
toMany()는 Laravel Notification 채널에서는 사용할 수 없고, Sms, AlimTalk, FriendTalk 서비스를 직접 호출하는 경우에만 지원됩니다.
Notification 채널에서 toMany()를 사용하면 MULTIPLE_RECIPIENTS_NOT_SUPPORTED_IN_NOTIFICATION 예외가 발생합니다.
알림톡 (AlimTalk)
사전 승인된 템플릿으로 공식 비즈니스 메시지를 전송합니다.
AlimTalk 메서드
| 메서드 | 필수 | 설명 |
|---|---|---|
templateCode(string) |
✅ | SendGo에서 승인받은 템플릿 코드 |
scheduleType(string) |
'DIRECTLY'(기본) 또는 'SCHEDULED' |
|
replaceSms(string) |
알림톡 실패 시 SMS 대체 ('N' 기본) |
|
smsTitle(string) |
조건부 | 대체 SMS 제목 (replaceSms 'Y'일 때 필수) |
smsContent(string) |
조건부 | 대체 SMS 내용 (replaceSms 'Y'일 때 필수) |
to(array) |
✅ | 단일 수신자 정보 (contact 필수, name / var1~var8 선택) |
toMany(array) |
배치 전용 | 다중 수신자 정보. Notification 채널에서는 사용 불가 |
at(string\|null) |
조건부 | 예약 시각 (SCHEDULED일 때 필수, Y-m-d H:i:s) |
더 많은 예제 → examples/AlimTalk.md
친구톡 (FriendTalk)
카카오톡 채널 친구에게 자유로운 형태의 메시지를 전송합니다.
메시지 타입
| 타입 | 설명 |
|---|---|
FT |
텍스트형 |
FI |
이미지형 |
FW |
와이드 이미지형 (wide('Y') 필수) |
FL |
와이드 아이템 리스트형 |
FM |
커머스형 |
FC |
캐러셀 피드형 |
FA |
캐러셀 커머스형 |
FP |
프리미엄 동영상형 |
FriendTalk 메서드
| 메서드 | 필수 | 설명 |
|---|---|---|
messageType(string) |
✅ | 메시지 타입 |
content(string) |
✅ | 메시지 내용 |
scheduleType(string) |
'DIRECTLY'(기본) 또는 'SCHEDULED' |
|
imageUrl(string) |
이미지 URL | |
imageLink(string) |
이미지 클릭 링크 | |
buttons(array) |
버튼 배열 | |
wide(string) |
조건부 | 와이드 이미지 여부 (FW일 때 'Y' 필수) |
adFlag(string) |
광고성 메시지 표기 ('N' 기본) |
|
replaceSms(string) |
친구톡 실패 시 SMS 대체 | |
smsTitle(string) |
조건부 | 대체 SMS 제목 |
smsContent(string) |
조건부 | 대체 SMS 내용 |
to(array) |
✅ | 단일 수신자 정보 |
toMany(array) |
배치 전용 | 다중 수신자 정보. Notification 채널에서는 사용 불가 |
at(string\|null) |
조건부 | 예약 시각 |
더 많은 예제 → examples/FriendTalk.md
SMS / LMS / MMS
LMS (장문, subject 필수):
MMS (subject + files 필수, 최대 3개):
SMS 메서드
| 메서드 | 필수 | 설명 |
|---|---|---|
messageType(string) |
✅ | 'SMS' / 'LMS' / 'MMS' |
content(string) |
✅ | 메시지 내용 |
campaignType(string) |
'MESSAGE' (기본값) |
|
scheduleType(string) |
'DIRECTLY'(기본) 또는 'SCHEDULED' |
|
subject(string) |
조건부 | 제목 (LMS / MMS 필수) |
files(array) |
조건부 | 파일 경로 배열 (MMS 필수, 최대 3개) |
to(array) |
✅ | 단일 수신자 정보 (contact 필수, var1~var8 선택) |
toMany(array) |
배치 전용 | 다중 수신자 정보. Notification 채널에서는 사용 불가 |
at(string\|null) |
조건부 | 예약 시각 |
더 많은 예제 → examples/SMS.md
예제 문서
- 알림톡 예제
- 친구톡 예제
- SMS 예제
변경 이력
- CHANGELOG.md
예외 처리
모든 발송 실패는 SendGoException으로 던져집니다.
큐 비동기 발송
ShouldQueue를 구현하면 Laravel 큐로 비동기 처리됩니다.
다중 queue worker 환경에서는
redis또는database캐시 드라이버를 사용해야 토큰 캐시가 공유됩니다.
v1 → v2 마이그레이션
Notification 코드 변경 없이 .env 한 줄만 바꾸면 됩니다.
v2 주요 차이점:
| 항목 | v1 | v2 |
|---|---|---|
| 토큰 형식 | base64 인코딩 | 그대로 사용 (sgv2. prefix) |
| 토큰 재발급 | 401/403 무조건 재발급 | 에러 코드별 분기 (설정 오류는 재발급 안 함) |
| 에러 응답 | — | code / message / traceId 포함 |
v2 에러 코드 전체 목록 → API_V2_ERROR_CODES.md
에러 코드
SendGoException::context()['error_code']로 확인합니다.
인증 (401)
| 코드 | 설명 |
|---|---|
INVALID_AUTH_HEADER |
Authorization 헤더 없음 |
INVALID_BASIC_AUTH |
Basic 인증 형식 오류 |
INVALID_BASIC_AUTH_PAYLOAD |
Basic 인증 페이로드 오류 |
INVALID_ACCESS_KEY |
유효하지 않은 Access Key |
INVALID_SECRET_KEY |
유효하지 않은 Secret Key |
INVALID_BEARER_TOKEN |
Bearer 토큰 없음 |
INVALID_BEARER_TOKEN_PREFIX |
Bearer 토큰 prefix 오류 (v2) |
INVALID_BEARER_TOKEN_PAYLOAD |
Bearer 토큰 페이로드 오류 (v2) |
INVALID_BEARER_SIGNATURE |
Bearer 토큰 서명 불일치 (v2) |
INVALID_BEARER_APPLICATION |
토큰에 해당하는 앱 없음 (v2) |
MALFORMED_BEARER_TOKEN |
잘못된 형식의 Bearer 토큰 (v2) |
UNSUPPORTED_BEARER_TOKEN_VERSION |
지원하지 않는 토큰 버전 (v2) |
TOKEN_MISMATCH |
발급된 토큰과 불일치 (v2) |
TOKEN_EXPIRED |
만료된 토큰 (자동 재발급 처리) |
TOKEN_RECORD_NOT_FOUND |
토큰 레코드 없음 (v2) |
권한 (403)
| 코드 | 설명 |
|---|---|
ACCESS_KEY_NOT_APPROVED |
미승인 Access Key |
IP_NOT_ALLOWED |
허용되지 않은 IP |
TEAM_REQUIRED_FOR_KAKAO |
카카오 API는 팀 소속 앱만 사용 가능 |
SENDER_APPLICATION_MISMATCH |
SMS 발신키가 앱과 불일치 |
KAKAO_SENDER_APPLICATION_MISMATCH |
카카오 발신키가 앱과 불일치 |
리소스 (404)
| 코드 | 설명 |
|---|---|
INVALID_SENDER_KEY |
유효하지 않은 SMS 발신키 |
INVALID_KAKAO_SENDER_KEY |
유효하지 않은 카카오 발신키 |
INVALID_TEMPLATE_CODE |
유효하지 않은 템플릿 코드 |
OWNER_NOT_FOUND |
캠페인 소유자 확인 불가 |
SENDER_OWNER_NOT_FOUND |
SMS 발신키 소유자 확인 불가 |
KAKAO_SENDER_OWNER_NOT_FOUND |
카카오 발신키 소유자 확인 불가 |
요청 (422)
| 코드 | 설명 |
|---|---|
EMPTY_CONTACTS |
수신자 없음 |
PAYMENT_REQUIRED |
크레딧 부족 |
MESSAGE_PROCESSING_FAILED |
SMS/MMS 처리 실패 |
NOTICE_PROCESSING_FAILED |
알림톡 처리 실패 |
FRIEND_PROCESSING_FAILED |
친구톡 처리 실패 |
패키지 내부
| 코드 | 설명 |
|---|---|
INVALID_API_VERSION |
지원하지 않는 API 버전 |
MULTIPLE_RECIPIENTS_NOT_SUPPORTED_IN_NOTIFICATION |
Laravel Notification 채널에서 toMany() 사용 불가 |
v2 에러 코드 상세 → API_V2_ERROR_CODES.md
트러블슈팅
메시지가 전송되지 않을 때
.envAPI 키 확인- SendGo 계정 잔액 확인
- 전화번호 형식 확인 (
01012345678, 하이픈 제외) storage/logs/laravel.log에러 확인
알림톡이 SMS로 대체 발송될 때
- SendGo에서 템플릿 승인 상태 확인
- 템플릿 변수 매핑 확인
- 카카오 채널 연동 상태 확인
다중 워커에서 토큰 충돌이 발생할 때
CACHE_DRIVER=redis로 변경 (공유 캐시 필수)
INVALID_API_VERSION 에러
SENDGO_API_VERSION값이v1또는v2인지 확인
라이선스
MIT — LICENSE 참조
All versions of sendgo-notification with dependencies
PHP Build Version
Package Version
The package techigh/sendgo-notification contains the following files
Loading the files please wait ...