알림 연동 가이드

텔레그램과 카카오 알림톡을 연동하여 주문·CS 이벤트를 실시간으로 받아보세요.

텔레그램 (권장)
카카오 알림톡
Webhook
💡 텔레그램을 추천합니다. 무료이고, 설정이 가장 쉬우며, 이미지·링크 등 풍부한 메시지를 보낼 수 있습니다. Chat ID만 있으면 개인·그룹·채널 모두 지원합니다.
1

텔레그램 앱에서 BotFather 검색

텔레그램 앱을 열고 상단 검색창에 @BotFather를 입력해 공식 봇을 선택합니다. (파란 체크 인증 마크가 있는 계정이 진짜입니다.)

또는 브라우저에서 t.me/BotFather로 바로 접속 가능합니다.

2

새 봇 생성 (/newbot)

BotFather와의 대화창에서 다음 명령을 순서대로 입력합니다:

/newbot
이름 입력: Sho-Pilot Notifier
유저네임 입력: my_shopilot_bot (반드시 'bot'으로 끝나야 함)

완료되면 BotFather가 HTTP API Token을 알려줍니다. 형식은 다음과 같습니다:

8145678901:AAGxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ 이 토큰은 절대 외부에 노출하지 마세요. 유출되면 /revoke 명령으로 즉시 무효화하세요.
3

봇과 대화 시작

BotFather가 준 t.me/my_shopilot_bot 링크를 클릭하거나, 텔레그램에서 해당 유저네임을 검색해 봇을 찾습니다.

START 버튼을 누르면 봇과의 대화방이 생성됩니다. 아무 메시지나 한 번 보내주세요 (예: 안녕).

⚠️ 이 단계를 건너뛰면 봇이 당신에게 메시지를 보낼 수 없습니다. 반드시 먼저 봇에게 말을 걸어야 합니다.
4

Chat ID 확인

방법 1 - userinfobot 사용 (가장 쉬움):

텔레그램에서 @userinfobot을 검색해 START를 누르면 당신의 Chat ID를 알려줍니다. (예: 123456789)

방법 2 - 브라우저에서 직접 확인:

당신의 봇 토큰으로 다음 URL에 접속하면 최근 메시지 목록이 JSON으로 보입니다:

https://api.telegram.org/bot<봇토큰>/getUpdates

응답 안에서 "chat":{"id":123456789...} 부분의 숫자가 Chat ID입니다.

방법 3 - 그룹 채팅에서 받기:

여러 명이 함께 알림을 받으려면 텔레그램 그룹을 만들고, 봇을 그룹에 초대한 뒤 관리자 권한을 줍니다. 그룹에서 아무 메시지를 보낸 후 위 방법 2로 조회하면 -100xxxxxxxxxx 형식의 그룹 Chat ID를 확인할 수 있습니다.

5

ShoPilot 설정에 입력

알림 설정 페이지로 이동하여:

  1. 텔레그램 섹션의 "텔레그램 알림 사용" 체크박스를 켭니다
  2. 봇 토큰에 2단계에서 받은 토큰을 붙여넣습니다
  3. Chat ID에 4단계에서 확인한 숫자를 입력합니다
  4. [테스트 전송] 버튼을 눌러 정상 수신되는지 확인합니다
  5. 정상이면 [설정 저장]을 누릅니다
지금 설정하기
⚠️ 카카오 알림톡은 유료 서비스입니다. 건당 약 8~12원이 발생하며, 카카오 비즈니스 채널 개설과 템플릿 승인(영업일 1~2일)이 필요합니다. 간단한 알림만 필요하다면 텔레그램을 권장합니다.
1

Solapi 계정 가입

solapi.com에 회원가입합니다. (기업 회원 가입 권장)

가입 후 콘솔에 로그인합니다.

2

API Key/Secret 발급

콘솔 우측 상단 프로필 → [API Key 관리] 클릭

[신규 API Key 생성]을 누르면 API Key와 API Secret Key가 발급됩니다.

⚠️ Secret Key는 이 화면을 벗어나면 다시 볼 수 없습니다. 반드시 안전한 곳에 저장하세요.
3

발신번호 등록

콘솔 → [발신번호 관리] → [발신번호 등록]

본인 휴대폰번호 또는 사업자 유선번호를 등록합니다. 인증 문자/통화로 승인됩니다.

4

카카오 비즈니스 채널 연결

카카오톡 채널을 먼저 만들고, 비즈니스 인증을 받습니다.

Solapi 콘솔 → [카카오] → [채널 연결] → 카카오 비즈니스 채널을 Solapi와 연동합니다.

연결이 완료되면 PFID(예: KA01PF240101abcdef)가 발급됩니다.

5

알림톡 템플릿 등록 및 승인

Solapi 콘솔 → [카카오] → [템플릿 관리] → [신규 템플릿 등록]

다음과 같은 기본 템플릿을 등록합니다:

[Sho-Pilot 알림]
#{내용}

- 본 메시지는 Sho-Pilot 쇼피 마진 계산기에서
  자동 발송됩니다.

카카오 영업일 기준 1~2일 내 승인되며, 승인 후 템플릿 ID(예: KA01TP240101xyz)가 부여됩니다.

💡 템플릿은 카카오가 검수합니다. 상업성 메시지·링크·특수문자 과다 시 반려될 수 있습니다.
6

ShoPilot 설정에 입력

알림 설정 페이지로 이동하여 다음 항목을 입력합니다:

  • API Key / API Secret: 2단계에서 발급받은 값
  • PFID: 4단계의 카카오 채널 ID
  • 템플릿 ID: 5단계에서 승인받은 템플릿 ID
  • 발신번호: 3단계에서 등록한 번호 (하이픈 없이)
  • 수신번호: 알림을 받을 본인 번호

[테스트 전송]으로 실제 알림톡 수신을 확인한 후 저장합니다.

지금 설정하기
💡 Webhook은 Discord/Slack 등 다른 플랫폼에 알림을 포워딩하거나, 자체 자동화 시스템(Zapier, Make 등)과 연동할 때 사용합니다.
1

Discord Webhook URL 만들기 (예시)

Discord 서버 → 채널 설정 → [연동] → [Webhook] → [새 Webhook]

Webhook URL을 복사합니다. 형식: https://discord.com/api/webhooks/123.../abc...

⚠️ Discord는 기본 Webhook이 {content: "..."} 형식을 요구합니다. ShoPilot은 {event, title, text, data} 형식으로 보내므로 Zapier/Make 등 중간 변환이 필요합니다.
2

ShoPilot이 보내는 Payload 형식

POST <your-webhook-url>
Content-Type: application/json

{
  "event": "new_order",
  "title": "🆕 새 주문 접수",
  "text": "[새 주문] 240423ABCD / MyShop / 19800 KRW",
  "data": { "orderSn": "240423ABCD", "shopName": "MyShop", ... },
  "timestamp": 1714200000000
}

이벤트 타입 (event):

  • new_order — 새 주문
  • shipped — 출고 완료
  • cancelled — 주문 취소
  • return — 반품 요청
  • buyer_message — 구매자 문의
  • low_stock — 재고 부족
  • upload_complete — 업로드 완료
3

ShoPilot에 입력

알림 설정 페이지에서 Webhook 섹션의 "웹훅 사용"을 체크하고 URL을 입력한 뒤 [테스트 전송]으로 확인 후 저장합니다.

지금 설정하기