Sawala is an Wrapper of Qiscus Chat SDK using the React framework. It's designed for Kata Internal needs.
Note: Sawala is still in beta.
Sawala is developed by the help of developers like you! Please read our Contributing Guidelines to get started on developing Sawala.
This project is bound by a Code of Conduct.
# npm
$ npm install --save sawala
# yarn
$ yarn add sawalaSawala is built in React, you can use it like this example:
import * as React from 'react';
import { SawalaChat } from 'sawala';
import { EmptyMessage } from '@kata-kit/common';
export default class Chat extends React.Component<Props> {
renderEmptyRoom = () => {
return (
<EmptyMessage
image={require('assets/images/no-page.svg')}
title={'No chat selected'}
>
Please select chat first.
</EmptyMessage>
);
};
render() {
return (
<SawalaChat
config={{
autoConnect: true,
appId: 'sdksample',
user: {
id: 'rohmad@kata.ai',
password: 'q1w2e3r4',
displayName: 'Rohmad from Kata.ai',
avatar:
'https://res.cloudinary.com/kata-ai/image/upload/v1572663263/sawala/kata_favicon-02_zzldhx.png'
}
}}
onRendered={this.handleRendered}
noSelectedComponent={this.renderEmptyRoom()}
onClickDetailComment={this.handleClickDetailComment}
loginSuccessCallback={this.handleloginSuccessCallback}
newMessagesCallback={this.handlenewMessagesCallback}
/>
);
}
}SawalaChat is the only component needed to use sawala. It will react dynamically to handle all features.
SawalaChat props:
| prop | type | required | description |
|---|---|---|---|
| config | AppConfig | yes | App Configuration for setup to Qiscus Web SDK Core |
| onRendered | function(QiscusCore) | yes | Callback after Sawala successfully rendered, for example you can call method qiscus.getNonce() |
| newMessagesCallback | function(messages) | yes | Callback when you are have a new messages incoming |
| onClickDetailComment | function(Comment) | yes | Callback when you click Message Details in your own message |
| noSelectedComponent | ReactElement | no | React element for showing an empty state |
| headerComponent | ReactElement | no | React element for additional feature in Header. E.g: Context menu |
| onSelectedRoom | function(Selected) | no | Callback after selected room using method window.qiscus.setSelected |
| loginSuccessCallback | function(AuthData) | no | Callback when you initiate to qiscus is success |
export type User = {
id: string,
password: string,
displayName: string,
avatar?: string
};
export type AppConfig = {
autoConnect: boolean | true,
appId: string,
user?: User | null
};QiscusCore is response from qiscus-sdk-web-core. Look like this:
{
"events": {},
"rooms": [],
"selected": null,
"room_name_id_map": {},
"pendingCommentId": 0,
"uploadedFiles": [],
"chatmateStatus": null,
"version": "WEB_2.8.36",
"userData": {},
"AppId": "esl-9qaeayalt99fccowr",
"baseURL": "https://api.qiscus.com",
"uploadURL": "https://api.qiscus.com/api/v2/sdk/upload",
"mqttURL": "wss://mqtt.qiscus.com:1886/mqtt",
"HTTPAdapter": null,
"realtimeAdapter": {},
"customEventAdapter": {},
"isInit": false,
"isSynced": false,
"syncInterval": 5000,
"sync": "socket",
"httpsync": null,
"eventsync": null,
"extras": null,
"last_received_comment_id": 0,
"googleMapKey": "",
"options": { "avatar": true },
"UI": {},
"mode": "widget",
"avatar": true,
"plugins": [],
"isLogin": false,
"isLoading": false,
"emoji": false,
"isTypingStatus": "",
"customTemplate": false,
"templateFunction": null,
"debugMode": false,
"debugMQTTMode": false,
"lastReceiveMessages": [],
"_customHeader": {},
"syncAdapter": { "events": {} }
}AuthData also is response from qiscus-sdk-web-core. Look like this:
{
"user": {
"app": {
"code": "esl-9qaeayalt99fccowr",
"id": 8216,
"id_str": "8216",
"name": "esl"
},
"avatar": {
"avatar": {
"url": "https://d1edrlpyc25xu0.cloudfront.net/kiwari-prod/image/upload/75r6s_jOHa/1507541871-avatar-mine.png"
}
},
"avatar_url": "https://d1edrlpyc25xu0.cloudfront.net/kiwari-prod/image/upload/75r6s_jOHa/1507541871-avatar-mine.png",
"email": "esl-9qaeayalt99fccowr_admin@qismo.com",
"extras": {},
"id": 64061322,
"id_str": "64061322",
"last_comment_id": 0,
"last_comment_id_str": "0",
"last_sync_event_id": 0,
"pn_android_configured": true,
"pn_ios_configured": true,
"rtKey": "somestring",
"token": "PiJ8ndNiZwDI7pLONsFF1572018149",
"username": "User from Kata.ai"
}
}Messages also is response from qiscus-sdk-web-core. Look like this:
[
{
"chat_type": "group",
"comment_before_id": 80343513,
"comment_before_id_str": "80343513",
"created_at": "2019-10-31T02:21:06.138008Z",
"disable_link_preview": false,
"email": "esl-9qaeayalt99fccowr_admin@qismo.com",
"extras": {},
"id": 80541844,
"id_str": "80541844",
"is_public_channel": false,
"message": "Contoh pesan masuk",
"payload": {},
"raw_room_name": "Rohmad Sasmito",
"room_avatar": "https://avatars3.githubusercontent.com/u/10769688?s=100",
"room_id": 4947400,
"room_id_str": "4947400",
"room_name": "Rohmad Sasmito",
"room_options": null,
"room_type": "group",
"status": "sent",
"timestamp": "2019-10-31T02:21:06Z",
"topic_id": 4947400,
"topic_id_str": "4947400",
"type": "text",
"unique_temp_id": "bq1572488465709",
"unix_nano_timestamp": 1572488466138008000,
"unix_timestamp": 1572488466,
"user_avatar": "https://d1edrlpyc25xu0.cloudfront.net/kiwari-prod/image/upload/75r6s_jOHa/1507541871-avatar-mine.png",
"user_avatar_url": "https://d1edrlpyc25xu0.cloudfront.net/kiwari-prod/image/upload/75r6s_jOHa/1507541871-avatar-mine.png",
"user_id": 64061322,
"user_id_str": "64061322",
"username": "User from Kata.ai"
}
]Selected also is response from qiscus-sdk-web-core. Look like this:
{
"id": 5000296,
"last_comment_id": 81421286,
"last_comment_message": "Jangan lupa makan mahal, minimal sehari sekali.",
"avatar": "https://api.telegram.org/file/bot925192808:AAHfy0Y0pnVPk_n60w0I6zNJWl4bqzgFXOc/profile_photos/file_15.jpg",
"name": "Rohmad from Kata.ai",
"room_type": "group",
"participants": [],
"options": null,
"topics": [],
"comments": [],
"count_notif": 0,
"isLoaded": false,
"unread_comments": [],
"custom_title": null,
"custom_subtitle": null,
"unique_id": "6f5689f6-0aee-45f9-980f-6fa74eea70df",
"isChannel": false,
"participantNumber": 0
}Comment also is response from qiscus-sdk-web-core. Look like this:
{
"id": 81365202,
"before_id": 81363608,
"message": "[file] https://d1edrlpyc25xu0.cloudfront.net/orgin-lg5ja1kyfcrid8r/raw/upload/yptF4THWmI/50727c5bd9eee40535166b73f6f706f5.jpg [/file]",
"username_as": "User from Kata.ai",
"username_real": "orgin-lg5ja1kyfcrid8r_admin@qismo.com",
"date": "2019-11-01",
"time": "19:48",
"timestamp": "2019-11-01T12:48:18Z",
"unique_id": "bq1572612497702",
"avatar": "https://res.cloudinary.com/kata-ai/image/upload/v1572501422/klient/admin-avatar_2x_b39pbw.png",
"room_id": 5000305,
"isChannel": false,
"unix_timestamp": 1572612498,
"is_deleted": false,
"isPending": false,
"isFailed": false,
"isDelivered": true,
"isRead": true,
"isSent": true,
"attachment": null,
"payload": {
"url": "https://d1edrlpyc25xu0.cloudfront.net/orgin-lg5ja1kyfcrid8r/raw/upload/yptF4THWmI/50727c5bd9eee40535166b73f6f706f5.jpg.webp",
"caption": "Ini makanan ku hari ini, anti murah-murah club",
"file_name": "50727c5bd9eee40535166b73f6f706f5.jpg.webp",
"size": 6678,
"pages": 1,
"encryption_key": ""
},
"status": "read",
"type": "file_attachment",
"subtype": null
}Licensed under the Apache 2.0 license. Copyright (c) 2019 Kata.ai and/or contributors. All rights reserved.
- Rohmad Sasmito (@rohmad-st) – Kata.ai