Get Stream Availability

Prev Next
Get
/streams/{STREAM_ID}/substreams/{SUBSTREAM_ID}/streamavailability

This API checks the availability of the stream (channel) and returns the channel’s state.

Enum:
Channel is not active = 0
Available (during business hours) = 1
Busy (Overload on agents during business hours) = 2
Unavailable (Off business hours or during a special day) = 3

Query Parameters include the following Boolean options:
A. Ignoring Automation
Since the bot is always available, the busy and unavailable states will not reflect if the automation function is included.

• When ignoreAutomationExsistance=true: API Ignores automation
• When ignoreAutomationExsistance=false (default): API Includes automation in the checking

B. Auto Assignment
• When autoAssign=true: API returns Available (Response 1) only for agents who have the Auto Assignment toggle turned ON in the channel permissions.
• When autoAssign=false (default): API returns status independently of auto-assignment.

C. Response Format
• When includeDetails=true: The API returns a detailed response object containing the availability state, along with a list of all agents and their current statuses and permissions for the specified stream or sub-stream
• When includeDetails=false (default): Returns only the availability state (1,2,3)


Comments:
When subchannels are used in the brand, the SUBSTREAM_ID becomes a REQUIRED path parameter.

Example of no subchannel and one query param:
https://api.bumpyard.com/streams/11345/streamavailability?includeDetails=true

Example of two query params:
https://api.bumpyardpro.com/streams/TbxH9RJIQrWI0hzA%3d%3d/substreams/12/streamavailability/ignoreAutomationExsistance=false&autoAssign=true

For Voice Calls, response states reflect the following conditions:

• Response 1 (Available) - Agents are active, not on calls, AND have auto-assignment permission to the stream/sub stream. (Auto Assignment toggle must be turned ON for the agent in the Channel permissions)


• Response 2 (Busy) – All agents with proper permissions for the stream/sub stream, are currently on other calls.


• Response 3 (Unavailable) - Any of these conditions are true:
- Not during business hours
- Special Day (holiday, etc.)
- All agents are in AWAY status / Not active
- No active voice agents have the required auto-assignment permissions to the stream/sub stream

Security
HTTP
Type bearer

API key is needed to authorize requests. You can get your API key via the management console.
A Bearer Token is needed to be set in the Authorization header of every API call.
For additional support you can contact us.

Path parameters
STREAM_ID
integer Required

A CommBox generated number for the channel

SUBSTREAM_ID
integer

A CommBox generated number for the sub-channel

Query parameters
ignoreAutomationExsistance
boolean
autoAssign
boolean
includeDetails
boolean
Responses
200

OK

Expand All
object
status
string
Example200
description
string
ExampleOperation successful
response_time
string
Example2024-08-06T07:51:52.2581942Z
data
object
state
integer
Example1
400

Bad Request - The request could not be understood by the server. Incoming parameters might not be valid

401

Unauthorized - The supplied credentials, if any, are not sufficient to access the resource

404

Not found - The requested resource is not found

429

Too Many Requests - Too many requests have been made in a short period of time (Throttling)

500

Server Error - The server could not return the representation due to an internal server error

501

Not Implemented - The requested operation is not supported