Keyda SDK 참조
모든 Keyda SDK(Android, iOS, React Native, Flutter, Ionic)는 동일한 작은 계약을 구현합니다. 하나를 사용해 보셨다면 모두 사용하실 수 있습니다.
API
| 전화 | 주요 기능 |
|---|---|
init / initialize | Client ID를 저장합니다. 유효성을 검사하며 형식이 잘못된 경우 오류를 알립니다. |
show | 앱 위에 채팅창을 표시합니다. |
dismiss | 닫기. |
isShowing | 현재 표시 여부. |
의도적으로 다른 기능은 넣지 않았습니다. 메시지 전송 API, 읽지 않은 메시지 수, 사용자 식별 호출 기능이 없는 이유는 아직 완벽하게 작동하지 않기 때문입니다. 작동하지 않는 기능은 아예 없는 것보다 못합니다.
모든 SDK가 여는 URL
{baseUrl}/chat/{clientId}baseUrl은 https://keyda.in/business로 기본 설정되며, 스테이징이나 자체 호스팅 설치 시 플랫폼별로 재설정할 수 있습니다.
웹 뷰를 사용하는 이유와 비용
플랫폼에서 제공하는 단일 채팅 인터페이스를 모든 환경에서 불러옵니다.
제공 기능: 대시보드에서 소유자가 변경한 사항(강조 색상, 환영 메시지, 봇 이름, 라이브 전환 등)은 별도의 릴리스 없이 모든 앱에 즉시 적용됩니다. 수정 사항이 한 번에 모든 곳에 반영됩니다. 채팅은 모든 플랫폼에서 동일하게 유지됩니다.
비용 안내: 채팅을 위해서는 연결이 필요합니다. 오프라인 모드는 지원하지 않으며, 푸시 알림은 아직 제공되지 않습니다.
나중에 발견하는 것보다 배포 전에 미리 아시는 것이 좋습니다.
각 SDK가 보장하는 사항
- 외부 링크 연결. 다른 출처로 연결되는 링크는 채팅창을 대체하지 않고 시스템 브라우저에서 열립니다. 이 기능이 없으면 푸터 링크를 한 번만 눌러도 대화가 종료되어 돌아올 방법이 없습니다.
- 대화 연속성. DOM 스토리지가 활성화되어 있어 앱을 닫았다가 다시 돌아온 고객은 이전 대화 내용을 그대로 이어서 볼 수 있습니다(24시간 유지).
- 키보드가 입력창을 가리지 않습니다.
- 안전 영역 준수 — 노치나 홈 표시기 아래에 채팅이 그려지지 않습니다.
- 앱 충돌이 발생하지 않습니다. 로드 실패 시 재시도 화면이 표시됩니다.
- 분석 도구, 기기 식별자, 타사 종속성이 없습니다. Keyda SDK를 추가해도 앱에 추적기가 추가되지 않습니다.
Client id 형식
kb_live_ followed by 8-48 hexadecimal characters그 외의 모든 것은 초기화 단계에서 거부되며 고객에게 404 오류를 표시하지 않습니다. Client ID는 설계상 공개되어 있으며 위젯이 포함된 모든 웹사이트에서 볼 수 있습니다. 이는 계정을 읽거나 변경할 수 있는 권한을 포함하지 않습니다. 제한 및 보안을 확인하세요.
출처
공개, MIT 라이선스: github.com/KeydaAI/keyda-business-sdks. 모든 패키지가 준수해야 하는 공통 계약은 해당 저장소 상단의 CONTRACT.md에 있습니다.