카테고리
App
시작하기 (튜토리얼)
안녕하세요! 😁 채널 앱 개발 튜토리얼에 오신 것을 환영합니다. 이 문서를 통해 이런 작업을 할 수 있어요. - 앱스토어(App Store)에 대한 간단한 이해 - 앱 개발 - 앱 설치 - 앱 사용하기 이 문서는 앱스토어 및 하위 개념들에 대해 개괄적인 내용만 설명하고 있습니다. 자세한 내용은 각 항목에 대한 개발자 페이지에서 확인해 주세요. (→ 인증 및 권한) (→ Function) (→ Command) (→ WAM) app-tutorial(typescript , go)에서 이 문서에 삽입된 코드를 한 번에 확인할 수 있습니다. 앱스토어(App Store)란 무엇인가 --- 이제 채널톡 개발자가 아니라도 우리 채널에 필요한 맞춤형 서드 파티 앱을 개발하고 채널에 등록할 수 있습니다! - 개발자들은 채널톡 규격에 맞는 특별한 앱을 개발하고 앱스토어 서버에 등록합니다. - 채널 매니저는 앱스토어 플랫폼에서 등록된 앱 목록을 확인하고 자신의 채널에 등록할 수 있습니다. - 앱을 비공개
인증 및 권한
Function
1. Function이란 무엇인가 --- 채널톡에서 앱의 기능을 요청하기 위해 사용하는 프로토콜입니다. http 위에서 json body 를 가지고 호출되며, body 의 method, params 를 이용해 호출할 rpc 의 이름과 파라미터를 식별합니다. 앱으로 오고 가는 모든 요청은 Function 스키마를 따라 전송됩니다. 2. Function Handling --- Function 이 호출될 경우 개발자 페이지에 등록하신Function Endpoint로 HTTP PUT 요청을 전송하게 됩니다. Function Endpoint 는 [앱 설정] - [기본 설정] - [서버 설정]에 등록할 수 있습니다. 요청을 받은 경우 Signing Key 를 발급받아 요청이 정당한 소스 (채널톡) 으로부터 온 것인지 검증할 수 있습니다. 앱 서버에서는 이러한 요청을 처리하고 응답을 할 수 있는 HTTP API 를 Function Endpoint 위에서 제공해야 합니다. method url no
Command
커맨드란 무엇인가 --- command는 user 혹은 manager가 채팅 위즈윅을 통해 연동을 원하시는 개발 서버의 기능을 이용할 수 있도록 만들어진 인터페이스입니다. command 가 호출되면, 채널톡 API 서버는function 프로토콜을 통해 연동을 원하시는 서버로 요청을 전송하게 됩니다. 커맨드 등록방법 --- { "name" : "commandName", "scope" : "desk", "description": "this is test command", "nameDescI18nMap": { "en": { "description": "test command en", "name": "test" }, "ko": { "description": "테스트 커맨드", "name": "테스트" } }, "actionFunctionName": "testFunction", "autoCompleteFunctionName": "autoCompleteFunctionName", "paramD
WAM
WAM이란 무엇인가 Function이나 command가 유저 인터랙션을 필요로 하거나 특정 정보를 유저에게 보여줘야 하는 경우, WAM(Web Application Module)을 만들어 사용할 수 있습니다. WAM은 SPA(Single-page application) 형태로 구현되어야 합니다. WAM을 구현하기 위한 라이브러리, 프레임워크, 번들러 등은 개발자의 선택이며, 어떠한 것을 선택하더라도 무방합니다. 개발한 WAM들을 앱서버 도메인의 하위 endpoint에서 serve하도록 한 뒤, App 설정 단계에서 ‘WAM Endpoint’에 해당 endpoint URL을 입력하면 WAM 등록이 완료됩니다. 가령 개발한 WAM의 wamName이 example-1-app일 경우, 서버에서는 ${WAM_ENDPOINT}/example-1-app URL을 호출합니다. WAM Controller --- WAM은 데스크/프론트 내에서 하나의 UI처럼 보여지지만, 실행 자체는 별도의 격리된 공