Changeset - b4c36d7a6720
[Not reviewed]
0 1 0
Nicolas Cedilnik - 7 years ago 2018-04-27 12:17:26
truenicoco@users.noreply.github.com
Add details on facebook support (#288)
1 file changed with 7 insertions and 4 deletions:
0 comments (0 inline, 0 general)
documentation/backends/libpurple.md
Show inline comments
 
@@ -18,35 +18,38 @@ You have to choose this backend in Spectrum 2 configuration file to use it:
 
As showed above, there is also special configuration variable in `[service]` section called `protocol` which decides which Libpurple's protocol will be used:
 

	
 
Protocol variable| Description
 
-----------------|------------
 
prpl-jabber| Jabber
 
prpl-aim|AIM
 
prpl-icq|ICQ
 
prpl-msn|MSN
 
prpl-yahoo|Yahoo
 
prpl-gg|Gadu Gadu
 
prpl-novell|Groupwise
 

	
 
### Third-party plugins
 

	
 
Spectrum 2 should work with any third-party libpurple plugin which is properly installed. For example, popular plugins:
 

	
 
Protocol variable| website | Description
 
-----------------|------------
 
prpl-facebook| [https://github.com/jgeboski/purple-facebook](https://github.com/jgeboski/purple-facebook) | Facebook
 
prpl-telegram| [https://github.com/majn/telegram-purple](https://github.com/majn/telegram-purple) | Telegram
 
prpl-skypeweb| [https://github.com/EionRobb/skype4pidgin/tree/master/skypeweb](https://github.com/EionRobb/skype4pidgin/tree/master/skypeweb) | Skype
 

	
 
These plugins are included by default in our Docker image.
 

	
 
### Support for Facebook stickers
 

	
 
Facebook stickers are supported using [Web Storage](../configuration/web_storage.html).
 

	
 
### Setting libpurple plugins configurations
 

	
 
Some libpurple protocol plugins allow setting configuration variables. Spectrum 2 passes every variable set in `purple` section to libpurple library. If you need to set such options, you can do it for example like this in your configuration file:
 

	
 
	[purple]
 
	clientlogin=1
 
	ssl=0
 

	
 
### Notes on Facebook support
 

	
 
- It may be a good idea to [set up an application password](https://www.facebook.com/help/249378535085386/) instead of using your real credentials, for security alerts (and facebook paranoid security alerts) reasons.
 
- Facebook stickers are supported using [Web Storage](../configuration/web_storage.html).
 
- Messages aren't marked as read until you reply, and sometimes own messages aren't either, so you should set `show-unread=0` (see section above) if you want to avoid receiving duplicates
 
- Group chats aren't joined automatically. To join a group chat, get its ID through [Facebook messenger's web interface](https://www.messenger.com) and join it as a `GROUP_CHAT_ID@your_facebook_transport.yourdomain.yourtld`
0 comments (0 inline, 0 general)