Differences between revisions 2 and 5 (spanning 3 versions)
Revision 2 as of 2013-09-08 22:18:57
Size: 2065
Editor: host109
Comment: !BitlBee in the title doesn't need a !
Revision 5 as of 2014-01-17 22:05:49
Size: 3130
Editor: c-71-233-34-61
Comment: Add tip for removing "Message from unknown participant"
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
[[https://www.atlassian.com/software/hipchat/overview|Hipchat]] is a chat service by Atlassian that provides an XMPP bridge. It's the choice of many businesses, as it supports mission critical features like pasting images and having them show up inline in the chat, and silly meme-like things that happen if you type things like "(awwyeah)". As such, it's only used by people who have no other choice. If you can decide what chat service to use, please get a real XMPP server with real XMPP clients instead. [[https://www.atlassian.com/software/hipchat/overview|Hipchat]] is a chat service by Atlassian that provides an XMPP server. It's the choice of many businesses, as it supports mission critical features like pasting images and having them show up inline in the chat, and silly meme-like things that happen if you type things like "(awwyeah)".

As such, it's only used by people who have no other choice. If you can decide what chat service to use, please get a real XMPP server with real XMPP clients instead.
Line 7: Line 9:
== JIDs == Official information on their XMPP, including technical details, is available [[http://help.hipchat.com/knowledgebase/articles/64377-xmpp-jabber-support-details|here]]

== Initial setup ==

Get your account details from [[https://www.hipchat.com/account/xmpp|this page]], and use your jabber ID here:

{{{
account add jabber 123456_789012@chat.hipchat.com
account jabber set tag hipchat
}}}
Line 11: Line 22:
Fix nick display by setting nick_format and nick_source  Fix nick display by setting nick_source:
Line 14: Line 25:
account hipchat set nick_format %full_name
Line 18: Line 28:
''(TODO: maybe only one of these is required)''
Line 22: Line 30:
Groupchats require you to have a "nick" set to your real name (`Givenname Surname`), otherwise you'll get an error on /join. Groupchats require you to have a "nick" set to your real name (`Givenname Surname`), otherwise you'll get an error on /join ("not-acceptable: Please use the nickname...")
Line 24: Line 32:
Additionally, the channel names are in the format "123456_chat_name" where 123456 is the company-wide account ID. Additionally, the channel names are in the format `#123456_chat_name` where 123456 is the company-wide account ID.
Line 30: Line 38:
chat #channel_name set nick 'Givenname Surname' channel #channel_name set nick 'Givenname Surname'
Line 37: Line 45:
Do @username instead of "username:". The problem is that we don't know what this "username" is supposed to be, since it's some sort of nick that can be different from the real name. Do `@mention_name` instead of `username:`. Otherwise people won't notice your messages are addressed to them. A great feature.
Line 39: Line 47:
A client script to automate this would be nice. This mention_name comes from `<item mention_name="...">` in the roster. This value isn't parsed by bitlbee, so the only way to get it is enabling [[Debugging|xmlconsole]] or using one of the official clients.

== "Message from unknown participant" when joining channel ==

Since the server sends wrong JIDs for the "from" field (`123456_chat_name@conf.hipchat.com/real name here`), all you can do is using client scripts to fix this up. If you write something to do this, add it here.

Using the `trigger.pl` script from Wouter Coekaerts (download [[http://wouter.coekaerts.be/irssi/trigger|here]]), you can add the following trigger to replace "Message from unknown participant " with a blank string to hide it:

{{{
/TRIGGER ADD -all -nocase -regexp '^Message from unknown participant ' -replace ''
}}}
Line 43: Line 61:
If you want to figure out something, you can try enabling the [[Debugging|XMPP xmlconsole]] to your contacts If you want to figure out something, you can try enabling the [[Debugging|XMPP xmlconsole]] to your contacts. Good luck with that.

Setting up Hipchat with BitlBee

Hipchat is a chat service by Atlassian that provides an XMPP server. It's the choice of many businesses, as it supports mission critical features like pasting images and having them show up inline in the chat, and silly meme-like things that happen if you type things like "(awwyeah)".

As such, it's only used by people who have no other choice. If you can decide what chat service to use, please get a real XMPP server with real XMPP clients instead.

Since there are several issues with hipchat, this page tries to document workarounds to use it with bitlbee.

Official information on their XMPP, including technical details, is available here

Initial setup

Get your account details from this page, and use your jabber ID here:

account add jabber 123456_789012@chat.hipchat.com
account jabber set tag hipchat

The jabber IDs of hipchat accounts are in the format 123456_789012@hipchat.com where 123456 is the company-wide account ID and 789012 is your user account ID.

Fix nick display by setting nick_source:

account hipchat set nick_source full_name

Groupchats

Groupchats require you to have a "nick" set to your real name (Givenname Surname), otherwise you'll get an error on /join ("not-acceptable: Please use the nickname...")

Additionally, the channel names are in the format #123456_chat_name where 123456 is the company-wide account ID.

The best way to get this working is to avoid using the usual "invite" method of joining channels and add the channels manually before you join them.

chat add hipchat 123456_chat_name@conf.hipchat.com #channel_name
channel #channel_name set nick 'Givenname Surname'

Note that you can't rename channels - you have to remove and re-add them.

Highlights/mentions

Do @mention_name instead of username:. Otherwise people won't notice your messages are addressed to them. A great feature.

This mention_name comes from <item mention_name="..."> in the roster. This value isn't parsed by bitlbee, so the only way to get it is enabling xmlconsole or using one of the official clients.

"Message from unknown participant" when joining channel

Since the server sends wrong JIDs for the "from" field (123456_chat_name@conf.hipchat.com/real name here), all you can do is using client scripts to fix this up. If you write something to do this, add it here.

Using the trigger.pl script from Wouter Coekaerts (download here), you can add the following trigger to replace "Message from unknown participant " with a blank string to hide it:

/TRIGGER ADD -all -nocase -regexp '^Message from unknown participant ' -replace ''

Debugging

If you want to figure out something, you can try enabling the XMPP xmlconsole to your contacts. Good luck with that.

BitlBee Wiki: HowtoHipchat (last edited 2018-08-04 05:58:56 by dx)