문서 / 빠른 시작
10분 만에 첫 봇을 시작하세요
이 가이드는 텔레그램 봇을 만들고, Meshwire에 연결하고, 실제 흐름을 게시하는 과정을 안내합니다.
1. BotFather로 봇 만들기
텔레그램을 열고 @BotFather에게 메시지를 보낸 다음 /newbot을 실행하세요. 표시 이름과 'bot'으로 끝나는 고유한 사용자 이름을 선택하세요. BotFather가 HTTP API 토큰을 반환합니다 — 이를 복사해 두세요. 다음 단계에서 필요합니다.
/newbot
Alright, a new bot. How are we going to call it?
> Acme Support Bot
Good. Now let's choose a username for your bot.
> acme_support_bot
Done! Use this token to access the HTTP API:
110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw2. 토큰을 Meshwire에 연결하기
콘솔에서 봇 → 새 봇으로 이동하여 토큰을 붙여넣고 호스팅 모드를 선택하세요. 프로덕션에는 웹훅 모드를 권장하며, 폴링은 빠른 로컬 테스트에 유용합니다.
POST /v1/bots
{
"name": "Acme Support Bot",
"token": "110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw",
"hostingMode": "webhook",
"timezone": "Europe/Warsaw"
}3. 첫 흐름 만들기
흐름 편집기를 열고 trigger.command 노드(예: /start)를 캔버스로 드래그하세요. 환영 메시지가 담긴 msg.text 노드에 연결한 다음, 빠른 응답 버튼이 있는 msg.inline_keyboard 노드를 추가하세요.
trigger.command(/start)
-> msg.text("Welcome to Acme Support! How can we help?")
-> msg.inline_keyboard(["Talk to sales", "Track an order"])4. 샌드박스에서 테스트하기
내장 시뮬레이터를 사용하면 실제 텔레그램 트래픽에 영향을 주지 않고 테스트 메시지를 보낼 수 있습니다. 버튼과 미디어를 포함해 흐름이 실제로 어떻게 응답할지 정확히 보여줍니다.
Simulator > /start
Bot: Welcome to Acme Support! How can we help?
[ Talk to sales ] [ Track an order ]5. 게시하기
게시를 클릭하고 간단한 릴리스 노트를 추가하세요. Meshwire는 흐름을 검증하고, 버전 스냅샷을 저장하며, 실제 트래픽을 그 버전으로 전환합니다. 언제든지 이전 버전으로 되돌릴 수 있습니다.
POST /v1/bots/{botId}/publish
{ "note": "Initial launch: welcome + support routing" }