This page is part of archived documentation for openHAB 4.1. Go to the current stable version
# X Binding
The X (formerly known as Twitter) binding allows your home to post 280 characters at a time. It also supports direct messages and posting with media.
# Supported Things
account - X Account.
# Thing Configuration
The X Account Thing requires you to create a X App in the X Developer Page.
Property | Default | Required | Description |
---|---|---|---|
consumerKey | Yes | Consumer API Key | |
consumerSecret | Yes | Consumer API Secret | |
accessToken | Yes | Access Token | |
accessTokenSecret | Yes | Access Token Secret | |
refresh | 30 | No | Post refresh interval in minutes |
# Channels
channel | type | description |
---|---|---|
lastpost | String | This channel provides the Latest post message |
# Full Example
x.things:
Thing x:account:sampleaccount [ consumerKey="11111", consumerSecret="22222", accessToken="33333", accessTokenSecret="444444" ]
x.items:
String sample_post "Latest post: [%s]" { channel="x:account:sampleaccount:lastpost" }
# Rule Action
This binding includes rule actions for sending posts and direct messages.
boolean success = sendPost(String text)
boolean success = sendPostWithAttachment(String text, String URL)
boolean success = sendDirectMessage(String recipientID, String text)
Examples:
val postActions = getActions("x","x:account:sampleaccount")
val success = postActions.sendPost("This is A Post")
val success2 = postActions.sendPostWithAttachment("This is A Post with a Pic", file:///tmp/201601011031.jpg)
val success3 = postActions.sendPostWithAttachment("Windows Picture", "D:\\Test.png" )
val success4 = postActions.sendPostWithAttachment("HTTP Picture", "http://www.mywebsite.com/Test.png" )
val success5 = postActions.sendDirectMessage("1234567", "Wake Up" )
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)