From bd6f1c4b60b59796e62dc8909db517a9b3b0077c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?= Date: Sat, 14 Feb 2026 14:34:45 +0900 Subject: [PATCH] =?UTF-8?q?feat:=EC=B9=B4=EC=B9=B4=EC=98=A4=ED=86=A1=20?= =?UTF-8?q?=EC=82=AC=EC=9A=A9=EB=B2=95=20=EA=B0=80=EC=9D=B4=EB=93=9C=20?= =?UTF-8?q?=ED=8E=98=EC=9D=B4=EC=A7=80=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 알림톡/친구톡 비교, 준비사항, 채널/템플릿/발송/전송내역 사용법 - FAQ 섹션 포함 (초보자 친화적 설명) Co-Authored-By: Claude Opus 4.6 --- .../Barobill/KakaotalkController.php | 12 + .../views/barobill/kakaotalk/guide.blade.php | 553 ++++++++++++++++++ routes/web.php | 1 + 3 files changed, 566 insertions(+) create mode 100644 resources/views/barobill/kakaotalk/guide.blade.php diff --git a/app/Http/Controllers/Barobill/KakaotalkController.php b/app/Http/Controllers/Barobill/KakaotalkController.php index 6fe10865..91181760 100644 --- a/app/Http/Controllers/Barobill/KakaotalkController.php +++ b/app/Http/Controllers/Barobill/KakaotalkController.php @@ -90,4 +90,16 @@ public function history(Request $request): View|Response return view('barobill.kakaotalk.history.index', compact('currentTenant', 'barobillMember')); } + + /** + * 사용법 가이드 + */ + public function guide(Request $request): View|Response + { + if ($request->header('HX-Request')) { + return response('', 200)->header('HX-Redirect', route('barobill.kakaotalk.guide')); + } + + return view('barobill.kakaotalk.guide'); + } } diff --git a/resources/views/barobill/kakaotalk/guide.blade.php b/resources/views/barobill/kakaotalk/guide.blade.php new file mode 100644 index 00000000..b4706ba7 --- /dev/null +++ b/resources/views/barobill/kakaotalk/guide.blade.php @@ -0,0 +1,553 @@ +@extends('layouts.app') + +@section('title', '카카오톡 서비스 사용법') + +@section('content') +
+ +
+
+ 카카오톡 + + 사용법 +
+

카카오톡 서비스 사용법

+

알림톡/친구톡을 처음 사용하시는 분을 위한 안내서입니다.

+
+ + +
+

+ + 목차 +

+ +
+ +
+ + +
+
+

+ 1 + 알림톡과 친구톡이란? +

+ +
+ +
+
+ + + +

알림톡

+
+
    +
  • + + 정보성 메시지를 보내는 서비스 +
    • +
  • + + 카카오에서 승인받은 템플릿만 사용 가능 +
    • +
  • + + 친구 추가 없이도 전화번호만으로 발송 +
    • +
  • + + 예: 주문확인, 배송안내, 결제완료 등 +
    • +
+
+ + +
+
+ + + +

친구톡

+
+
    +
  • + + 광고/마케팅 메시지를 보내는 서비스 +
    • +
  • + + 템플릿 없이 자유롭게 내용 작성 가능 +
    • +
  • + + 채널을 친구 추가한 사용자에게만 발송 +
    • +
  • + + 이미지 첨부 가능 (일반/와이드) +
    • +
+
+
+ +
+

한눈에 비교

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
구분알림톡친구톡
용도정보성 알림광고/마케팅
템플릿필수 (사전 승인)불필요 (자유 작성)
수신 대상전화번호만 있으면 OK채널 친구만
이미지불가가능
SMS 대체발송가능가능
+
+
+
+
+ + +
+
+

+ 2 + 시작하기 전 준비사항 +

+ +
+
+
!
+
+

카카오톡 서비스를 사용하려면 아래 3가지가 필요합니다

+

하나라도 빠지면 발송이 불가하니 꼭 확인해주세요.

+
+
+ +
+
+
+ +
+

1. 바로빌 회원사 등록

+

+ 회원사관리 메뉴에서 사업자번호와 바로빌 계정이 등록되어 있어야 합니다. +

+
+
+
+ +
+

2. 카카오톡 채널 등록

+

+ 채널관리에서 바로빌에 카카오톡 채널을 등록해야 합니다. (바로빌 사이트에서 진행) +

+
+
+
+ +
+

3. 알림톡 템플릿 등록

+

+ 알림톡을 사용하려면 템플릿관리에서 템플릿을 등록하고 카카오 승인을 받아야 합니다. +

+
+
+ +
+

+ 참고: 친구톡은 템플릿이 필요 없습니다. 채널만 등록되어 있으면 바로 사용 가능합니다. +

+
+
+
+
+ + +
+
+

+ 3 + 채널 관리 + 바로가기 → +

+ +
+

카카오톡 채널은 메시지를 발송하는 발신자 프로필입니다. 수신자에게 회사 이름으로 메시지가 표시됩니다.

+ +
+

채널 등록 방법

+
    +
  1. + 1 + 채널관리 페이지에서 "채널 관리 (바로빌)" 버튼을 클릭합니다. +
    2. +
  2. + 2 + 바로빌 사이트가 새 창으로 열립니다. 안내에 따라 카카오톡 채널을 등록합니다. +
    3. +
  3. + 3 + 등록 완료 후, 채널관리 페이지에서 "새로고침" 버튼을 눌러 채널 목록을 확인합니다. +
    4. +
+
+ +
+

+ Tip: 카카오톡 채널은 카카오 비즈니스에서 먼저 개설한 뒤, 바로빌에 연동하는 방식입니다. +

+
+
+
+
+ + +
+
+

+ 4 + 템플릿 관리 + 바로가기 → +

+ +
+

알림톡은 반드시 카카오에서 승인받은 템플릿으로만 발송할 수 있습니다. 승인까지 보통 1~2 영업일이 소요됩니다.

+ +
+

템플릿 등록 방법

+
    +
  1. + 1 + 템플릿관리 페이지에서 "템플릿 관리 (바로빌)" 버튼을 클릭합니다. +
    2. +
  2. + 2 + 바로빌 사이트에서 새 템플릿을 작성합니다. 템플릿명, 내용, 버튼 등을 입력합니다. +
    3. +
  3. + 3 + 작성 후 검수 요청을 합니다. 카카오에서 승인되면 상태가 승인으로 변경됩니다. +
    4. +
  4. + 4 + 승인된 템플릿만 발송 페이지의 템플릿 목록에 나타납니다. +
    5. +
+
+ +
+

템플릿 상태 안내

+
+ 심사중 카카오 검수 대기 + 승인 발송 가능 + 반려 수정 후 재신청 필요 +
+
+ +
+

+ Tip: 템플릿 내용에 #{변수명}을 넣으면 발송 시 실제 값으로 치환됩니다.
+ 예: #{고객명}님, 주문하신 상품이 발송되었습니다. +

+
+
+
+
+ + +
+
+

+ 5 + 알림톡 발송하기 + 바로가기 → +

+ +
+
+

발송 순서

+
    +
  1. + 1 +
    + 채널 선택 +

    메시지를 발송할 카카오톡 채널을 선택합니다.

    +
    +
    2. +
  2. + 2 +
    + 템플릿 선택 +

    승인된 템플릿을 선택하면 메시지 내용이 자동으로 채워집니다.

    +
    +
    3. +
  3. + 3 +
    + 수신자 정보 입력 +

    수신자 이름과 전화번호를 입력합니다. (하이픈 없이 숫자만)

    +
    +
    4. +
  4. + 4 +
    + SMS 대체발송 설정 (선택) +

    체크하면 카카오톡 발송 실패 시 자동으로 SMS가 발송됩니다.

    +
    +
    5. +
  5. + 5 +
    + 발송 +

    "알림톡 발송" 버튼을 클릭합니다. 성공하면 전송키가 표시됩니다.

    +
    +
    6. +
+
+ +
+

+ 예약 발송: "예약 발송" 항목에 날짜/시간을 지정하면 해당 시간에 자동 발송됩니다. 비워두면 즉시 발송됩니다. +

+
+
+
+
+ + +
+
+

+ 6 + 친구톡 발송하기 + 바로가기 → +

+ +
+

발송 페이지에서 상단의 "친구톡" 탭을 클릭하여 전환합니다.

+ +
+

발송 순서

+
    +
  1. + 1 +
    + 채널 선택 +

    발송할 카카오톡 채널을 선택합니다.

    +
    +
    2. +
  2. + 2 +
    + 발송 유형 선택 +

    텍스트 (글만), 이미지 (500x250px), 와이드 이미지 (800x400px) 중 선택합니다.

    +
    +
    3. +
  3. + 3 +
    + 수신자 정보 + 메시지 입력 +

    친구톡은 자유롭게 메시지를 작성할 수 있습니다.

    +
    +
    4. +
  4. + 4 +
    + 버튼 설정 (선택) +

    "+ 버튼 추가"를 클릭하여 웹링크, 앱링크 등의 버튼을 추가할 수 있습니다.

    +
    +
    5. +
  5. + 5 +
    + 광고 여부 체크 +

    광고성 메시지라면 반드시 체크해주세요. (법적 의무사항)

    +
    +
    6. +
+
+ +
+

+ 주의: 친구톡은 채널을 친구 추가한 사용자에게만 발송됩니다. 친구가 아닌 번호로 발송하면 실패합니다. +

+
+
+
+
+ + +
+
+

+ 7 + 전송내역 확인하기 + 바로가기 → +

+ +
+

메시지 발송 후 받게 되는 전송키를 사용하여 발송 결과를 확인할 수 있습니다.

+ +
+

사용 방법

+
    +
  • + + 전송키 입력란에 전송키를 입력하고 "조회" 버튼을 클릭합니다. +
    • +
  • + + 여러 건을 한번에 조회하려면 쉼표(,)로 구분하여 입력합니다. +
    • +
  • + + 예약 발송 취소: 아직 발송되지 않은 예약 건은 "예약취소" 버튼으로 취소할 수 있습니다. +
    • +
+
+ +
+

전송 상태 안내

+
+ 대기 발송 준비 중 + 전송중 발송 진행 중 + 성공 발송 완료 + 실패 발송 실패 +
+
+
+
+
+ + +
+
+

+ 8 + 자주 묻는 질문 (FAQ) +

+ +
+
+ + Q. 알림톡 발송이 실패합니다. + + +
+

아래 사항을 순서대로 확인해주세요:

+
    +
  • 바로빌 회원사가 등록되어 있는지 확인
    • +
  • 카카오톡 채널이 정상 상태인지 확인
    • +
  • 사용한 템플릿이 "승인" 상태인지 확인
    • +
  • 수신자 전화번호가 올바른지 확인 (하이픈 없이 숫자만)
    • +
  • 바로빌 충전 잔액이 충분한지 확인
    • +
+
+
+ +
+ + Q. 친구톡을 보냈는데 상대방이 못 받았습니다. + + +
+

친구톡은 카카오톡 채널을 친구 추가한 사용자에게만 발송됩니다. 상대방이 채널을 친구 추가했는지 확인해주세요. 친구가 아닌 경우 SMS 대체발송을 활성화하면 문자로 전송됩니다.

+
+
+ +
+ + Q. SMS 대체발송이란 무엇인가요? + + +
+

카카오톡 발송에 실패했을 때 (수신자가 카카오톡 미사용, 수신거부 등) 자동으로 SMS/LMS로 대신 발송하는 기능입니다. 발송 폼에서 "SMS 대체발송"을 체크하고 SMS 메시지를 입력하면 됩니다. 90바이트를 초과하면 자동으로 LMS로 발송됩니다.

+
+
+ +
+ + Q. 예약 발송을 취소할 수 있나요? + + +
+

네, 전송내역 페이지에서 전송키로 조회한 후, 상태가 "대기"인 건은 "예약취소" 버튼으로 취소할 수 있습니다. 이미 발송된 건은 취소할 수 없습니다.

+
+
+ +
+ + Q. 대량 발송은 어떻게 하나요? + + +
+

현재 화면에서는 단건 발송만 지원합니다. 대량 발송이 필요한 경우 시스템 관리자에게 문의해주세요. API를 통해 한 번에 여러 건을 발송할 수 있는 기능이 준비되어 있습니다.

+
+
+ +
+ + Q. 발송 비용은 얼마인가요? + + +
+

바로빌 충전 잔액에서 차감됩니다. 요금은 바로빌 요금 정책에 따르며, 알림톡과 친구톡의 단가가 다릅니다. SMS 대체발송 시 추가 비용이 발생합니다. 잔액은 회원사관리에서 확인할 수 있습니다.

+
+
+
+
+
+ + +
+

바로 시작하기

+
+ 채널 관리 + 템플릿 관리 + 메시지 발송 + 전송내역 +
+
+ +
+
+@endsection diff --git a/routes/web.php b/routes/web.php index 4d7617c4..065a4e6f 100644 --- a/routes/web.php +++ b/routes/web.php @@ -604,6 +604,7 @@ Route::get('/templates', [\App\Http\Controllers\Barobill\KakaotalkController::class, 'templates'])->name('templates'); Route::get('/send', [\App\Http\Controllers\Barobill\KakaotalkController::class, 'send'])->name('send'); Route::get('/history', [\App\Http\Controllers\Barobill\KakaotalkController::class, 'history'])->name('history'); + Route::get('/guide', [\App\Http\Controllers\Barobill\KakaotalkController::class, 'guide'])->name('guide'); }); });