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" }

目次