Telegram | ElevenLabs Documentation

Telegram 봇을 사용하면 리셉셔니스트가 통화 중에 사용자 또는 팀 그룹에 메시지를 보낼 수 있습니다. 예를 들어 발신자가 콜백을 요청하거나 긴급한 문제를 알릴 때 사용할 수 있습니다. 웹훅 도구는 Telegram Bot API의 sendMessage 메서드를 호출합니다.

봇 만들기 및 채팅 ID 찾기

봇 만들기

Telegram에서 @BotFather와의 채팅을 열고 /newbot을 전송한 다음 안내에 따라 이름을 지정합니다. BotFather가 123456789:AA...와 같은 봇 토큰을 응답합니다. 이 토큰은 비밀로 취급하세요. 토큰을 가진 사람은 누구나 봇을 제어할 수 있습니다.

봇과 채팅 시작

봇은 자신이 속한 채팅에만 메시지를 보낼 수 있습니다.

자신에게 메시지 보내기: 새 봇과의 채팅을 열고 Start를 선택합니다.
그룹에 메시지 보내기: 그룹에 봇을 추가한 다음 /start@YOUR_BOT_NAME처럼 봇을 멘션하는 메시지를 보냅니다.

채팅 ID 찾기

브라우저에서 https://api.telegram.org/botBOT_TOKEN/getUpdates를 열고 BOT_TOKEN 자리에 봇 토큰을 입력합니다. 응답에서 내 메시지를 찾아 "chat":{"id": 뒤의 숫자를 복사합니다. 그룹 ID는 -1001234567890처럼 음수이므로 마이너스 기호를 유지하세요.

응답이 비어 있으면 봇에 다른 메시지를 보내고 페이지를 새로고침합니다.

웹훅 도구 만들기

Integrations로 이동해 Add integration을 선택한 다음 Webhook Tool을 선택합니다.

필드	값
Name	`notify_team_in_telegram`
Description	”Telegram에서 팀에 메시지를 보냅니다. 발신자가 콜백을 요청하거나, 사람과 통화하고 싶어 하거나, 긴급한 문제를 알릴 때 사용하세요.”
Method	POST
URL	`https://api.telegram.org/botBOT_TOKEN/sendMessage`(`BOT_TOKEN` 자리에 봇 토큰 입력)
Body Parameters	`chat_id`(문자열, 필수): “항상 정확히 `CHAT_ID` 값입니다.” `text`(문자열, 필수): “메시지: 발신자의 이름, 전화번호, 요청 사항입니다.”
Assign to agents	Receptionist

설명에서 CHAT_ID를 채팅 ID로 바꿉니다. URL에도 봇 토큰이 포함되므로 이 역시 비밀로 취급하세요.

Enable을 선택한 다음 콜백을 요청하여 리셉셔니스트를 테스트합니다. 봇이 채팅에 메시지를 게시합니다.

여러 채팅에 메시지를 보내려면 채팅 ID마다 도구를 하나씩 만드세요. 동일한 봇이 모든 채팅에 게시할 수 있습니다.

문제 해결

문제	확인 사항
Telegram에서 401을 반환함	URL의 봇 토큰이 잘못되었거나 BotFather에서 취소되었습니다. URL에서 토큰 바로 앞에 `bot`이 있어야 합니다.
`Bad Request: chat not found`	그룹의 마이너스 기호를 포함하여 채팅 ID가 올바른지, 봇과 채팅을 시작했거나 그룹에 봇을 추가했는지 확인합니다.
`Forbidden: bot was kicked`	봇이 그룹에서 제거되었습니다. 다시 추가하세요.
`getUpdates`에 아무것도 표시되지 않음	그룹에서 봇은 자신을 멘션한 메시지만 볼 수 있습니다. `/start@YOUR_BOT_NAME`을 전송하고 새로고침하세요.
리셉셔니스트가 전혀 게시하지 않음	도구 설명에 게시해야 하는 상황을 명시하세요.