Work with Calls

The following are Apex classes for the Slack calls API methods. These classes enable you to integrate your calls with Slack using the Calls API.

Represents a call on Slack.

The following are methods for Call.

Gets the channel that initiated the call.

Signature

Return Value

Type: List<String>

Gets the call end time in UTC UNIX timestamp format.

Signature

Return Value

Type: Integer

Gets the call start time in UTC UNIX timestamp format.

Signature

Return Value

Type: Integer

Gets the Slack clients that launched the call. For example, callapp://join/0987654321.

Signature

Return Value

Type: String

Gets the external display ID. For example, 705-292-868.

Signature

Return Value

Type: String

Gets the unique ID created by your app for your users.

Signature

Return Value

Type: String

Gets the call ID.

Signature

Return Value

Type: String

Gets the URL required for a client to join the call.

Signature

Return Value

Type: String

Gets the name of the call.

Signature

Return Value

Type: String

Gets a list of call participants.

Signature

Return Value

Type: List<Slack.CallParticipant>

Sets the channel that initiates the call.

Signature

Parameters

channels

Type: List<String>

Return Value

Type: void

Sets the call end time in UTC UNIX timestamp format.

Signature

Parameters

dateEnd

Type: Integer

Return Value

Type: void

Sets the call start time in UTC UNIX timestamp format.

Signature

Parameters

dateStart

Type: Integer

Return Value

Type: void

Sets the Slack clients that launched the call. For example, callapp://join/0987654321.

Signature

Parameters

desktopAppJoinUrl

Type: String

Return Value

Type: void

Sets the external display ID.

Signature

Parameters

externalDisplayId

Type: String

Return Value

Type: void

Sets the unique ID created by your app for your users.

Signature

Parameters

externalUniqueId

Type: String

Return Value

Type: void

Sets the call ID.

Signature

Parameters

id

Type: String

Return Value

Type: void

Sets the URL required for a client to join the call.

Signature

Parameters

joinUrl

Type: String

Return Value

Type: void

Sets the name of the call.

Signature

Parameters

title

Type: String

Return Value

Type: void

Sets the call participants.

Signature

Parameters

users

Type: List<Slack.CallParticipant>

Return Value

Type: void


Represent a user on a call.

The following are methods for CallParticipant.

Gets the URL for the call participant's avatar.

Signature

Return Value

Type: String

Gets the display name for the call participant.

Signature

Return Value

Type: String

Gets the external ID for the call participant. The external ID is a unique ID that your app creates for your users.

Signature

Return Value

Type: String

Gets the Slack ID for the call participant.

Signature

Return Value

Type: String

Sets the URL for the call participant's avatar.

Signature

Parameters

avatarUrl

Type: String

Return Value

Type: void

Sets the display name for the call participant.

Signature

Parameters

displayName

Type: String

Return Value

Type: void

Sets the external ID for the call participant.

Signature

Parameters

externalId

Type: String

Return Value

Type: void

Sets the Slack ID for the call participant.

Signature

Parameters

slackId

Type: String

Return Value

Type: void


Sends a request to register a new call.

Usage

See Slack's calls.add method.

The following are methods for CallsAddRequest.

Builds a request object that's used when executing the API call.

Signature

Return Value

Type: Slack.CallsAddRequest.Builder


Contains methods to build an instance of the Slack.CallsAddRequest class.

A Builder object is obtained by invoking one of the CallsAddRequest.Builder methods defined by the CallsAddRequest class.

The following are methods for CallsAddRequest.Builder. These methods are optional unless specified otherwise.

Required. Builds an instance of the Slack.CallsAddRequest class.

Signature

Return Value

Type: Slack.CallsAddRequest

The Slack user ID of the user who created the call. When this method is called with a user token, createdBy is optional and defaults to the authenticated user of the token. Otherwise, the field is required.

Signature

Parameters

createdBy

Type: String

Return Value

Type: Slacks.CallsAddRequest.Builder

Call start time in UTC UNIX timestamp format.

Signature

Parameters

dateStart

Type: Integer

Return Value

Type: Slack.CallsAddRequest.Builder

The URL that's used to launch the 3rd-party call for the Slack clients.

Signature

Parameters

desktopAppJoinUrl

Type: String

Return Value

Type: Slack.CallsAddRequest.Builder

An optional ID supplied by the 3rd-party call provider. This ID is displayed in the call object.

Signature

Parameters

externalDisplayId

Type: String

Return Value

Type: Slack.CallsAddRequest.Builder

Required. An ID supplied by the 3rd-party call provider. It must be unique across all calls from that service.

Signature

Parameters

externalUniqueId

Type: String

Return Value

Type: Slack.CallsAddRequest.Builder

Required. The URL required for a client to join the call.

Signature

joinUrl

Type: String

Return Value

Type: Slack.CallsAddRequest.Builder

The name for the call, which can be a short description.

Signature

Parameters

title

Type: String

Return Value

Type: Slack.CallsAddRequest.Builder

The list of call participants.

Signature

Parameters

users

Type: List<Slack.CallParticipant>

Return Value

Type: Slack.CallsAddRequest.Builder


Registers a new call.

This class contains standard response methods.

The following are methods for CallsAddResponse.

Gets information about the call.

Signature

Return Value

Type: Slack.Call

Signature

Return Value

Type: Slack.ResponseMetadata

Sets a call to be registered. setCall registers the details of the call with Slack.

Signature

Parameters

call

Type: Slack.Call

Return Value

Type: void

Signature

Parameters

responseMetadata

Type: Slack.ResponseMetadata

Return Value

Type: void


Sends a request to end a call.

Usage

See Slack's calls.add method.

The following are methods for CallsEndRequest.

Builds a request object that's used when executing the API call.

Signature

Return Value

Type: Slack.CallsEndRequest.Builder


Contains methods to build an instance of the Slack.CallsEndRequest class.

A Builder object is obtained by invoking one of the CallsEndRequest.Builder methods defined by the CallsEndRequest class.

The following are methods for CallsEndRequest.Builder. These methods are optional unless specified otherwise.

Required. Returns an instance of the Slack.CallsEndRequest object.

Signature

Return Value

Type: Slack.CallsEndRequest

Call duration in seconds.

Signature

Parameters

duration

Type: Integer

Return Value

Type: Slack.CallsEndRequest.Builder

Required. The ID that's returned when registering a call using CallsAddRequest.

Signature

Parameters

id

Type: String

Return Value

Type: Slack.CallsEndRequest.Builder


Ends a call.

This class contains standard response methods.

The following are methods for CallsEndResponse.

Gets information about the call.

Signature

Return Value

Type: Slack.Call

Signature

Return Value

Type: Slack.ResponseMetadata

Sets the call to be terminated.

Signature

Parameters

call

Type: Slack.Call

Return Value

Type: void

Signature

Parameters

responseMetadata

Type: Slack.ResponseMetadata

Return Value

Type: void


Sends a request to return information about a call.

Usage

See Slack's calls.info method.

The following are methods for CallsInfoRequest.

Builds a request object that's used when executing the API call.

Signature

Return Value

Type: Slack.CallsInfoRequest.Builder


Contains methods to build an instance of the Slack.CallsInfoRequest class.

A Builder object is obtained by invoking one of the CallsInfoRequest.Builder methods defined by the CallsInfoRequest class.

The following are methods for CallsInfoRequest.Builder. These methods are optional unless specified otherwise.

Required. Returns an instance of the Slack.CallsInfoRequesxt object.

Signature

Return Value

Type: Slack.CallsInfoRequest

Required. The ID of the call that's returned by CallsAddRequest.

Signature

Parameters

id

Type: String

Return Value

Type: Slack.CallsInfoRequest.Builder


Returns information about a call.

This class contains standard response methods.

The following are methods for CallsInfoResponse.

Gets information about the call.

Signature

Return Value

Type: Slack.Call

Signature

Return Value

Type: Slack.ResponseMetadata

Sets the call from which to get information.

Signature

Parameters

call

Type: Slack.Call

Return Value

Type: void

Signature

Parameters

responseMetadata

Type: Slack.ResponseMetadata

Return Value

Type: void


Sends a request to register new participants that are added to a call.

Usage

See Slack's calls.participants.add method.

The following are methods for CallsParticipantsAddRequest.

Builds a request object that's used when executing the API call.

Signature

Return Value

Type: Slack.CallsParticipantsAddRequest.Builder


Contains methods to build an instance of the Slack.CallsParticipantsAddRequest class.

A Builder object is obtained by invoking one of the CallsParticipantsAddRequest.Builder methods defined by the CallsParticipantsAddRequest class.

The following are methods for CallsParticipantsAddRequest.Builder.

Required. Returns an instance of the Slack.CallsParticipantsAddRequest object.

Signature

Return Value

Type: Slack.CallsParticipantsAddRequest

Required. The ID that's returned by CallsAddRequest.

Signature

Parameters

id

Type: String

Return Value

Type: Slack.CallsParticipantsAddRequest.Builder

Required. The list of users to add as participants in the call.

Signature

Parameters

users

Type: List<Slack.CallParticipant>

Return Value

Type: Slack.CallsParticipantsAddRequest.Builder


Registers new participants that are added to a call.

This class contains standard response methods.

The following are methods for CallsParticipantsAddResponse.

Gets information about the call.

Signature

Return Value

Type: Slack.Call

Signature

Return Value

Type: Slack.ResponseMetadata

Sets the call for which to register new participants.

Signature

Parameters

call

Type: Slack.Call

Return Value

Type: void

Signature

Parameters

responseMetadata

Type: Slack.ResponseMetadata

Return Value

Type: void


Sends a request to remove participants in the call.

Usage

See Slack's calls.participants.remove method.

The following are methods for CallsParticipantsRemoveRequest.

Builds a request object that's used when executing the API call.

Signature

Return Value

Type: Type: Slack.CallsParticipantsRemoveRequest.Builder


Contains methods to build an instance of the Slack.CallsParticipantsRemoveRequest class.

A Builder object is obtained by invoking one of the CallsParticipantsRemoveRequest.Builder methods defined by the CallsParticipantsRemoveRequest class.

The following are methods for CallsParticipantsRemoveRequest.Builder.

Required. Returns an instance of the Slack.CallsParticipantsRemoveRequest object.

Signature

Return Value

Type: Slack.CallsParticipantsRemoveRequest

Required. The ID that's returned by CallsAddRequest.

Signature

Parameters

id

Type: String

Return Value

Type: Type: Slack.CallsParticipantsRemoveRequest.Builder

Required. The list of users to remove as participants in the call.

Signature

Parameters

users

Type: List<Slack.CallParticipant>

Return Value

Type: Slack.CallsParticipantsRemoveRequest.Builder


Registers participants removed from a Call.

This class contains standard response methods.

The following are methods for CallsParticipantsRemoveResponse.

Gets information about the call.

Signature

Return Value

Type: Slack.Call

Signature

Return Value

Type: Slack.ResponseMetadata

Sets the call from which to remove participants.

Signature

Parameters

call

Type: Slack.Call

Return Value

Type: void

Signature

Parameters

responseMetadata

Type: Slack.ResponseMetadata

Return Value

Type: void


Sends a request to update information about a call.

The following are methods for CallsUpdateRequest.

Signature

Return Value

Type: Slack.CallsUpdateRequest.Builder


Contains methods to build an instance of the Slack.CallsUpdateRequest class.

A Builder object is obtained by invoking one of the CallsUpdateRequest.Builder methods defined by the CallsUpdateRequest class.

The following are methods for CallsUpdateRequest.Builder. These methods are optional unless specified otherwise.

Required. Returns an instance of the Slack.CallsUpdateRequest object.

Signature

Return Value

Type: Slack.CallsUpdateRequest

Signature

Parameters

desktopAppJoinUrl

Type: String

Return Value

Type: Slack.CallsUpdateRequest.Builder

Required. The ID that's returned by CallsAddRequest.

Signature

Parameters

id

Type: String

Return Value

Type: Slack.CallsUpdateRequest.Builder

Signature

Parameters

joinUrl

Type: String

Return Value

Type: Slack.CallsUpdateRequest.Builder

Signature

Parameters

title

Type: String

Return Value

Type: Slack.CallsUpdateRequest.Builder

Updates information about a call.

This class contains standard response methods.

The following are methods for CallsUpdateResponse.

Gets information about the call.

Signature

Return Value

Type: Slack.Call

Signature

Return Value

Type: Slack.ResponseMetadata

Sets the call for which to update information.

Signature

Parameters

call

Type: Slack.Call

Return Value

Type: void

Signature

Parameters

responseMetadata

Type: Slack.ResponseMetadata

Return Value

Type: void