> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# LINE SDK for Laravel

> LINE 공식 SDK를 Laravel용으로 사용하기 쉽게 만든 패키지. Webhook, Bot, 알림, Socialite의 4가지 기능을 제공합니다.

## 개요

[revolution/laravel-line-sdk](https://github.com/invokable/laravel-line-sdk)는 LINE 공식 SDK를 Laravel에서 사용하기 쉽게 만든 패키지입니다.

Webhook 수신, Bot 파사드, Laravel Notifications 통합, LINE Login (Socialite)의 4가지 기능을 제공합니다.

<Info>
  이 패키지는 PHP 8.3 이상, Laravel 12.0 이상이 필요합니다.
</Info>

## 설치

```shell theme={null}
composer require revolution/laravel-line-sdk
```

## 설정

### LINE Developers 콘솔

[LINE Developers](https://developers.line.biz/)에서 채널을 생성합니다.

<Info>
  Messaging API 채널은 LINE Developers Console에서 직접 생성할 수 없게 되었습니다. 먼저 [LINE Official Account Manager](https://manager.line.biz/)에서 공식 계정을 만든 뒤 Messaging API 사용을 활성화하세요.
</Info>

두 개의 채널을 생성합니다.

| 채널                | 획득할 정보                                            |
| ----------------- | ------------------------------------------------- |
| **Messaging API** | Channel access token (long-lived), Channel secret |
| **LINE Login**    | Channel ID, Channel secret                        |

### .env

```dotenv theme={null}
LINE_BOT_CHANNEL_TOKEN=
LINE_BOT_CHANNEL_SECRET=

LINE_LOGIN_CLIENT_ID=
LINE_LOGIN_CLIENT_SECRET=
LINE_LOGIN_REDIRECT=
```

### 설정 파일 게시 (선택 사항)

```shell theme={null}
php artisan vendor:publish --tag=line-config
```

## 빠른 시작

가장 빨리 Bot을 동작시키는 절차입니다.

<Steps>
  <Step title="새 Laravel 프로젝트 생성">
    ```shell theme={null}
    laravel new line-bot
    cd ./line-bot
    composer require revolution/laravel-line-sdk
    ```
  </Step>

  <Step title=".env 설정">
    ```dotenv theme={null}
    LINE_BOT_CHANNEL_TOKEN=
    LINE_BOT_CHANNEL_SECRET=
    ```
  </Step>

  <Step title="기본 Listener 게시">
    ```shell theme={null}
    php artisan vendor:publish --tag=line-listeners
    ```

    `app/Listeners/Line/`에 `MessageListener`가 생성됩니다.
  </Step>

  <Step title="웹 서버에 배포">
    LINE에서 Webhook을 수신하려면 공개된 URL이 필요합니다. 로컬 서버에서는 수신할 수 없습니다.

    LINE Developers 콘솔에서 Webhook URL을 설정합니다.

    ```
    https://example.com/line/webhook
    ```
  </Step>

  <Step title="Bot을 친구 추가하고 테스트">
    Messaging API 채널의 QR 코드로 친구 추가합니다. 메시지를 보내면 `MessageListener`가 그대로 앵무새처럼 답변합니다.
  </Step>
</Steps>

## 문서

<Columns cols={2}>
  <Card title="Webhook / Bot" href="/ko/packages/laravel-line-sdk/bot" icon="webhook">
    Webhook 컨트롤러와 Bot 파사드에 의한 메시지 송수신.
  </Card>

  <Card title="알림 채널" href="/ko/packages/laravel-line-sdk/notification" icon="bell">
    Laravel Notification System과 LINE Messaging API 통합.
  </Card>

  <Card title="Socialite (LINE Login)" href="/ko/packages/laravel-line-sdk/socialite" icon="shield-check">
    LINE Login에 의한 OAuth2 인증을 Socialite로 구현.
  </Card>
</Columns>

## 참고 링크

* GitHub: [invokable/laravel-line-sdk](https://github.com/invokable/laravel-line-sdk)
* 데모: [invokable/laravel-line-project](https://github.com/invokable/laravel-line-project)
* DeepWiki: [invokable/laravel-line-sdk](https://deepwiki.com/invokable/laravel-line-sdk)


## Related topics

- [Socialite (LINE Login) - LINE SDK for Laravel](/ko/packages/laravel-line-sdk/socialite.md)
- [알림 채널 - LINE SDK for Laravel](/ko/packages/laravel-line-sdk/notification.md)
- [Webhook / Bot - LINE SDK for Laravel](/ko/packages/laravel-line-sdk/bot.md)
- [Laravel AI SDK](/ko/ai-sdk.md)
- [Laravel AI SDK 연동](/ko/packages/laravel-copilot-sdk/ai-sdk.md)