Telegram Bot API

텔레그램 MarkdownV2·HTML 이스케이프 도구

아무 텍스트나 붙여넣으면 텔레그램 MarkdownV2 또는 HTML parse mode에 맞게 이스케이프해 주므로, sendMessage가 더 이상 Bad Request: can't parse entities로 실패하지 않습니다.

MarkdownV2에서는 _ * [ ] ( ) ~ ` > # + - = | { } . ! 를 백슬래시로 이스케이프해야 합니다. code와 pre 안에서는 ` 와 \ 만, 링크의 (…) 안에서는 ) 와 \ 만 이스케이프합니다. HTML에서는 < > & 가 필요합니다.

테스트: 채팅으로 보내기

토큰은 브라우저(localStorage)에만 저장되며 api.telegram.org로만 전송됩니다.

텔레그램 봇용 Markdown 이스케이프 방법

  1. 있는 그대로의 텍스트를 붙여넣으십시오. 사용자 이름, 가격, 로그 한 줄 등입니다. 직접 넣을 서식 기호는 붙여넣지 마십시오. 데이터를 이스케이프한 다음 *bold*나 <b>로 직접 감싸면 됩니다.
  2. 모드를 선택하십시오: MarkdownV2 일반 텍스트, MarkdownV2 code/pre 내부, MarkdownV2 링크의 (…) 내부, HTML. 결과는 입력하는 대로 갱신됩니다.
  3. 복사를 누르거나, JSON 문자열로를 눌러 백슬래시를 두 번 쓴 따옴표 문자열을 받으십시오. JSON 본문이나 소스 코드에 바로 쓸 수 있습니다.
  4. 선택 사항: 테스트를 열고 봇 토큰과 chat_id를 입력한 뒤, 결과를 sendMessage와 해당 parse_mode로 보내십시오. code 모드에서는 텍스트가 백틱으로 감싸지고, 링크 모드에서는 [link](…)의 URL이 됩니다.

텔레그램 MarkdownV2 이스케이프 규칙

규칙은 Bot API 서식 옵션에서 가져왔습니다.

예: Price: 5.99 (incl. tax) - order #42!는 다음과 같이 바뀝니다.

Price: 5\.99 \(incl\. tax\) \- order \#42\!

마침표와 느낌표는 단골 함정입니다. 하나만 빠뜨려도 요청 전체가 실패합니다.

텔레그램 HTML parse mode

HTML 모드에서는 태그나 엔티티의 일부가 아닌 모든 <, >, &를 &lt;, &gt;, &amp;로 써야 합니다. 도구는 정확히 이 세 문자를 바꿉니다. 규칙이 이렇게 짧기 때문에 동적인 텍스트에는 HTML이 더 안전한 선택인 경우가 많습니다. 지원되는 태그 목록은 /ko/guides/telegram-bot-send-message.html에 있습니다.

개인정보 보호

이스케이프는 전적으로 브라우저에서 실행되며 요청을 보내지 않습니다. 선택 사항인 테스트만 sendMessage 요청 하나를 브라우저에서 api.telegram.org로 바로 보냅니다. 토큰은 localStorage에 저장되며 저희 서버에는 전달되지 않습니다. /ko/telegram-bot-api-tester.html#sendMessage에서 요청을 직접 만들어 볼 수도 있습니다. 다른 오류 메시지는 /ko/guides/telegram-bot-api-errors.html에서 설명합니다.

자주 묻는 질문

텔레그램 MarkdownV2에서 이스케이프해야 하는 문자는 무엇인가요?

일반 텍스트에서는 _ * [ ] ( ) ~ ` > # + - = | { } . !를 각각 앞에 백슬래시를 붙여 이스케이프합니다(백슬래시 자체도 이스케이프합니다). code와 pre 안에서는 `와 \만, 링크의 (…) 안에서는 )와 \만 이스케이프합니다.

sendMessage가 "can't parse entities"로 실패하는 이유는 무엇인가요?

텍스트에 이스케이프하지 않은 예약 문자가 있거나 닫히지 않은 엔티티가 있기 때문입니다. 텔레그램의 오류 메시지에는 보통 해당 문자가 표시됩니다. 텍스트의 동적인 부분은 이스케이프하고, 직접 넣은 서식 기호만 이스케이프하지 않은 채로 두십시오.

MarkdownV2와 HTML 중 무엇을 써야 하나요?

사용자나 데이터베이스에서 오는 텍스트라면 보통 HTML이 더 쉽습니다. <, >, &만 바꾸면 됩니다. MarkdownV2는 18개 문자를 이스케이프해야 합니다.

코드 블록 안의 텍스트도 이스케이프해야 하나요?

MarkdownV2에서는 code와 pre 안의 `와 \만 이스케이프합니다. 도구에서 해당 모드를 선택하십시오. HTML 모드에서는 어디서나 같은 세 문자입니다.

다른 유틸리티

chat ID 찾기Mini App initData 검증 도구웹훅 확인 도구Bot API Tester