/python-slackclient

Primary LanguagePythonMIT LicenseMIT

python-slackclient

Build Status

A basic client for Slack.com, which can optionally connect to the Slack Real Time Messaging (RTM) API.

Overview

This plugin is a light wrapper around the Slack API. In its basic form, it can be used to call any API method and be expected to return a dict of the JSON reply.

The optional RTM connection allows you to create a persistent websocket connection, from which you can read events just like an official Slack client. This allows you to respond to events in real time without polling and send messages without making a full HTTPS request.

See python-rtmbot for an active project utilizing this library.

Installation

Automatic w/ PyPI (virtualenv is recommended.)

pip install slackclient

Manual

git clone https://github.com/slackhq/python-slackclient.git
pip install -r requirements.txt

Usage

See examples in doc/examples

Note: You must obtain a token for the user/bot. You can find or generate these at the Slack API page.

###Basic API methods

import time
from slackclient import SlackClient

token = "xoxp-28192348123947234198234"      # found at https://api.slack.com/web#authentication
sc = SlackClient(token)
print sc.api_call("api.test")
print sc.api_call("channels.info", channel="1234567890")
print sc.api_call(
    "chat.postMessage", channel="#general", text="Hello from Python! :tada:",
    username='pybot', icon_emoji=':robot_face:'
)

Real Time Messaging


import time
from slackclient import SlackClient

token = "xoxp-28192348123947234198234"# found at https://api.slack.com/web#authentication
sc = SlackClient(token)
if sc.rtm_connect():
    while True:
        print sc.rtm_read()
        time.sleep(1)
else:
    print "Connection Failed, invalid token?"

####Objects

[SlackClient.server] Server object owns the websocket and all nested channel information.

[SlackClient.server.channels] A searchable list of all known channels within the parent server. Call print (sc instance) to see the entire list.

####Methods

Method Description
SlackClient.rtm_connect() Connect to a Slack RTM websocket. This is a persistent connection from which you can read events.
SlackClient.rtm_read() Read all data from the RTM websocket. Multiple events may be returned, always returns a list [], which is empty if there are no incoming messages.
SlackClient.rtm_send_message([channel, message]) Sends the text in [message] to [channel], which can be a name or identifier i.e. "#general" or "C182391"
SlackClient.api_call([method]) Call the Slack method [method]. Arguments can be passed as kwargs, for instance: sc.api_call('users.info', user='U0L85V3B4')_
SlackClient.server.send_to_websocket([data]) Send a JSON message directly to the websocket. See RTM documentation for allowed types.
SlackClient.server.channels.find([identifier]) The identifier can be either name or Slack channel ID. See above for examples.
SlackClient.server.channels[int].send_message([text]) Send message [text] to [int] channel in the channels list.
SlackClient.server.channels.find([identifier]).send_message([text]) Send message [text] to channel [identifier], which can be either channel name or ID. Ex "#general" or "C182391"