If your Bamboo server has access to the internet, it can use Google Talk to send IM notifications about build results. |
Configuring Bamboo to use Google Talk for Instant Messaging
Before you begin:
- Google Talk does not allow IM messages to be received unless the receiver has approved the sender. Please ensure that the Gmail user specified in step 6 is approved by each Google Talk recipient. That is, ensure that the 'Host' and 'Username' have previously sent messages to each other via Google Talk.
- The Google Talk service is hosted at talk.google.com. The default port is 5222. (Note: be aware that your firewall might be blocking traffic to this port.)
- TLS is required.
- The only supported authentication mechanism is SASL PLAIN. For additional information, please see: http://code.google.com/apis/talk/open_communications.html
To configure Bamboo to use Google Talk for Instant Messaging:
- Click the 'Administration' link in the top navigation bar.
- Click the 'IM Server' link in the left navigation column (under 'Communication').
- This will display the 'Instant Messaging Server Details' page. Click the 'Edit' button.
- In the 'Host' field, type 'gmail.com'.
If your IM Server uses an "@googlemail.com" account, type 'googlemail.com' in the 'Host' field.
- Leave the 'Port' field blank, Bamboo will perform a DNS lookup to figure out which port to use.
- In the 'Username' field, type the login name of the Google account from which IM notifications will be sent. Only the account name needs to be included e.g. atlassianbamboo NOT atlassianbamboo@gmail.com.
If you are using your internal IM Server select "Requires an TLS/SSL connection" only if necessary
If you are using talk.google.com, please select "Requires an TLS/SSL connection"
- In the 'Password' field, type the password for the account specified in step 6.
- Type a test IM user's address (e.g. atlassianbamboo@gmail.com NOT atlassianbamboo) in the 'Test Recipient Address' box. (Note: use a different user to the one you specified in step 6.)
- Click the 'Test' button, and verify that the message is successfully received.
- Click the 'Save' button.