Bandruption Logo

オープンソースPaperclipプラグイン

paperclip-plugin-line

日本とAPAC全域でサポート、オペレーション、エージェントワークフローを実行するPaperclipチーム向けの双方向LINE Messaging API統合。

インストール

$ npm install paperclip-plugin-line

line.webhook.verified

agent.session.resumed

reply_token.message_sent

Webhook受信、エージェントセッション、プッシュツール、メディアリレー。

存在理由

LINEは多くの日本およびAPACチームにとって日常的なコミュニケーション基盤であり、Paperclipはオペレーターに永続的なエージェントコンテキストを提供します。このプラグインはこれら2つのサーフェスを接続し、LINEユーザーがスレッド履歴、メディア、運用コントロールを失うことなくPaperclipエージェントと対話できるようにします。

Paperclipについて詳しく見る

Webhook受信

  • 受信LINEイベント用のHMAC-SHA256検証
  • 冪等なリプレイ処理向けに設計された非同期処理
  • Paperclipコンテキストに添付される永続的なテキストおよびメディアコメント

エージェントセッション

  • LINEユーザーとPaperclipスレッドの永続的なマッピング
  • エージェントの引き継ぎや再起動を跨いだ会話の継続性
  • line.*イベントサーフェス上の運用テレメトリ

送信ツール

  • エージェント向けの応答トークンおよびプッシュメッセージヘルパー
  • テキスト、画像、Flex、テンプレート、スタンプメッセージのサポート
  • 予期しないチャネル費用を回避するための企業単位のプッシュ制限

インストール

npm install paperclip-plugin-line

完全なセットアップ手順、環境変数、LINE Developers Consoleの設定方法はパッケージのREADMEに記載されています。

セットアップガイドを読む

本番環境セットアップ手順

  1. 1Paperclipランタイムにパッケージをインストールします。
  2. 2LINEチャネルシークレットとWebhook署名値を設定します。
  3. 3LINE Developers ConsoleをプラグインのWebhook URLに向けます。
  4. 4Paperclipエージェントが永続的なissue-threadコンテキストから応答できるようにします。

TypeScriptで構築

Paperclipエージェントやツールと同じランタイムでLINEメッセージングを利用したいチーム向けの型付きプラグインサーフェス。

運用上の可視性

ページレベルのコントラクトはプラグインの目標を反映しています：検証された受信、永続的なセッション、オペレーターが理解できるカウンター。

オープンソース配布

npmからインストールし、GitHubでソースコードを確認し、独自のPaperclip環境で実行できます。