SlackAPI

A Slack RTM and Web APIs client.

Installation

If available in Hex, the package can be installed by adding slack_api to your list of dependencies in mix.exs:

defdepsdo[{:slack_api,"~> 0.1.0"}]end

Real Time Messaging API

defmoduleErrorHandlerdo@behaviourSlackAPI.RTM.ErrorHandler.Behaviourdefhandle(error)do# Handle an errorenddefhandle(exception,strace)do# Handle an exceptionendend

defmoduleRTMHandlerdouseSlackAPI.RTM.HandlererrorErrorHandlerdefinit(data,opts)do# prepare a state{:ok,state}enddefhandle_connect(conn,state)do# Handle `connect` event.{:ok,state}enddefhandle_disconnect(conn,state)do# Handle `disconnect` event.{:ok,state}enddefhandle_message(message,state)do# Handle `message` event.{:ok,state}enddefhandle_cast(message,state)do# Handle `cast` event.# WebSockex.cast(websocket, {:event, "data"}){:ok,state}enddefhandle_info(message,state)do# Handle `info` event.# send(websocket, {:event, "data"}){:ok,state}endend

{:ok,websocket}=SlackAPI.RTM.start({RTMHandler,[token: "TOKEN",url: "https://slack.com"]})

Web API

client=SlackAPI.Web.new(token: "TOKEN",url: "https://slack.com")SlackAPI.Web.api().test(client,foo: "bar")SlackAPI.Web.api().test(client,%{foo: "bar"})

All required params should be explicitly passed into a function as arguments. Order this arguments should be the same as in the list of params in Slack docs.

Optional params should be passed as a map() or Keyword.t(). Excess arguments will be filtered out.

client=SlackAPI.Web.new(token: "TOKEN",url: "https://slack.com")SlackAPI.Web.channels().test(client,"channel-name",validate: true)SlackAPI.Web.channels().create(client,"channel-name",%{validate: true})

Supported endpoints:

api

• api.test

apps

• apps.uninstall
• apps.permissions.info
• apps.permissions.request
• apps.permissions.resources.list
• apps.permissions.scopes.list
• apps.permissions.users.list
• apps.permissions.users.request

auth

• auth.revoke
• auth.test

bots

• bots.info

chat

• chat.delete
• chat.deleteScheduledMessage
• chat.getPermalink
• chat.meMessage
• chat.postEphemeral
• chat.postMessage
• chat.scheduleMessage
• chat.unfurl
• chat.update

conversations

• conversations.archive
• conversations.close
• conversations.create
• conversations.history
• conversations.info
• conversations.invite
• conversations.join
• conversations.kick
• conversations.leave
• conversations.list
• conversations.members
• conversations.open
• conversations.rename
• conversations.replies
• conversations.setPurpose
• conversations.setTopic
• conversations.unarchive

dialog

• dialog.open

dnd

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

emoji

• emoji.list

files

• files.delete
• files.info
• files.list
• files.revokePublicURL
• files.sharedPublicURL
• files.upload
• files.comments.delete
• files.remote.add
• files.remote.info
• files.remote.list
• files.remote.remove
• files.remote.share
• files.remote.update

migration

• migration.exchange

oauth

• oauth.access
• oauth.token

pins

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

reactions

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

reminders

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

rtm

• rtm.connect
• rtm.start

search

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

team

• team.accessLogs
• team.billableInfo
• team.info
• team.integrationLogs
• team.profile.get

usergroups

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

users

• users.conversations
• users.deletePhoto
• users.getPresence
• users.identity
• users.info
• users.list
• users.lookupByEmail
• users.setActive
• users.setPhoto
• users.setPresence
• users.profile.get
• users.profile.set

To Do:

admin.apps

• admin.apps.approve
• admin.apps.restrict
• admin.apps.approved.list
• admin.apps.requests.list
• admin.apps.restricted.list

admin.conversations

• admin.conversations.setTeams

admin.emoji

• admin.emoji.add
• admin.emoji.addAlias
• admin.emoji.list
• admin.emoji.remove
• admin.emoji.rename

admin.inviteRequests

• admin.inviteRequests.approve
• admin.inviteRequests.deny
• admin.inviteRequests.list
• admin.inviteRequests.approved.list
• admin.inviteRequests.denied.list

admin.teams

• admin.teams.create
• admin.teams.list
• admin.teams.admins.list
• admin.teams.owners.list
• admin.teams.settings.info
• admin.teams.settings.setDefaultChannels
• admin.teams.settings.setDescription
• admin.teams.settings.setDiscoverability
• admin.teams.settings.setIcon
• admin.teams.settings.setName

admin.users

• admin.users.assign
• admin.users.invite
• admin.users.list
• admin.users.remove
• admin.users.setAdmin
• admin.users.setExpiration
• admin.users.setOwner
• admin.users.setRegular
• admin.users.session.reset

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/slack_api.