Ref: https://api.slack.com/changelog/2020-01-deprecating-antecedents-to-the-conversations-api

channels.*, groups.*, im.*, and mpim.* will be unavailable after February 24th, 2021.

• The final date for existing apps is now February 24th, 2021.
• We'll stop allowing newly created Slack apps to use these deprecated APIs beginning June 10th, 2020.
• All channels., groups., im., & mpim. methods will return deprecation warnings beginning June 10th, 2020.

(Unless #56 changes from CircleCI to Travis CI.)

Latest version in hackage is slack-web-0.2.0.11 which was uploaded at 2019-03-01

• auth.revoke
• auth.test

• mpim.close
• mpim.history
• mpim.list
• mpim.mark
• mpim.open
• mpim.replies

• usergroups.users.list
• usergroups.users.update

See commercialhaskell/stackage#3337.

• users.profile.get
• users.profile.set

I wrote a bug then couldn't debug it with OTel. It would be nice if we could instrument slack-web. Seems that the way to achieve this is to do some hacking to servant and probably upstream it to the hs-opentelemetry repo.

Related: haskell-servant/servant#1617

• channels.archive
• channels.create
• channels.history
• channels.info
• channels.invite
• channels.join
• channels.kick
• channels.leave
• channels.list
• channels.mark
• channels.rename
• channels.replies
• channels.setPurpose
• channels.setTopic
• channels.unarchive

• team.profile.get

• reminders.add
• reminders.complete
• reminders.delete
• reminders.info
• reminders.list

• rtm.start

There are some comments about this in issues and pull requests, so I'm opening this issue to organize notes about transferring the library in one place. Here's a list of previous comments:

• #93 (comment)
• #94 (comment)

In summary, I'm looking for someone else to take over this library (different maintainer or owner). As mentioned by @lf-, @MercuryTechnologies can do this and has some plans about it (see #94 for more details).

I'm opening this issue to continue the conversation here and complete the process, and also in case anyone else has comments about it (in particular @igrep or @emmanueltouzery, current GitHub collaborators and Hackage maintainers).

See commercialhaskell/stackage#4290.

• files.delete
• files.info
• files.list
• files.revokePublicURL
• files.sharedPublicURL
• files.upload

https://api.slack.com/docs/rate-limits#events_api

I've been hit by slack rate limits (and not even doing that many calls.. they've become much more stringent with that recently). When that happens we get back http 429, which slack-web forwards to the caller, and there is a HTTP header: Retry-After: <number of seconds>.

I think that maybe slack-web should optionally handle that for the user. I can maybe try to make a PR, when I get some time, but we'd need to agree as to how to do implement that.

Do we add a new option to all existing calls RateLimitHandling = RateLimitFail | RateLimitWaitAndResend? Do we do it automatically out of the box, without any way to disable it (in which case there is no API change)? Or do we consider slack-web is the wrong layer in the stack to deal with that, and we change nothing compared to the current situation?

• im.close
• im.history
• im.list
• im.mark
• im.open
• im.replies

• emoji.list

In Stackage Nightly:

Building library for slack-web-0.2.0.7..
[ 1 of 12] Compiling Web.Slack.Types  ( src/Web/Slack/Types.hs, dist/build/Web/Slack/Types.o )

src/Web/Slack/Types.hs:28:1: warning: [-Wunused-imports]
    The import of ‘Data.Monoid’ is redundant
      except perhaps to import instances from ‘Data.Monoid’
    To import instances alone, use: import Data.Monoid()
   |
28 | import Data.Monoid
   | ^^^^^^^^^^^^^^^^^^
[ 2 of 12] Compiling Web.Slack.MessageParser ( src/Web/Slack/MessageParser.hs, dist/build/Web/Slack/MessageParser.o )

src/Web/Slack/MessageParser.hs:141:29: error:
    Variable not in scope:
      anyChar :: ParsecT MegaparsecError Text Identity Char
    |
141 |   (string "```" >> manyTill anyChar (string "```"))
    |                             ^^^^^^^

• files.comments.add
• files.comments.delete
• files.comments.edit

• dnd.endDnd
• dnd.endSnooze
• dnd.info
• dnd.setSnooze
• dnd.teamInfo

It looks like slack has a way to lookup users by email to return the rest of the user object, but it isn't exposed in this library right now.

The current user object also appears to be missing a fair number of fields:

Would you be open to a PR to add support for that user method and extra user fields?

• groups.archive
• groups.close
• groups.create
• groups.createChild
• groups.history
• groups.info
• groups.invite
• groups.kick
• groups.leave
• groups.list
• groups.mark
• groups.open
• groups.rename
• groups.replies
• groups.setPurpose
• groups.setTopic
• groups.unarchive

• reactions.add
• reactions.get
• reactions.list
• reactions.remove

The current version from Hackage does not include the latest fix that puts the token in the header. Therefore, all requests fail with "invalid_auth".

Thanks.

• pins.add
• pins.list
• pins.remove

• oauth.access

• users.deletePhoto
• users.getPresence
• users.identity
• users.info
• users.list
• users.setActive
• users.setPhoto
• users.setPresence

Problem

Current API functions in slack-web are typed as following for example:

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

IMO this is confusing for people unfamiliar with the "ReaderT Pattern" (e.g. Newbies who just want to try Slack Web API in Haskell). Helping the users adopt the "ReaderT Pattern" is NOT slack-web's responsibility because it isn't directly related to the "ReaderT Pattern". In addition, the simplified versions (for example below) and the original versions are easily converted mutually:

authTest ::  SlackConfig -> IO (Response TestRsp)
-- Or
authTest :: Manager -> SlackConfigToken -> IO (Response TestRsp)
type SlackConfigToken = Text

Suggested Changes

• Change the type of the API functions into SlackConfig -> IO (Response a)
• Leave the current version as a separate module Web.Slack.ReaderT for convenience and compatibility.

• search.all
• search.files
• search.messages

• chat.delete
• chat.meMessage
• chat.postMessage
• chat.update

• bots.info

• stars.add
• stars.list
• stars.remove

(This might mean changing from CircleCI to Travis CI.)

CI is out of date. See #93 (comment) for a recommendation to use haskell-ci or switch to GitHub Actions.

• team.accessLogs
• team.billableInfo
• team.info
• team.integrationLogs

• usergroups.create
• usergroups.disable
• usergroups.enable
• usergroups.list
• usergroups.update