2.5.8 Instant messaging

One of thePBX services is text messaging. A user can initiate a chat (text conversation) with other PBX user by taping on chat icon in the contact details view or using the shortcuts icons on the Contacts list. 

The chat menu shows all messages in form of threads grouped by sender along with the call log. When clicking on a row the conversation view opens which contain the received messages and own messages sent to this user, all shown in chronological order.

Deferred messages

Messages are delivered instantly to the other party if only he is online. If the user is not registered to the server (for example the application is closed), the message will be stored on the server and a notification sent though the PUSH mechanism.

When a user comes online all new messages from his inbox are downloaded. 

Delivery confirmation

Sent messages have a small icon on the right side of the bubble. It shows the message’s status and can take one of the four forms:

• Sending – it may show up only for a moment, just after you sent a message. It is visible during the time when waiting for response from the server or a timeout
• Failed – when there is no response received from the server, for example if there is network connectivity problem. Messages with this status can be re-sent by tapping on them and selecting appropriate icon.
• Sent – it means that the messages reached the server so that we can be sure that it will reach the other user when only he comes online. Also he should receive PUSH notification already
• Read – it means that the message was received by the destination user. It does not exactly mean that the user read it but for sure the message is shown as new in his chat menu.

The delivery confirmation mechanism is based on a return message sent back by the recipient with information that this particular message has been received. The return message is also stored on the server and even if you are offline now you will get it when only you logs in again. The delivery confirmation messages are never shown in the chat menu, they are processed by the dialer and are used only to update the messages’ statuses.

Emoticons

When the keyboard is put up, on its left side is the emoticons icon. Tap it to switch the standard keyboard to the view with a set of emoticons.

Attachments

Following types of attachments are supported:

• Picture from camera or gallery
• Short video (up to 10 seconds) from camera
• Audio note recorded from microphone (up to 30 seconds)

The attachments can be sent from the conversation view.  

The files are uploaded to the server first, even if the other user is online. When the upload is finished the message is sent to the other party with information necessary to download the file. When the message is opened the dialer starts downloading. When downloaded the file is removed from the server.

This approach allows for sending files even if the recipient is offline. The file will be stored on the server along with the message.

Geolocation sharing

Another feature connected to Instant Messaging is sending geographical location. It can be a location of the sender or any location chosen by the user, for example a meeting venue. By default the map shows the current location.

In addition to the coordinates a user can send some texts within the message as shown on the below pictures.

Group chat

This function allows for conversing with a group of other PBX users. They all see who else is in the group and messages sent from one user are received by all others. The messages are sent first to the server and then distributed to the users.

When you start a new group automatically you become the group’s admin. In the first step you have to add other PBX users (from your Contacts) to the group.  They will receive an invitation which they can accept or decline. When accepted they join the group chat and information about it is sent to other users which will see a message that user this and this has joined. Also when someone leaves the group chat similarly a message appears that the user has left the chat. During the chat any participant can see the current list of participants by tapping on the menu button.

The admin of the group can add new participants to the chat and remove them.  He can close and delete the group chat from the server. Each group chat can have a subject which is also set by the admin.

The group chat supports all the Instant Messaging features such as deferred messages, PUSH notification, attachments and geolocation sharing.

In the dialer group chats are shown as threads in the chats list.