시작하기
파발 개발자 문서
파발을 쓰고, 파발 위에서 봇과 앱을 만들고, 파발 서버를 직접 운영하는 데 필요한 모든 것.
시작하기
파발 소개파발이 무엇인지, 어떻게 짜여 있는지, 지금 되는 것과 아직 안 되는 것.시작하기
AI 에이전트글에 답하고 전화도 받는 봇 — 데스크톱·휴대폰·애플 워치에서 같은 봇과. 데이터가 어디로 가는지까지 (준비 중).시작하기
앱 사용하기가입·대화·알림·그룹·사진·봇·링크 — 앱을 처음 쓰는 분을 위한 안내.봇 개발
봇 만들기 — 튜토리얼@BotFather 로 봇을 만들어 메시지·버튼·명령어·사진·그룹까지 다뤄 봅니다.봇 개발
웹훅으로 받기새 소식을 봇의 HTTPS 주소로 바로 받는 법. 검증·재시도·응답으로 답하기.봇 개발
음성 봇 — 전화 받는 봇봇에게 전화하면 AI 음성 모델이 받습니다. 지시문·목소리·도구·MCP·원음 모드 (준비 중).봇 개발
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 로 바꾸면 됩니다.
어떤 문서를 볼까요
| 하려는 일 | 문서 |
|---|---|
| 파발을 처음 들었다 | 파발 소개 |
| 앱으로 대화하고 싶다 | 앱 사용하기 |
| 휴대폰에 알림이 오지 않는다 | 앱 사용하기 — 알림 |
| AI 에이전트로 무엇을 할 수 있나 | AI 에이전트 |
| 알림 봇·도우미 봇을 만들고 싶다 | 봇 만들기 → 웹훅 |
| 이미 쓰는 텔레그램 봇을 파발에서도 돌리고 싶다 | 라이브러리 연결, 텔레그램과 다른 점 |
| 전화 받는 봇을 만들고 싶다 | 음성 봇 |
| 봇 통화 소리가 어디로 가나 | AI 에이전트 — 데이터가 어디로 가나 |
| 메서드 하나의 파라미터가 궁금하다 | 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 로 실행해 확인했습니다. 음성 봇 예제는 2026-09-27 시험 서버와 시험용 게이트웨이에서 같은 방법으로 확인했습니다. 파발에서 아직 되지 않는 기능은 문서마다 따로 표시해 두었습니다.