This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

If your Bamboo server has access to the internet, it can use Google Talk to send IM notifications about build results.

On this page:

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:

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'IM Server' link in the left navigation column (under 'Communication').
  3. This will display the 'Instant Messaging Server Details' page. Click the 'Edit' button.
  4. In the 'Host' field, type 'talk.google.com'.
    (info) If your IM Server uses an "@googlemail.com" account, type 'googlemail.com' in the 'Host' field.
  5. Leave the 'Port' field blank, Bamboo will perform a DNS lookup to figure out which port to use.
  6. In the 'Username' field, type the login name of the Google account from which IM notifications will be sent. Starting with Bamboo 3.4, you need to include the domain name, e.g. atlassianbamboo@gmail.com NOT atlassianbamboo.
    (info) If you are using your internal IM Server select "Requires an TLS/SSL connection" only if necessary
    (info) If you are using talk.google.com, please select "Requires an TLS/SSL connection"
  7. In the 'Password' field, type the password for the account specified in step 6.
  8. 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.)
  9. Click the 'Test' button, and verify that the message is successfully received.
  10. Click the 'Save' button.

Notes

Related Topics

Configuring Email and Instant Messaging Notifications

9 Comments

  1. Juha Sadeharju

    Mar 29, 2008

    Is there a way to get this working with Google  Apps for Your Domain?

    More specifically, I have a domain hosted by Google which also contains Google Talk. I can connect to it via any jabber client such as iChat by specifying the server as talk.google.com:5222 and using username@mydomain.com as the login name.

    The instructions above might be valid for a plain gmail account, but don't work for GAFYD accounts. It produces a SASL authentication error.

    Does anyone know whether there exists a workaround?

    1. user-c7894

      Apr 28, 2008

      I have the same issue - I believe that support for this scenario has to be implemented in their code.

      The Google APIs allow you to specify your hosted domain when attempting to log in to the chat server, but Bamboo does't allow you to do that through its user interface.

      +1 vote to add this feature.

      1. bradical

        Apr 29, 2009

        Hey Guys, I was wondering the same thing but I actually got it to work using the following

        • h: gmail.com
        • port: <leave blank>
        • u: first.last@mygoogleappsdomain.com
        • p: <password>
        • Resoure: Bamboo
        • Requires an SSL Connection: <yes>

        The trick for me was that the user who's sending the messages has to already be authorized to chat with the recipients otherwise it tends to sit indefinitely.

        1. Anonymous

          Oct 18, 2009

          This isn't working for me; it tells me the message was successfully delivered but it never shows up.

          I als can't figure out anywhere how to determine what user is sending the messages (in order to authorize them).

          Anyhow, I'm trying to get my own Google Apps Chat domain setup now following this guideline: http://www.google.com/support/a/bin/answer.py?answer=60227.

          1. Andrew

            Oct 19, 2009

            Hi,

            Can I suggest raising a ticket in the 'Bamboo Support' project on our support system (https://support.atlassian.com/)? Our support staff will respond promptly to your request and you will be able to track the progress of your issue.

            Kind Regards,
            Andrew

    2. Roy van den Broek

      Mar 23, 2012

      I realize this is an old comment, but this might still be relevant for some users since it was for us. We managed to get it to work with the following configuration with Bamboo 3.4.4:

  2. Anonymous

    Jul 05, 2011

    This documentation is confusing. The Before You Begin section seems to say we should use host talk.google.com with port 5222 in our settings, but then the configuration steps say to use different settings? Anyway, we have Google Apps and the following settings worked for us:

    Host: talk.google.com
    Port: 5222
    Username: bamboousername@mygoogleappsdomain.com
    Resource: Bamboo
    Requires an TLS/SSL connection: true
    Force legacy SSL: false

    Setting the host to mygoogleappsdomain.com might have worked if we had the proper SRV entries (http://www.google.com/support/a/bin/answer.py?answer=34143) configured for our domain, but we don't, so talk.google.com worked fine.

    Sidenote--being forced to manually invite every committer who wants IM notifications to chat from the Bamboo account is annoying. How hard is it to make the Bamboo chat account automatically invite people who want IM notifications? I ended up writing a Perl script that used Net::XMPP to automatically invite people.

  3. Anonymous

    Mar 01, 2012

    When testing in Bamboo 3.4.3, I found that in step #6, username must be specified with @gmail.com domain

    1. Przemek Bruski

      Mar 14, 2012

      Thanks for pointing this out. Starting with Bamboo 3.4 the domain has to be there.



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.