Web.Slack.Classy

Documentation

data SlackConfig

Constructors

SlackConfig

Fields

• slackConfigManager :: Manager
• slackConfigToken :: Text

Instances

HasManager SlackConfig

Defined in Web.Slack.Classy

Methods

getManager :: SlackConfig -> Manager

HasToken SlackConfig

Defined in Web.Slack.Classy

Methods

getToken :: SlackConfig -> Text

mkSlackConfig :: Text -> IO SlackConfig

Prepare a SlackConfig from a slack token. You can then call the other functions providing this in a reader context.

apiTest :: (MonadReader env m, HasManager env, MonadIO m) => TestReq -> m (Response TestRsp)

Check API calling code.

https://api.slack.com/methods/api.test

authTest :: (MonadReader env m, HasManager env, HasToken env, MonadIO m) => m (Response TestRsp)

Check authentication and identity.

https://api.slack.com/methods/auth.test

chatPostMessage :: (MonadReader env m, HasManager env, HasToken env, MonadIO m) => PostMsgReq -> m (Response PostMsgRsp)

Send a message to a channel.

https://api.slack.com/methods/chat.postMessage

conversationsList :: (MonadReader env m, HasManager env, HasToken env, MonadIO m) => ListReq -> m (Response ListRsp)

Retrieve conversations list.

https://api.slack.com/methods/conversations.list

conversationsHistory :: (MonadReader env m, HasManager env, HasToken env, MonadIO m) => HistoryReq -> m (Response HistoryRsp)

Retrieve ceonversation history. Consider using historyFetchAll in combination with this function.

https://api.slack.com/methods/conversations.history

conversationsHistoryAll

Arguments

:: (MonadReader env m, HasManager env, HasToken env, MonadIO m)

=> HistoryReq

The first request to send. _NOTE_: historyReqCursor is silently ignored.

-> m (LoadPage m Message)

An action which returns a new page of messages every time called. If there are no pages anymore, it returns an empty list.

Returns an action to send a request to get the history of a conversation.

To fetch all messages in the conversation, run the returned LoadPage action repeatedly until it returns an empty list.

conversationsReplies :: (MonadReader env m, HasManager env, HasToken env, MonadIO m) => RepliesReq -> m (Response HistoryRsp)

Retrieve replies of a conversation. Consider using repliesFetchAll if you want to get entire replies of a conversation.

https://api.slack.com/methods/conversations.replies

repliesFetchAll

Arguments

:: (MonadReader env m, HasManager env, HasToken env, MonadIO m)

=> RepliesReq

The first request to send. _NOTE_: repliesReqCursor is silently ignored.

-> m (LoadPage m Message)

An action which returns a new page of messages every time called. If there are no pages anymore, it returns an empty list.

Returns an action to send a request to get the replies of a conversation.

To fetch all replies in the conversation, run the returned LoadPage action repeatedly until it returns an empty list.

• NOTE*: The conversations.replies endpoint always returns the first message of the thread. So every page returned by the LoadPage action includes the first message of the thread. You should drop it if you want to collect messages in a thread without duplicates.

getUserDesc

Arguments

:: (UserId -> Text)

A function to give a default username in case the username is unknown

-> ListRsp

List of users as known by the slack server. See usersList.

-> UserId -> Text

A function from UserId to username.

Returns a function to get a username from a UserId. Comes in handy to use messageToHtml

usersList :: (MonadReader env m, HasManager env, HasToken env, MonadIO m) => ListReq -> m (Response ListRsp)

This method returns a list of all users in the team. This includes deleted/deactivated users.

https://api.slack.com/methods/users.list

userLookupByEmail :: (MonadReader env m, HasManager env, HasToken env, MonadIO m) => Email -> m (Response UserRsp)

This method returns a list of all users in the team. This includes deleted/deactivated users.

https://api.slack.com/methods/users.lookupByEmail

authenticateReq :: Text -> Request -> Request

type Response a = Either SlackClientError a

type LoadPage m a = m (Response [a])

Represents an action which returns a paginated response from Slack. Every time calling the action, it performs a request with a new cursor to get the next page. If there is no more response, the action returns an empty list.

class HasManager a where

Implemented by SlackConfig

Methods

getManager :: a -> Manager

Instances

HasManager SlackConfig

Defined in Web.Slack.Classy

Methods

getManager :: SlackConfig -> Manager

class HasToken a where

Implemented by SlackConfig

Methods

getToken :: a -> Text

Instances

HasToken SlackConfig

Defined in Web.Slack.Classy

Methods

getToken :: SlackConfig -> Text