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

웹훅 수신, 에이전트 세션, 푸시 도구, 미디어 릴레이.

이것이 존재하는 이유

LINE은 많은 일본 및 APAC 팀의 일상적인 커뮤니케이션 레이어이고, Paperclip은 운영자에게 지속적인 에이전트 컨텍스트를 제공합니다. 이 플러그인은 LINE 사용자가 스레드 기록, 미디어 또는 운영 제어를 잃지 않고 Paperclip 에이전트와 대화할 수 있도록 이 두 표면을 연결합니다.

Paperclip에 대해 알아보기

웹훅 수신

  • 수신된 LINE 이벤트에 대한 HMAC-SHA256 검증
  • 멱등성 재생 처리를 위해 설계된 비동기 처리
  • Paperclip 컨텍스트에 연결된 영구적인 텍스트 및 미디어 댓글

에이전트 세션

  • 영구적인 LINE 사용자에서 Paperclip 스레드로의 매핑
  • 에이전트 인계 및 재시작 전반의 대화 연속성
  • line.* 이벤트 표면에 대한 운영 텔레메트리

아웃바운드 도구

  • 에이전트를 위한 회신 토큰 및 푸시 메시지 도우미
  • 텍스트, 이미지, Flex, 템플릿, 스티커 메시지 지원
  • 예상치 못한 채널 비용을 방지하기 위한 회사별 푸시 한도

설치

npm install paperclip-plugin-line

전체 설정 단계, 환경 변수, LINE Developers Console 연결 방법은 패키지 README에 있습니다.

설정 가이드 읽기

프로덕션 설정 경로

  1. 1Paperclip 런타임에 패키지를 설치하세요.
  2. 2LINE 채널 시크릿과 웹훅 서명 값을 구성하세요.
  3. 3LINE Developers Console을 플러그인 웹훅 URL로 지정하세요.
  4. 4Paperclip 에이전트가 지속적인 이슈 스레드 컨텍스트에서 응답하도록 하세요.

TypeScript로 내장

Paperclip 에이전트 및 도구와 동일한 런타임에서 LINE 메시징을 원하는 팀을 위한 타입 지정 플러그인 표면입니다.

운영상 가시적

페이지 수준 계약은 플러그인 목표를 반영합니다: 검증된 수신, 지속적인 세션, 그리고 운영자가 이해할 수 있는 카운터.

오픈 소스 배포

npm에서 설치하고, GitHub에서 소스를 검토한 뒤, 자신의 Paperclip 환경에서 실행하세요.