shaneutt / slacker

Erlang Slack REST API wrapper

slacker

Erlang Slack REST API wrapper.

To use slacker, you need a team token that you can grab here.

Installation

To build the application simply run 'make all'. This should build .beam, .app files and documentation.

To run tests run 'make test'. To generate doc, run 'make doc'.

Or add it to your rebar config

{deps, [
    ....
    {slacker, ".*", {git, "git://github.com/julienXX/slacker.git", {branch, "master"}}}
]}.

Quick start

λ rebar shell

Eshell V6.2  (abort with ^G)
1> hackney:start().
2> slacker:start().
3> Token = "your team token".
4> Options = [].
5> {ok, Status, Headers, Body} = slacker_user:list(Token, Options).

Message formatting

Slack messages are JSON structures that follow a specific formatting. After creating a message you pass it to slacker_chat:post_rich_message/5 as an attachment parameter.

Simple message with a bot icon and a colored left border:

Msg = slacker_rich_messages:format(<<"Hello">>, <<"Hello World!">>, <<"#df4f18">>).

Simple message with a table, a bot icon and a colored left border:

Fields = [[{title, "Col"}, {value, 1}]].
Msg = slacker_rich_messages:format_table(<<"Hello">>, <<"Hello World!">>, Fields, <<"#df4f18">>).

TODO

• files.upload API endpoint is not implemented
• RTM endpoint is not implemented

Contribute

• Fork slacker
• Write some new features or fix bug
• Test it
• Pull request

LICENSE

License in LICENSE file

More info

More info at [email protected]