블로그로 돌아가기
설정 가이드Telegram 봇튜토리얼

TalkTG 설정 가이드: 웹사이트 라이브 채팅을 Telegram에 연결하는 방법

스크린샷으로 보는 단계별 가이드: 사이트 만들기, Telegram 봇 연결, 코드 한 줄 붙여넣기, 그리고 Telegram에서 첫 방문자에게 답장하기까지.

7 분 소요

이 가이드는 계정 만들기부터 Telegram에서 첫 방문자에게 답장하기까지 TalkTG 설정 전 과정을 안내합니다. 약 5분이면 끝나며, 모든 단계에 스크린샷이 있어 그대로 따라 하면 됩니다.

준비물

  • script 태그를 추가할 수 있는 웹사이트(일반 HTML, WordPress, Shopify, Webflow, Next.js 등).
  • 휴대폰이나 PC의 Telegram 계정.
  • 약 5분의 시간.

1단계: TalkTG 계정 만들기

talktg.com에서 「무료로 시작」을 클릭합니다. Google 계정으로 로그인하거나 이름, 이메일, 비밀번호를 입력해 가입하세요. 이메일로 받은 6자리 코드로 인증하면 됩니다. 무료 플랜은 신용카드가 필요 없습니다.

TalkTG 가입 페이지
TalkTG 가입 페이지

2단계: 웹사이트 추가하기

대시보드의 「사이트」에서 「사이트 추가」를 클릭합니다. https:// 없이 도메인(예: shop.example.com)을 입력하고, 원하면 알아보기 쉬운 이름도 적어 주세요. 위젯은 여기에 입력한 도메인에서만 작동하므로 다른 사이트가 위젯을 가져다 쓸 수 없습니다.

도메인과 이름을 입력해 새 사이트 추가
도메인과 이름을 입력해 새 사이트 추가

사이트를 만들면 개요 페이지로 이동합니다. 상단의 출시 체크리스트에 남은 단계(Telegram 연결, 위젯 설치, 첫 대화 받기)가 표시됩니다.

사이트 개요 페이지와 출시 체크리스트
사이트 개요 페이지와 출시 체크리스트

3단계: BotFather로 Telegram 봇 만들기

TalkTG는 여러분 소유의 Telegram 봇으로 방문자 메시지를 전달합니다. 봇의 이름과 프로필도 직접 정할 수 있습니다. 사이트 페이지의 「Telegram」 버튼을 눌러 연결 마법사를 열고 봇을 만드세요.

  • Telegram에서 @BotFather(공식 계정은 파란색 인증 표시)를 검색하고 Start를 누릅니다.
  • /newbot을 보냅니다.
  • 표시 이름을 정합니다. 예: Demo Shop Support.
  • 「bot」으로 끝나는 사용자 이름을 정합니다. 예: DemoShopSupportBot.
  • BotFather가 1234567890:AAE… 형식의 API 토큰을 보내 주면 복사합니다.
Telegram 연결 마법사 1단계: BotFather로 봇 만들기
Telegram 연결 마법사 1단계: BotFather로 봇 만들기
봇 토큰은 비밀번호처럼 관리하세요. 토큰을 가진 사람은 누구나 봇을 제어할 수 있습니다. TalkTG는 토큰을 암호화해 저장합니다. 토큰이 유출되었다면 BotFather에 /revoke를 보내 새 토큰을 발급받고 다시 연결하세요.

4단계: 봇을 사이트에 연결하기

「I have my bot token」을 클릭하고 토큰을 붙여넣은 뒤 「Verify & Continue」를 누릅니다. TalkTG가 Telegram에서 토큰을 확인하고 봇을 이 사이트에 연결합니다.

TalkTG에 봇 토큰 붙여넣기
TalkTG에 봇 토큰 붙여넣기

이어서 6자리 인증 코드가 표시됩니다. Telegram에서 봇을 열고 이 코드(또는 /bindsite와 코드)를 보내세요. 방문자 메시지를 받을 Telegram 계정이 본인 것인지 확인하는 절차입니다. 코드는 5분 동안 유효합니다.

봇에게 보낼 인증 코드
봇에게 보낼 인증 코드

「I sent the code」를 클릭합니다. 봇이 코드를 받으면 페이지가 자동으로 「Telegram Connected」로 바뀌고, Telegram에서 쓸 수 있는 봇 명령어가 표시됩니다.

Telegram 연결 완료 및 사용 가능한 봇 명령어
Telegram 연결 완료 및 사용 가능한 봇 명령어
  • /online, /offline: 위젯에 상담 가능 여부를 표시합니다.
  • /sites: 이 봇에 연결된 모든 사이트를 보여 줍니다.
  • 답장(Reply): Telegram에서 방문자 메시지에 답장하면 해당 방문자에게 응답합니다.
  • 답장 + /block: 대화를 종료합니다. 답장 + /history: 최근 메시지 20개를 봅니다.

5단계: 웹사이트에 위젯 설치하기

사이트 페이지로 돌아가 「Embed Code」 카드의 코드를 복사한 뒤, 사이트 HTML의 </body> 태그 바로 앞에 붙여넣습니다. 사이트 ID는 이미 들어 있습니다.

<script src="https://talktg.com/widget.js" data-site-id="YOUR_SITE_ID" async></script>
임베드 코드 카드와 복사 버튼
임베드 코드 카드와 복사 버튼
  • 일반 HTML: 모든 페이지의 </body> 앞이나 공통 레이아웃·푸터 템플릿에 붙여넣습니다.
  • WordPress: 테마 푸터나 「헤더·푸터 스크립트」 플러그인을 사용합니다.
  • Shopify: 온라인 스토어 → 테마 → 코드 편집 → theme.liquid의 </body> 바로 앞에 붙여넣습니다.
  • React, Next.js 등 SPA: 루트 HTML 템플릿이나 레이아웃에 한 번만 추가하면 모든 페이지에서 로드됩니다.

스크립트는 비동기로 로드되어 페이지 속도에 영향을 주지 않습니다. 출시 체크리스트에서 「Check widget installation」을 눌러 TalkTG가 사이트의 위젯을 찾는지 확인하세요.

6단계: 브랜드에 맞게 위젯 꾸미기(선택)

「Widget Settings」에서 브랜드 색상, 위치(오른쪽 아래 또는 왼쪽 아래), 상담원 이름, 인사 말풍선, 오프라인 메시지, 환영 메시지를 설정할 수 있습니다. 방문자에게 이메일을 받아 나중에 후속 연락을 할 수도 있습니다. 「Save Changes」를 누르면 실제 위젯에 바로 반영됩니다.

위젯 설정: 색상, 위치, 문구, 이메일 수집
위젯 설정: 색상, 위치, 문구, 이메일 수집

7단계: 테스트 메시지 보내기

브라우저의 시크릿 창으로 웹사이트를 열면 설정한 위치에 채팅 버튼이 보입니다.

웹사이트의 채팅 버튼
웹사이트의 채팅 버튼

방문자로서 메시지를 보내면 1초 안에 Telegram의 봇 채팅으로 도착하며, 어느 페이지에서 보냈는지도 함께 표시됩니다. Telegram에서 그 메시지에 답장하면(모바일은 왼쪽으로 밀기, PC는 우클릭 → 답장) 방문자의 채팅 창에 답변이 바로 나타납니다. 새로고침은 필요 없습니다.

방문자가 웹사이트 채팅에서 Telegram 답장을 확인
방문자가 웹사이트 채팅에서 Telegram 답장을 확인

모든 대화는 대시보드의 「대화」에도 저장되며, 전체 메시지 기록과 방문 페이지, 브라우저, 첫 방문 시간 같은 방문자 정보를 볼 수 있습니다.

TalkTG 대시보드의 대화 기록
TalkTG 대시보드의 대화 기록

문제 해결

  • 채팅 버튼이 보이지 않음: 보고 있는 페이지에 코드가 있는지, TalkTG에 입력한 도메인이 사이트 도메인과 정확히 같은지 확인하세요.
  • 봇 토큰이 거부됨: BotFather에서 콜론 앞 숫자까지 포함해 공백 없이 다시 복사하세요.
  • 인증 코드가 작동하지 않음: 코드는 5분 후 만료됩니다. 「Go back & try again」으로 새 코드를 받으세요.
  • Telegram으로 메시지가 오지 않음: 봇을 차단하거나 중지하지 않았는지, 사이트가 「Telegram Connected」 상태인지 확인하세요.

다음 단계

이제 준비가 끝났습니다. 어디서든 Telegram으로 답장하고, 자리를 비울 때는 /offline을 보내 방문자가 메시지를 남기도록 하세요. 자주 묻는 질문에 밤에도 자동으로 답하고 싶다면 문서와 FAQ를 AI 지식 베이스(Pro 플랜)에 추가하세요. AI가 대신 답하고, 답하지 못하는 질문은 Telegram으로 넘겨 줍니다.