MINARA

메시징 채팅 ID 해석

POST /v1/gateway/providers/:id/resolve-chat-id: Telegram 봇의 채팅 ID를 조회합니다. 요청 본문의 botToken은 저장되지 않습니다.

POST /v1/gateway/providers/:id/resolve-chat-id

Telegram 봇이 보낼 채팅 ID를 조회합니다. JSON 요청 본문에 선택적으로 botToken을 전달하면 이번 조회에만 사용되고 저장되지 않습니다. 생략하면 gateway가 저장된 토큰을 사용합니다. Telegram만 지원하며 다른 provider id는 404를 반환합니다. 차단하지 않고 현재 상태를 보고한 뒤 반환하므로 호출자가 폴링합니다. found는 채팅 ID를 담고, awaiting_start는 사용자가 아직 봇에게 메시지를 보내지 않았음을 뜻하며, conflict는 실행 중인 daemon이 Telegram의 getUpdates를 점유하고 있음을 뜻합니다(계속 폴링하세요. 사용자가 보낸 메시지는 daemon을 통해 해석 로직에 도달합니다). invalid_token은 전달했거나 저장된 토큰을 사용할 수 없음을 뜻합니다.

메서드POST
경로/v1/gateway/providers/:id/resolve-chat-id
인증GATEWAY_AUTH_TOKEN이 설정된 경우 Authorization: Bearer <token> 필요
카테고리gateway

요청 본문

{ "botToken": "123456789:AAH..." }

응답 본문

{ "status": "found", "chatId": "42", "username": "my_bot" }

목차