Project

Profile

Help

Using Team Chat in Planio » History » Sprint/Milestone 32

Thomas Carney, 07/10/2015 03:57 PM

1 31 Thomas Carney
# Set Up Team Chat in Planio
2 1 Thomas Carney
3 6 Thomas Carney
Team Chat lets you quickly make decisions together with your teams in real time from your phone or computer.
4
5 1 Thomas Carney
{{>toc}}
6
7 13 Thomas Carney
## How Can You Use Team Chat?
8 1 Thomas Carney
9 13 Thomas Carney
  - You can chat with your team members directly inside Planio, on desktop clients or on your mobile about a project.
10 6 Thomas Carney
  - You can discuss an issue in chat, and your chat will be easily accessible from that issue, so you’ll have all the discussion around the issue in one place.
11
  - You can ping people by writing their name, so you can quickly ask them a question. They’ll get a notification, so they’ll know about it straight away.
12 1 Thomas Carney
  - You can search the entire chat log using search. Everybody can simply look up what has been said on a subject and absent people can catch up on past chats easily.
13
14 12 Thomas Carney
## Activate Planio Chat and Get Your Planio Chat Credentials
15 2 Thomas Carney
16 14 Thomas Carney
Log in into your Planio account and select the project for which you want to enable team chat. Go to **Apps** in the navigation bar and make sure **Team Chat** is installed. It’s an optional extra, so you’ll have to upgrade to use it.
17 1 Thomas Carney
18 15 Thomas Carney
![](install_chat_app.png)  
19
*Install the Chat App*
20 1 Thomas Carney
21 14 Thomas Carney
Now, you’ll see a Chat tab in the bottom-right of the screen. You can start chatting here.
22 1 Thomas Carney
23 15 Thomas Carney
![](chat_window.png)  
24
*You can use chat from within Planio*
25
26 1 Thomas Carney
You'll also find **Chat Logs** in the navigation bar. Click on it, and you’ll see a history of all chat messages. On the right, you’ll see a sidebar with chat credentials you'll need to set up chat on mobiles or desktops. You’ll have to enter your password to see the Server password.
27 14 Thomas Carney
28 15 Thomas Carney
![](chat_credentials.png)  
29 32 Thomas Carney
*You'll find your chat credentials in this sidebar*
30 1 Thomas Carney
31
You’ll need these credentials to set up chat on mobile devices and desktop IRC clients.
32
33
## Set up Chat on your iPhone
34
35 4 Thomas Carney
Let’s install chat on your iPhone so you can chat with your team members and get notifications on the go.
36
37 5 Thomas Carney
### Install the Colloquy App from the App Store
38 1 Thomas Carney
39 16 Thomas Carney
Open the app store and search for the **Colloquy** app. The app costs 1.99. Install the app and open it.
40 5 Thomas Carney
41 30 Thomas Carney
![](download_colloquy.PNG)  
42
*Install Colloquy*
43 4 Thomas Carney
44 5 Thomas Carney
### Add a new Connection
45 1 Thomas Carney
46
Select **Add an IRC connection**.
47
48 30 Thomas Carney
![](Add_an_IRC_connection.PNG)  
49
*Add an IRC connection*
50 4 Thomas Carney
51 10 Thomas Carney
Now, we'll fill out the connection fields:
52
53
  - The **Description** can be whatever you want.
54 11 Thomas Carney
  - The **Address** is the **Host name** from your Planio chat credentials (see above).
55 1 Thomas Carney
  - Switch on **Push Notifications** if you want to be notified when someone mentions your name in chat.
56
  - **Nickname** and **Real Name** will show up as your name in chat.
57 9 Thomas Carney
58 30 Thomas Carney
![](connection_part1.PNG)  
59
*Fill out the connection fields*
60 1 Thomas Carney
61
Scroll down and select **Advanced**
62 11 Thomas Carney
63 30 Thomas Carney
![](advanced.png)  
64
*Select Advanced*
65 12 Thomas Carney
66 1 Thomas Carney
Here's we'll fill out the connection and authentication settings with our Planio chat credentials (see above):
67 12 Thomas Carney
68 1 Thomas Carney
  - Enter the **Server Port**.
69
  - Switch on SSL, so your chat will be secure.
70 12 Thomas Carney
  - Enter the **Username**
71
  - Enter the **Password**
72
73 30 Thomas Carney
![](Advanced_Section.PNG)  
74
*Fill out the connection and authentication settings*
75 4 Thomas Carney
76 17 Thomas Carney
Click back to **New Connection** and then click on **Connect**.
77 1 Thomas Carney
78 5 Thomas Carney
### Join the Project Room
79
80 17 Thomas Carney
You can enter the room and start chatting on your iPhone.
81 4 Thomas Carney
82 24 Thomas Carney
## Set up Chat on your Android Phone
83
84
Let’s install chat on your Android phone. We'll use AndroIRC in this tutorial.
85
86
### Download AndroIRC
87
88 1 Thomas Carney
You can install [AndroIRC](https://play.google.com/store/apps/details?id=com.androirc) from Google Play Store.
89
90 24 Thomas Carney
### Add Your Planio Chat Server
91
92
Once you've installed the app, click on the **settings** icon and select **settings**.
93
94 30 Thomas Carney
![](settings.png)  
95
*Select Settings*
96 25 Thomas Carney
97 24 Thomas Carney
Select **Servers** and then again select **settings** and select **New server**.
98
99
Here's we'll fill out the connection and authentication settings with our Planio chat credentials (see above):
100
101
  - You can set the **Name** to whatever you want. 
102
  - The **address** is the Host name from the credentials.
103
  - The **Port** is the port from the credentials.
104 1 Thomas Carney
  - The **Password** is the **Server password**
105
  - You can set the **Nickname** to what you prefer (perhaps your name)
106 24 Thomas Carney
  - You can leave **Alternative** blank or enter a slightly modified version of your Nickname, as it's just for the case that someone else the same nickname as you.
107
  - **Ident** is the **User name** from the credentials.
108
  - Make sure that **Secured connection** is checked.
109
  - Ignore the rest of the fields and select the **Back** icon.
110 26 Thomas Carney
111 30 Thomas Carney
![](Server_settings_screen.png)  
112
*Fill out the fields with your chat credentials*
113 26 Thomas Carney
114
### Join the Chat Room
115 24 Thomas Carney
116 1 Thomas Carney
Go back to the home screen and select the Plus sign to add your new server. Select it from the list and connect. You'll automatically join the chat room.
117
118 2 Thomas Carney
## Set up Desktop Chat on your Mac
119
120
### Download and install Colloquy
121
122
Download and install Colloquy from the [Colloquy downloads page](http://colloquy.info/downloads.html).
123 3 Thomas Carney
124 1 Thomas Carney
### Create a new connection
125 18 Thomas Carney
126 30 Thomas Carney
Open up Colloquy. It will prompt you to create a new connection. If not, you can select File -\> New Connection.
127 1 Thomas Carney
128 22 Thomas Carney
Select the Details button and enter your credentials. You'll find these credentials on in your Planio project in **Chat logs**.
129
130 1 Thomas Carney
  - **Nickname**: enter your name
131
  - **Server Protocol**: leave as **IRC (Internet Relay Chat)**
132
  - **Chat Server**: enter the Host name
133 22 Thomas Carney
  - Tick **Remember this connection**
134
  - **Chat Server Port**: see your Planio account
135
  - **SSL Connection**: make sure it’s ticked (so your chat will be secure)
136
  - **User name**: enter the User name
137
  - **Server password**: enter the Server password
138
139 30 Thomas Carney
![](Colloquy_new_connection.png)  
140
*Enter your chat credentials*
141
142 2 Thomas Carney
### Join the Project Room
143 23 Thomas Carney
144 27 Thomas Carney
Click **Connect** and you’ll be automatically joined to your project chat room.
145
146 1 Thomas Carney
## Set up Desktop Chat on Windows
147
148 28 Thomas Carney
### Download and install Pidgin
149
150 27 Thomas Carney
Download and install [Pidgin for Windows](https://pidgin.im/download/windows/).
151 28 Thomas Carney
152
### Add a new Account
153
154
Click on the **Add** button on the welcome screen to add a new account.
155
156 30 Thomas Carney
![](welcome_screen.png)  
157
*Click 'Add'*
158 1 Thomas Carney
159 28 Thomas Carney
In the basic tab:
160
161 29 Thomas Carney
  - **Protocol** should be set to IRC
162
  - **Username** should be the username from your credentials (above)
163
  - **Server** is the Host name from your credentials
164 28 Thomas Carney
  - **Password** is the password from your credentials
165 1 Thomas Carney
  - Check **Remember password**, so you don't always have to re-enter it
166
  - Local alias is your chat name
167
168 30 Thomas Carney
![](add_account_basic.png)  
169
*Fill out the basic tab*
170 28 Thomas Carney
171 29 Thomas Carney
In the Advanced tab:
172 28 Thomas Carney
173 1 Thomas Carney
  - The **Port** should be the port number from your credentials
174 28 Thomas Carney
  - Tick **Use SSL**, so your chat is secure
175
  - Ident name should be the user name from your credentials
176
177 30 Thomas Carney
![](add_account_advanced.png)  
178
*Fill out the advanced tab*
179
180
### Start Chatting  
181
Click on 'Add' and you'll be automatically connected to the project chatroom.