텔레그램 API 4가지 — 봇 API·TDLib·텔레그램 API·게이트웨이 고르기

텔레그램 API 네 가지 한눈에

텔레그램이 개발자에게 공개한 길은 네 갈래입니다. 이름이 비슷해 헷갈리지만, 어떤 계정으로 움직이는지를 보면 바로 갈립니다.

이름	계정 · 필요한 것	이럴 때
봇 API	봇 계정 · @BotFather 가 주는 토큰	알림 보내기, 고객 응대, 그룹 관리, 미니 앱
TDLib	사람 계정 · api_id·api_hash 와 전화번호 로그인	나만의 텔레그램 앱(클라이언트) 만들기
텔레그램 API	사람·봇 계정 · api_id·api_hash	TDLib 으로 안 되는 이유가 분명할 때 MTProto 를 직접 구현
게이트웨이 API	계정 대신 게이트웨이 가입과 미리 낸 이용료	회원 가입·로그인 인증 코드를 문자 대신 텔레그램으로

• 봇 API는 HTTPS 주소로 요청을 보내는 간단한 방식입니다. 암호화와 텔레그램 서버와의 통신은 텔레그램 쪽 서버가 대신 처리합니다.
• TDLib은 텔레그램이 직접 만들어 공개한 클라이언트 라이브러리입니다. 네트워크·암호화·기기 안 저장을 맡아 주고, C 함수를 부를 수 있는 언어라면 어디서든 씁니다(자바·C# 연결은 기본 제공).
• 텔레그램 API는 공식 앱들이 쓰는 바로 그 API 입니다. 통신 규약인 MTProto 위에서 수백 개의 메서드를 직접 다뤄야 합니다.
• 게이트웨이 API는 메시지 앱을 만드는 도구가 아니라, 내 서비스 이용자에게 인증 코드를 텔레그램으로 보내 주는 유료 서비스입니다.

고르는 순서

1. 봇으로 되는 일인가? 사람이 먼저 말을 걸면 답하고, 알림을 보내고, 버튼·미니 앱을 띄우는 일이라면 거의 전부 봇 API 로 됩니다. 대부분은 여기서 끝납니다.
2. 사람 계정의 화면이 필요한가? 대화 목록·연락처·메시지 기록을 다루는 앱을 만든다면 TDLib 을 씁니다.
3. TDLib 이 정말 안 맞는가? 그때만 MTProto 를 직접 다룹니다. 암호화·재전송·순서 맞추기를 모두 스스로 책임져야 합니다. 구조는 MTProto 한눈에에 있습니다.
4. 인증 문자를 대신하려는가? 메시지 기능이 아니라 인증 코드 발송만 필요하면 게이트웨이 API 입니다.

봇 계정과 사람 계정은 무엇이 다른가

항목	봇 계정(봇 API)	사람 계정(TDLib·텔레그램 API)
먼저 대화 걸기	못 한다 — 사용자가 먼저 시작해야 한다	된다
전화번호	필요 없다	필요하다(로그인)
마지막 접속 표시	없음 — '봇' 표시	있음
그룹 메시지	기본은 명령과 봇에게 단 답장만 본다(개인정보 모드)	참가한 그룹의 모든 메시지
만드는 곳	@BotFather	my.telegram.org 의 API 개발 도구

봇이 먼저 말을 걸지 못하는 것은 불편한 제약이 아니라 스팸을 막는 장치입니다. 그래서 봇으로 할 수 있는 일을 사람 계정 자동화로 하면 곧바로 문제가 됩니다.

다음에 읽을 글

하려는 것	글
봇부터 만들기	BotFather 로 봇 만들기 → 봇 API 첫 요청
사람 계정 앱 만들기	api_id·api_hash 발급
계정이 막히지 않게	API 이용 약관
개발 없이 개념만	봇 API 와 텔레그램 API