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
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.
A CommBox generated number for the channel
A CommBox generated number for the sub-channel
OK
Bad Request - The request could not be understood by the server. Incoming parameters might not be valid
Unauthorized - The supplied credentials, if any, are not sufficient to access the resource
Not found - The requested resource is not found
Too Many Requests - Too many requests have been made in a short period of time (Throttling)
Server Error - The server could not return the representation due to an internal server error
Not Implemented - The requested operation is not supported