28. Kakao Guild Chatting
Guild chat is based on Kakao Talk open chat.
Guides you how to interlocking with KakaoTalk guild chat in the game.
What is Guild Chat?
Users joining a guild in a game can have chats in the guild chat room on KakaoTalk.
When a user joins a guild in a game, the user becomes a member of the KakaoTalk guild chat room automatically.
Terms of using KakaoTalk Guild Chat
The Kakao Account logging into the game and the Kakao Account logging into KakaoTalk must be identical.
E.g.) If the user uses aaa@bbb.ccc to log into the game, the user must also log into KakaoTalk using aaa@bbb.ccc.
Based on the Kakao Account used to log into the game, the user may not enter the guild chat room in the following cases:
The Kakao Account used to log into KakaoTalk does not match.
KakaoTalk is not installed or logged in.
Guild Chat Room Creation Policy
One World ID is issued per game server.
(Kakao Account user) The user can create or enter one guild chat room based on one World ID per game server.
Member's rights in the guild chat room
On KakaoTalk, everyone is the member of the guild chat room without applying different privileges to the guild master and the guile members.
All members can "Leave" or "Report and Leave" the guild chat room at any time.
For re-entry, the game client should provide the UI so that members can re-enter the guild chat room.
How to check the Kakao Account used to log into
KakaoTalk - KakaoTalk > More > The setting icon at the top right corner > Privacy/Security > Kakao Account
Max. number of KakaoTalk Guild Chat Room: 500 users
Guild chat interlocking flow
|
|
|---|---|
| <To be prepared by the developer> Send world creation information: Request via the Game Center Q&A Board.
(Only images with a jpg extension are supported.) <Kakao Support> World creation (Contact: Tech PM or Business PM)
|
Key features of guild chat
Guild Chat Room Member Management
Create a guild chat room in KakaoTalk.
Guild creation case
When the guild master creates a guild in the game, a guild chat room will be created in the guild master's KakaoTalk at the same time.
When a guild member joins a guild in the game, the guild chat room will be created in the member's KakaoTalk.
Exception
The guild chat room will not be created in the guild master's and members' KakaoTalk if the Kakao Account used to log into the game and the Kakao Account used to log into KakaoTalk do not match.
The guild chat room is not created if KakaoTalk is not installed in the user's mobile device or if the user uses an old version of KakaoTalk which supports open chat.
The game sends alert messages to users matching error codes or messages.
Change the profile of the Guild Chat Room
When the guild information is changed, the change will be reflected in the guild chat room on KakaoTalk.
Items for which changes can be reflected
Guild name
Guild description
Guild main image
Change of the guild master in the game does not affect the guild chat room on KakaoTalk. (The guild master and members have the same privileges in the guild chat room.)
Information cannot be edited in the guild chat room on KakaoTalk. All changes have to be made in the game.
Delete the guild chat room from KakaoTalk (removal)
Deletion
When the guild master disbands (or closes) the guild in the game, the guild chat room remains on KakaoTalk but it cannot send or receive messages.
When a member leaves the guild chat room while maintaining the member status, the guild chat room will disappear from KakaoTalk. (The member may re-enter if the reentry UI is provided.)
When a member leaves the guild, the guild chat room will be removed from the member's KakaoTalk.
When the guild is disbanded in the game, the guild chat room remains on KakaoTalk but it cannot send or receive messages.
Guild Chat Room Member Management
Add members to the guild chat room
When a new member joins the guild, the member is added to the guild chat room on KakaoTalk.
When the member has two or more Kakao Accounts or devices
It is assumed that the user with Devices A & B installed the game on Device A and
Kakao Account a is connected to the game and Kakao Account b is connected to KakaoTalk.
Kakaotal Installed | Account Relation | Guild Chat | Reaction when entering a chat room in the game. |
A | a == b | possibility | Move to KakaoTalk chat room The game moves to the background while KakaoTalk moves to the foreground. |
A | a != b | impossibility | No response --> It is recommended that the game checks an error code and display an appropriate alert message. |
B | a == b | possibility | Device A does not respond. The chat room can be checked from KakaoTalk on Device B. |
B | a != b | impossibility | No response --> It is recommended that the game checks an error code and display an appropriate alert message. |
Do not install | a | impossibility | No response --> It is recommended that the game checks an error code and display an appropriate alert message. |
Change member profile in the guild chat room
When the guild master or a member changes the nickname or the profile picture, it is also updated in the guild chat room.
When a member leaves the guild chat room
When a member leaves the guild, he or she also leaves the guild chat room.
The guild chat room disappears from the member's KakaoTalk.
Expel a member from the guild chat room
When a member is expelled from the guild, he or she is blocked from the guild chat room.
The guild chat room remains on the member's KakaoTalk, but he or she cannot receive or send messages.
Re-enter the guild chat room (SDK API)
Members may re-enter the guild chat room if the re-entry UI is provided in the guild-related menu in the game.
The cases where re-entry into the guild chat room is allowed must be defined in the game.
The UI will allow members who have left the guild chat room on KakaoTalk to re-enter the chat room.
When the guild chat room is on the guild member's KakaoTalk, KakaoTalk is opened. (chat_link: Guild chat room custom scheme URL)
If the guild chat room is not on the guild member's KakaoTalk, the member is added to the guild chat room and then KakaoTalk is opened.
KakaoTalk is not executed in the following cases:
KakaoTalk is not installed on the device where the game is installed.
KakaoTalk is installed on the device where the game is installed, but the Kakao Account used to log into the game and the Kakao Account used to log into KakaoTalk do not match.
Guild chat room messaging
Send feed messages to the guild chat room
You may send feed-type messages to the guild chat room on KakaoTalk.
It is sent directly via the server API. The message template needs to be registered in advance.
Purpose: System messages sent from the game server to the guild, such as guild announcements and changes
Notices and event promotion messages
Notification messages to be sent before a specific dungeon begins such as a siege or a raid
Other announcement feed messages that the developer wants to send
Feed message format
Feeds are displayed in two lines at maximum in the guild chat window on KakaoTalk. Any messages exceeding the limit will be shown as "...".
Basic feed notification: Texts can be written in two lines max.
Image feed notification: A message feed is composed of an icon image on the left (60*60) and texts.
Feed link type
app: Game app execution. In this case, URL and the install url information is automatically inserted. (See information entered in the Game Center.)
web: URL is connected via a web browser.
If undefined, it will be set as app.
Send a link message to the guild chat room (SDK API)
You may send a pre-assigned link message in the message template format to the guild chat room on KakaoTalk.
Purpose: A member of the guild chat room can send a template type message in the game.
It is recommended that link messages are used when a member wants to show off or share the news of winning rare items, advancement to an upper level or quest completion to the guild chat room.
Link messages can be used freely in other cases as long as they do not breach the message template policy.\
There is no quota limit for sending link messages in the guild chat room.