# LINE 設定

本頁說明如何建立 `core/line` bot、對外公開它的 webhook，以及 handler 收到的 `Input`。

## 建構子與選項

```go
bot, err := line.New(channelSecret, channelAccessToken, "8080",
    line.WithPath("/hooks/line"),
)
```

| 參數 | 規則 |
|---|---|
| `secret` | Channel secret，用於驗證 webhook 簽章。空值 → `secret is required` |
| `token` | Channel access token。空值 → `token is required` |
| `port` | 監聽 port；server 綁定所有介面的 `:<port>`。空值 → `port is required` |
| `WithPath(path)` | Webhook path；預設 `/linebot/webhook`。`path` 為空時沿用預設 |

`New` 以 `line-bot-sdk-go/v8` 的 legacy `linebot` 套件建立 client，不會啟動 server。

## 公開 HTTPS endpoint

與 Telegram、Discord 不同，LINE 由平台把事件推給你。請在 LINE Developers Console 把 webhook URL 設為公開的 HTTPS 位址，並轉發到 `http://<host>:<port><path>`。本機測試可使用 ngrok 等通道。

`Start(ctx)` 先呼叫 `GetBotInfo` 驗證 token，再同步綁定 port（port 已被占用時回 error），最後在 goroutine 中提供服務。

## Webhook 處理

| 情況 | HTTP 回應 |
|---|---|
| 簽章驗證失敗（`ErrInvalidSignature`） | 400 |
| body 無法解析 | 500 |
| bot 未執行 | 503 |
| 事件處理完畢 | 200，待該 request 內所有事件處理完才回 |

同一 request 內的事件依序處理，共用一個 30 秒 context。LINE 期待快速收到 200，因此慢的工作請移出 handler，或改在 goroutine 執行後再用 `Send` 推送。

## Input

| 欄位 | 內容 |
|---|---|
| `SourceType` | `user`、`group` 或 `room` |
| `UserID` / `GroupID` / `RoomID` | 來源 ID；依 `SourceType` 填入 |
| `Username` | 傳送者顯示名稱，依來源呼叫 `GetProfile`、`GetGroupMemberProfile` 或 `GetRoomMemberProfile` 取得；呼叫失敗或 `UserID` 為空時為 `""` |
| `ReplyToken` | 一次性 reply token；handler 回傳非空字串時會被自動回覆用掉 |
| `MessageID` | 訊息 ID（所有類型）；媒體訊息傳給 `Save` |
| `MessageType` | `text`、`image`、`video`、`audio` 或 `file` |
| `Text` | 僅 text 訊息 |
| `FileName` | 僅 file 訊息 |
| `Raw` | `*linebot.Event` |

LINE 事件不帶顯示名稱，因此每則訊息在呼叫 handler 前會多打一次 profile API。

## 相關頁面

- [LINE 訊息](/zh/line-messages)
- [媒體落地](/zh/media-save)
- [LINE API](/zh/api-reference-line)