시작하기
파발 개발자 문서
파발을 쓰고, 파발 위에서 봇과 앱을 만들고, 파발 서버를 직접 운영하는 데 필요한 모든 것.
시작하기
파발 소개파발이 무엇인지, 어떻게 짜여 있는지, 지금 되는 것과 아직 안 되는 것.시작하기
앱 사용하기가입·대화·그룹·사진·봇·링크 — 앱을 처음 쓰는 분을 위한 안내.봇 개발
봇 만들기 — 튜토리얼@BotFather 로 봇을 만들어 메시지·버튼·명령어·사진·그룹까지 다뤄 봅니다.봇 개발
웹훅으로 받기새 소식을 봇의 HTTPS 주소로 바로 받는 법. 검증·재시도·응답으로 답하기.봇 개발
Bot API 레퍼런스메서드·객체·오류를 빠짐없이. 텔레그램 Bot API 라이브러리를 주소만 바꿔 씁니다.파발 API
파발 API — MTProto앱과 같은 방식으로 붙는 클라이언트를 만들 때: 접속 정보·공개키·인증·업데이트.서버 운영
서버 설치도커 컴포즈로 서버·PostgreSQL·HTTPS 를 한 번에. 백업과 업데이트까지.서버 운영
관리와 설정관리 화면, 가입 코드(SMS·이메일) 전달, 설정 값 전체 목록.3분 만에 봇 하나
파발 앱에서 @BotFather 에게 /newbot 을 보내 봇을 만들면 토큰을 받습니다. 그 토큰으로 바로 요청을 보낼 수 있습니다.
# 받은 토큰을 넣으세요
TOKEN='100003:AbCdEf…'
# 봇 정보
curl -s "https://pabal.me/bot$TOKEN/getMe"
# 앱에서 봇에게 아무 말이나 보낸 뒤: 새 소식 가져오기 (최대 30초 기다림)
curl -s "https://pabal.me/bot$TOKEN/getUpdates?timeout=30"여기서부터는 봇 만들기 튜토리얼이 이어집니다. 텔레그램용으로 만든 봇이 이미 있다면 주소만 https://api.telegram.org 에서 https://pabal.me 로 바꾸면 됩니다.
어떤 문서를 볼까요
| 하려는 일 | 문서 |
|---|---|
| 파발을 처음 들었다 | 파발 소개 |
| 앱으로 대화하고 싶다 | 앱 사용하기 |
| 알림 봇·도우미 봇을 만들고 싶다 | 봇 만들기 → 웹훅 |
| 이미 쓰는 텔레그램 봇을 파발에서도 돌리고 싶다 | 라이브러리 연결, 텔레그램과 다른 점 |
| 메서드 하나의 파라미터가 궁금하다 | Bot API 레퍼런스 |
| 사람 계정으로 붙는 프로그램(클라이언트)을 만들고 싶다 | 파발 API — MTProto |
| 우리 조직용 파발 서버를 직접 운영하고 싶다 | 서버 설치 → 관리와 설정 |
한눈에 보는 주소
| 무엇 | 주소 | 쓰는 곳 |
|---|---|---|
| 웹사이트·링크 | https://pabal.me/ | 브라우저, pabal.me/사용자명 링크 |
| Bot API | https://pabal.me/bot<토큰>/<메서드> | 봇 프로그램 (HTTPS) |
| Bot API 파일 | https://pabal.me/file/bot<토큰>/<file_path> | 봇이 받은 사진 내려받기 |
| MTProto | 122.34.175.215:8443 | 파발 앱, MTProto 클라이언트, MTProto 봇 |
| 서버 공개키 | https://pabal.me/docs/server-key.pem | MTProto 클라이언트가 몸속에 넣는 키 |
이 문서의 모든 예제는 실제로 돌려 본 것입니다
명령과 코드는 2026-09-19 파발 서버에서 python-telegram-bot 22.8, aiogram 3.31, Telethon 1.42, curl 로 실행해 확인했습니다. 파발에서 아직 되지 않는 기능은 문서마다 따로 표시해 두었습니다.