PHPackages                             techigh/credit-messaging - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. techigh/credit-messaging

ActiveLibrary[Utility & Helpers](/categories/utility)

techigh/credit-messaging
========================

A comprehensive credit-based messaging system for Laravel with multi-tenant support, smart routing, and automatic settlement

v1.1.3(1y ago)05MITPHPPHP ^8.1

Since May 31Pushed 1y agoCompare

[ Source](https://github.com/taekwanpark/credit-messaging)[ Packagist](https://packagist.org/packages/techigh/credit-messaging)[ RSS](/packages/techigh-credit-messaging/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (7)Versions (19)Used By (0)

📦 Techigh Credit Messaging
==========================

[](#-techigh-credit-messaging)

> 크레딧 기반 알림톡/SMS 발송 시스템 - Laravel 멀티테넌트 지원 패키지

[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE.md)[![PHP Version](https://camo.githubusercontent.com/acffb6ae1962992d26e4466782832787e79504a6250f80d732c4283458b9f497/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e312d626c75652e737667)](https://www.php.net/)[![Laravel](https://camo.githubusercontent.com/552ea80ea7c6f1343f4a9d615105686241f5cb554891af2271f54aa4305d0ce9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d25354531302e3025374325354531312e302d7265642e737667)](https://laravel.com/)[![Orchid Platform](https://camo.githubusercontent.com/fcd4924d05fafc54ee5bf5942fb1090c4f1d684a456b15dee3e22c5dcf9a4505/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f72636869642d25354531342e302d707572706c652e737667)](https://orchid.software/)

🚀 소개
----

[](#-소개)

**Techigh Credit Messaging**은 Laravel 기반의 크레딧 기반 메시징 시스템으로, 멀티테넌트 환경에서 알림톡과 SMS 발송을 통합 관리할 수 있는 포괄적인 솔루션입니다.

### ✨ 주요 특징

[](#-주요-특징)

- 🏢 **멀티테넌트 지원**: Universal, Tenant, Central 모드
- 💳 **크레딧 시스템**: 메시지 유형별 차등 단가 및 자동 정산
- 🔄 **스마트 라우팅**: 알림톡 실패 시 SMS 자동 대체 발송
- 🎯 **Orchid 통합**: 관리자 패널을 통한 직관적인 관리
- 📊 **실시간 통계**: 발송 현황 및 크레딧 사용량 모니터링
- 🔗 **외부 연동**: SendGo 메시지 플랫폼 및 Toss Payments 결제

---

📋 요구사항
------

[](#-요구사항)

- **PHP**: ^8.1
- **Laravel**: ^10.0 | ^11.0
- **Orchid Platform**: ^14.0
- **Dependencies**: GuzzleHTTP, Ramsey UUID

---

🔧 설치
----

[](#-설치)

### 1. Composer 설정

[](#1-composer-설정)

`composer.json` 파일의 `repositories` 섹션에 다음을 추가하세요:

```
{
    "repositories": {
        "techigh/credit-messaging": {
            "type": "vcs",
            "url": "https://github.com/taekwanpark/credit-messaging.git"
        }
    }
}
```

### 2. 패키지 설치

[](#2-패키지-설치)

`composer.json` 파일의 `require` 섹션에 다음을 추가하세요:

```
{
    "require": {
        "techigh/credit-messaging": "^1.1.4"
    }
}
```

그리고 Composer 설치를 실행하세요:

```
composer install
# 또는
composer update techigh/credit-messaging
```

### 3. 설정 파일 발행

[](#3-설정-파일-발행)

> **참고**: Laravel의 Package Auto-Discovery 기능으로 서비스 프로바이더와 Facade가 자동으로 등록됩니다.

```
php artisan vendor:publish --provider="Techigh\CreditMessaging\Providers\CreditMessagingServiceProvider" --tag="config"
```

### 4. 마이그레이션 파일 발행

[](#4-마이그레이션-파일-발행)

```
php artisan vendor:publish --provider="Techigh\CreditMessaging\Providers\CreditMessagingServiceProvider" --tag="migrations"
```

### 5. 마이그레이션 실행

[](#5-마이그레이션-실행)

```
php artisan migrate

php artisan tenants:migrate
```

### 6. 웹훅 시크릿 생성

[](#6-웹훅-시크릿-생성)

```
php artisan credit-messaging:generate-webhook-secret
```

---

⚙️ 환경 설정
--------

[](#️-환경-설정)

`.env` 파일에 다음 설정을 추가하세요:

```
# =============================================================================
# Credit Messaging 기본 설정
# =============================================================================

# 라우팅 모드 (tenant|central|universal)
CREDIT_MESSAGING_ROUTE_MODE=tenant

# =============================================================================
# SendGo 메시지 플랫폼 연동
# =============================================================================

MESSAGE_PLATFORM_ACCESS_KEY=your_access_key_here
MESSAGE_PLATFORM_SECRET_KEY=your_secret_key_here
MESSAGE_PLATFORM_SMS_SENDER_KEY=your_sms_sender_key_here
MESSAGE_PLATFORM_KAKAO_SENDER_KEY=your_kakao_sender_key_here

# =============================================================================
# 웹훅 설정
# =============================================================================

# 웹훅 시크릿 (필수 - 위 명령어로 생성)
CREDIT_MESSAGING_WEBHOOK_SECRET=generated_secret_key_here

# 웹훅 검증 설정
WEBHOOK_VERIFY_SIGNATURE=true
WEBHOOK_LOG_ERRORS=true
WEBHOOK_TIMEOUT=30
WEBHOOK_RETRY_ATTEMPTS=3

# =============================================================================
# 기본 크레딧 단가 설정 (KRW)
# =============================================================================

DEFAULT_ALIMTALK_COST=8.00
DEFAULT_SMS_COST=15.00
DEFAULT_LMS_COST=45.00
DEFAULT_MMS_COST=120.00

# =============================================================================
# 메시지 제한 설정
# =============================================================================

MAX_RECIPIENTS_PER_BATCH=1000
```

---

🎯 사용법
-----

[](#-사용법)

### Facade를 통한 메시지 발송

[](#facade를-통한-메시지-발송)

```