DokumentacjaEngagement Platform API
Sign inGet started
Guides
API

Agent Management

GET
/workspaces/{workspaceId}/agents
List Agents
Parametry zapytania
limit
integer
Limits the number of results to return.
pageToken
string
The cursor that keeps track of the current position in the results.
reverse
boolean
Reverses the order in which the results are returned.
sortBy
string
Sort by field specified
Possible values: createdAt, statusAssignedCount, assignedCount, name
name
string
Filter by agent name
email
string
Filter by agent email
agentStatuses
array
Filter by agent status
roleIds
array
Filter by agent role ids
lastStatusActivitySince
string
To filter agents by their last status change since.
lastStatusActivityUpto
string
To filter agents by their last status change activity time.
agentIds
array
To find specific agents by their ids. If this is specified, other parameters are ignored.
Treść odpowiedzi
results
array of object
wymagane
Pokaż atrybuty podrzędne
results.id
string
wymagane
results.status
string
Possible values: active, away, out-of-office
results.statusBeforeOffline
string
Possible values: active, away, out-of-office
results.name
string
results.overrideName
boolean
results.workspaceId
string
wymagane
results.type
string
Possible values: user, ai
results.userEmails
array of string
results.bio
string
results.avatarUrl
string
results.dropVms
array
Pokaż atrybuty podrzędne
results.dropVms.name
string
results.dropVms.playback
object
wymagane
Pokaż atrybuty podrzędne
results.dropVms.playback.media
array of string
wymagane
results.dropVms.playback.pauseMilliseconds
integer
results.tagCount
integer
results.wrapUpTime
integer
results.rootItemAssignedCount
integer
results.lastAssignedAt
string
results.lastSetToAwayAt
string
results.teams
array of object
Pokaż atrybuty podrzędne
results.teams.id
string
The team's ID this agent belongs to.
results.teams.name
string
The name of the team this agent belongs to.
results.teams.memberSince
string
The timestamp of when this agent joined the team.
results.teams.activeMemberCount
integer
The number of active members in the team.
results.teams.pendingMemberCount
integer
The number of pending members in the team.
results.workload
object
Pokaż atrybuty podrzędne
results.workload.id
string
results.workload.workload
object
Pokaż atrybuty podrzędne
results.workload.workload.messaging
integer
results.workload.workload.email
integer
results.workload.rule
object
Pokaż atrybuty podrzędne
results.workload.rule.id
string
wymagane
results.workload.rule.workspaceId
string
wymagane
results.workload.rule.name
string
wymagane
results.workload.rule.description
string
wymagane
results.workload.rule.default
boolean
results.workload.rule.capacity
object
wymagane
Pokaż atrybuty podrzędne
results.workload.rule.capacity.messaging
integer
results.workload.rule.capacity.email
integer
results.workload.rule.assignedAgentIds
array of string
results.workload.rule.createdAt
string
results.workload.rule.updatedAt
string
results.workload.ruleId
string
results.workload.updatedAt
string
results.createdAt
string
wymagane
results.updatedAt
string
wymagane
results.availability
object
Pokaż atrybuty podrzędne
results.availability.status
string
Possible values: active, away, out-of-office
results.availability.activity
string
Possible values: available, in-call, busy, wrap-up-time, do-not-disturb, offline, not-available, out-of-hours, custom
results.availability.activityTtl
integer
results.availability.activityText
string
results.availability.lastStatusSet
string
results.availability.lastActivitySet
string
results.availability.updatedAt
string
results.timezone
string
results.defaultCountryCode
string
results.defaultCallerId
string
results.forwardNumber
object
Pokaż atrybuty podrzędne
results.forwardNumber.enabled
boolean
results.forwardNumber.number
string
results.forwardNumber.maskCaller
boolean
results.transcriptionLocale
string
Curated set of BCP47 locale identifiers supported by Bird speech-to-text products
Possible values: ar-AE, ar-SA, cmn-CN, cy-GB, da-DK, de-CH, de-DE, el-GR, en-AU, en-GB, en-GB-WLS, en-IE, en-IN, en-NZ, en-US, en-ZA, es-ES, es-MX, es-US, fr-CA, fr-FR, he-IL, hi-IN, id-ID, is-IS, it-IT, ja-JP, ko-KR, ms-MY, nb-NO, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sv-SE, ta-IN, te-IN, th-TH, tr-TR, vi-VN, zh-CN, zh-HK, zh-TW, arb, af-ZA, bn-IN, ca-ES, cmn-TW, cs-CZ, fi-FI, fil-PH, gu-IN, hu-HU, kn-IN, lt-LT, lv-LV, ml-IN, mr-IN, pa-IN, sk-SK, sr-RS, uk-UA, yue-HK, no-NO
results.roles
array of object
Pokaż atrybuty podrzędne
results.roles.id
string
wymagane
results.roles.type
string
wymagane
Possible values: organization, managed
results.roles.workspaces
array of string
results.user
object
Pokaż atrybuty podrzędne
results.user.id
string
ID of the user
results.user.name
string
The display name for the user
results.user.avatarUrl
string
URL to the user's profile picture.
results.user.defaultEmail
string
The default email of the user in the list of emails.
results.user.phoneNumber
string
results.weeklySchedule
object
Pokaż atrybuty podrzędne
results.weeklySchedule.monday
object
Pokaż atrybuty podrzędne
results.weeklySchedule.monday.from
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.monday.from.hour
integer
wymagane
results.weeklySchedule.monday.from.minute
integer
results.weeklySchedule.monday.to
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.monday.to.hour
integer
wymagane
results.weeklySchedule.monday.to.minute
integer
results.weeklySchedule.tuesday
object
Pokaż atrybuty podrzędne
results.weeklySchedule.tuesday.from
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.tuesday.from.hour
integer
wymagane
results.weeklySchedule.tuesday.from.minute
integer
results.weeklySchedule.tuesday.to
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.tuesday.to.hour
integer
wymagane
results.weeklySchedule.tuesday.to.minute
integer
results.weeklySchedule.wednesday
object
Pokaż atrybuty podrzędne
results.weeklySchedule.wednesday.from
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.wednesday.from.hour
integer
wymagane
results.weeklySchedule.wednesday.from.minute
integer
results.weeklySchedule.wednesday.to
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.wednesday.to.hour
integer
wymagane
results.weeklySchedule.wednesday.to.minute
integer
results.weeklySchedule.thursday
object
Pokaż atrybuty podrzędne
results.weeklySchedule.thursday.from
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.thursday.from.hour
integer
wymagane
results.weeklySchedule.thursday.from.minute
integer
results.weeklySchedule.thursday.to
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.thursday.to.hour
integer
wymagane
results.weeklySchedule.thursday.to.minute
integer
results.weeklySchedule.friday
object
Pokaż atrybuty podrzędne
results.weeklySchedule.friday.from
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.friday.from.hour
integer
wymagane
results.weeklySchedule.friday.from.minute
integer
results.weeklySchedule.friday.to
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.friday.to.hour
integer
wymagane
results.weeklySchedule.friday.to.minute
integer
results.weeklySchedule.saturday
object
Pokaż atrybuty podrzędne
results.weeklySchedule.saturday.from
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.saturday.from.hour
integer
wymagane
results.weeklySchedule.saturday.from.minute
integer
results.weeklySchedule.saturday.to
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.saturday.to.hour
integer
wymagane
results.weeklySchedule.saturday.to.minute
integer
results.weeklySchedule.sunday
object
Pokaż atrybuty podrzędne
results.weeklySchedule.sunday.from
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.sunday.from.hour
integer
wymagane
results.weeklySchedule.sunday.from.minute
integer
results.weeklySchedule.sunday.to
object
wymagane
Pokaż atrybuty podrzędne
results.weeklySchedule.sunday.to.hour
integer
wymagane
results.weeklySchedule.sunday.to.minute
integer
results.holidays
array of object
Pokaż atrybuty podrzędne
results.holidays.name
string
wymagane
results.holidays.day
integer
wymagane
results.holidays.month
integer
wymagane
results.assignedSkills
array of object
Pokaż atrybuty podrzędne
results.assignedSkills.id
string
wymagane
results.assignedSkills.name
string
wymagane
results.assignedSkills.selectedValues
array of object
wymagane
Pokaż atrybuty podrzędne
results.assignedSkills.selectedValues.icon
string
results.assignedSkills.selectedValues.id
string
wymagane
results.assignedSkills.selectedValues.value
string
wymagane
results.assignedSkills.valueType
string
wymagane
AgentSkillValueType defines how can the Values of a Skill can be selected.
Possible values: single, multiple, boolean
results.defaultSenderId
string
The default Sender Profile to select for this agent when composing a new message.
results.outOfOfficeResponse
string
nextPageToken
string
The token that can be passed as pageToken in URL to retrieve the next set of results. If missing, no more results to display.
total
integer
The total number of results across all pages.
Przykład kodu
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/agents' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
POST
/workspaces/{workspaceId}/agents
Create a new agent with specified details like name, role, and basic bio.
Treść żądania
bio
string
type
string
wymagane
Possible values: user
userId
string
wymagane
teamId
string
teamIds
array of string
timezone
string
defaultCountryCode
string
weeklySchedule
object
Pokaż parametry podrzędne
weeklySchedule.monday
object
Pokaż parametry podrzędne
weeklySchedule.monday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.monday.from.hour
integer
wymagane
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.monday.to.hour
integer
wymagane
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Pokaż parametry podrzędne
weeklySchedule.tuesday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.tuesday.from.hour
integer
wymagane
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.tuesday.to.hour
integer
wymagane
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Pokaż parametry podrzędne
weeklySchedule.wednesday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.wednesday.from.hour
integer
wymagane
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.wednesday.to.hour
integer
wymagane
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Pokaż parametry podrzędne
weeklySchedule.thursday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.thursday.from.hour
integer
wymagane
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.thursday.to.hour
integer
wymagane
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Pokaż parametry podrzędne
weeklySchedule.friday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.friday.from.hour
integer
wymagane
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.friday.to.hour
integer
wymagane
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Pokaż parametry podrzędne
weeklySchedule.saturday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.saturday.from.hour
integer
wymagane
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.saturday.to.hour
integer
wymagane
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Pokaż parametry podrzędne
weeklySchedule.sunday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.sunday.from.hour
integer
wymagane
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.sunday.to.hour
integer
wymagane
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Pokaż parametry podrzędne
holidays.name
string
wymagane
holidays.day
integer
wymagane
holidays.month
integer
wymagane
Treść odpowiedzi
id
string
wymagane
status
string
Possible values: active, away, out-of-office
statusBeforeOffline
string
Possible values: active, away, out-of-office
name
string
overrideName
boolean
workspaceId
string
wymagane
type
string
Possible values: user, ai
userEmails
array of string
bio
string
avatarUrl
string
dropVms
array
Pokaż atrybuty podrzędne
dropVms.name
string
dropVms.playback
object
wymagane
Pokaż atrybuty podrzędne
dropVms.playback.media
array of string
wymagane
dropVms.playback.pauseMilliseconds
integer
tagCount
integer
wrapUpTime
integer
rootItemAssignedCount
integer
lastAssignedAt
string
lastSetToAwayAt
string
teams
array of object
Pokaż atrybuty podrzędne
teams.id
string
The team's ID this agent belongs to.
teams.name
string
The name of the team this agent belongs to.
teams.memberSince
string
The timestamp of when this agent joined the team.
teams.activeMemberCount
integer
The number of active members in the team.
teams.pendingMemberCount
integer
The number of pending members in the team.
workload
object
Pokaż atrybuty podrzędne
workload.id
string
workload.workload
object
Pokaż atrybuty podrzędne
workload.workload.messaging
integer
workload.workload.email
integer
workload.rule
object
Pokaż atrybuty podrzędne
workload.rule.id
string
wymagane
workload.rule.workspaceId
string
wymagane
workload.rule.name
string
wymagane
workload.rule.description
string
wymagane
workload.rule.default
boolean
workload.rule.capacity
object
wymagane
Pokaż atrybuty podrzędne
workload.rule.capacity.messaging
integer
workload.rule.capacity.email
integer
workload.rule.assignedAgentIds
array of string
workload.rule.createdAt
string
workload.rule.updatedAt
string
workload.ruleId
string
workload.updatedAt
string
createdAt
string
wymagane
updatedAt
string
wymagane
availability
object
Pokaż atrybuty podrzędne
availability.status
string
Possible values: active, away, out-of-office
availability.activity
string
Possible values: available, in-call, busy, wrap-up-time, do-not-disturb, offline, not-available, out-of-hours, custom
availability.activityTtl
integer
availability.activityText
string
availability.lastStatusSet
string
availability.lastActivitySet
string
availability.updatedAt
string
timezone
string
defaultCountryCode
string
defaultCallerId
string
forwardNumber
object
Pokaż atrybuty podrzędne
forwardNumber.enabled
boolean
forwardNumber.number
string
forwardNumber.maskCaller
boolean
transcriptionLocale
string
Curated set of BCP47 locale identifiers supported by Bird speech-to-text products
Possible values: ar-AE, ar-SA, cmn-CN, cy-GB, da-DK, de-CH, de-DE, el-GR, en-AU, en-GB, en-GB-WLS, en-IE, en-IN, en-NZ, en-US, en-ZA, es-ES, es-MX, es-US, fr-CA, fr-FR, he-IL, hi-IN, id-ID, is-IS, it-IT, ja-JP, ko-KR, ms-MY, nb-NO, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sv-SE, ta-IN, te-IN, th-TH, tr-TR, vi-VN, zh-CN, zh-HK, zh-TW, arb, af-ZA, bn-IN, ca-ES, cmn-TW, cs-CZ, fi-FI, fil-PH, gu-IN, hu-HU, kn-IN, lt-LT, lv-LV, ml-IN, mr-IN, pa-IN, sk-SK, sr-RS, uk-UA, yue-HK, no-NO
roles
array of object
Pokaż atrybuty podrzędne
roles.id
string
wymagane
roles.type
string
wymagane
Possible values: organization, managed
roles.workspaces
array of string
user
object
Pokaż atrybuty podrzędne
user.id
string
ID of the user
user.name
string
The display name for the user
user.avatarUrl
string
URL to the user's profile picture.
user.defaultEmail
string
The default email of the user in the list of emails.
user.phoneNumber
string
weeklySchedule
object
Pokaż atrybuty podrzędne
weeklySchedule.monday
object
Pokaż atrybuty podrzędne
weeklySchedule.monday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.monday.from.hour
integer
wymagane
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.monday.to.hour
integer
wymagane
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.from.hour
integer
wymagane
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.to.hour
integer
wymagane
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.from.hour
integer
wymagane
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.to.hour
integer
wymagane
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Pokaż atrybuty podrzędne
weeklySchedule.thursday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.thursday.from.hour
integer
wymagane
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.thursday.to.hour
integer
wymagane
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Pokaż atrybuty podrzędne
weeklySchedule.friday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.friday.from.hour
integer
wymagane
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.friday.to.hour
integer
wymagane
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Pokaż atrybuty podrzędne
weeklySchedule.saturday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.saturday.from.hour
integer
wymagane
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.saturday.to.hour
integer
wymagane
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Pokaż atrybuty podrzędne
weeklySchedule.sunday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.sunday.from.hour
integer
wymagane
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.sunday.to.hour
integer
wymagane
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Pokaż atrybuty podrzędne
holidays.name
string
wymagane
holidays.day
integer
wymagane
holidays.month
integer
wymagane
assignedSkills
array of object
Pokaż atrybuty podrzędne
assignedSkills.id
string
wymagane
assignedSkills.name
string
wymagane
assignedSkills.selectedValues
array of object
wymagane
Pokaż atrybuty podrzędne
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
wymagane
assignedSkills.selectedValues.value
string
wymagane
assignedSkills.valueType
string
wymagane
AgentSkillValueType defines how can the Values of a Skill can be selected.
Possible values: single, multiple, boolean
defaultSenderId
string
The default Sender Profile to select for this agent when composing a new message.
outOfOfficeResponse
string
Przykład kodu
curl -X POST 'https://api.bird.com/workspaces/{workspaceId}/agents' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
GET
/workspaces/{workspaceId}/all-agents
Lists all agents for a workspace returning only minimal fields for each agent.
Treść odpowiedzi
results
array of object
wymagane
Pokaż atrybuty podrzędne
results.id
string
wymagane
results.status
string
Possible values: active, away, out-of-office
results.activity
string
Possible values: available, in-call, busy, wrap-up-time, do-not-disturb, offline, not-available, out-of-hours, custom
results.name
string
results.avatarUrl
string
results.createdAt
string
wymagane
Przykład kodu
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/all-agents' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
GET
/workspaces/{workspaceId}/agents/{agentId}
Retrieve information about a specific agent, including their name, bio, status.
Treść odpowiedzi
id
string
wymagane
status
string
Possible values: active, away, out-of-office
statusBeforeOffline
string
Possible values: active, away, out-of-office
name
string
overrideName
boolean
workspaceId
string
wymagane
type
string
Possible values: user, ai
userEmails
array of string
bio
string
avatarUrl
string
dropVms
array
Pokaż atrybuty podrzędne
dropVms.name
string
dropVms.playback
object
wymagane
Pokaż atrybuty podrzędne
dropVms.playback.media
array of string
wymagane
dropVms.playback.pauseMilliseconds
integer
tagCount
integer
wrapUpTime
integer
rootItemAssignedCount
integer
lastAssignedAt
string
lastSetToAwayAt
string
teams
array of object
Pokaż atrybuty podrzędne
teams.id
string
The team's ID this agent belongs to.
teams.name
string
The name of the team this agent belongs to.
teams.memberSince
string
The timestamp of when this agent joined the team.
teams.activeMemberCount
integer
The number of active members in the team.
teams.pendingMemberCount
integer
The number of pending members in the team.
workload
object
Pokaż atrybuty podrzędne
workload.id
string
workload.workload
object
Pokaż atrybuty podrzędne
workload.workload.messaging
integer
workload.workload.email
integer
workload.rule
object
Pokaż atrybuty podrzędne
workload.rule.id
string
wymagane
workload.rule.workspaceId
string
wymagane
workload.rule.name
string
wymagane
workload.rule.description
string
wymagane
workload.rule.default
boolean
workload.rule.capacity
object
wymagane
Pokaż atrybuty podrzędne
workload.rule.capacity.messaging
integer
workload.rule.capacity.email
integer
workload.rule.assignedAgentIds
array of string
workload.rule.createdAt
string
workload.rule.updatedAt
string
workload.ruleId
string
workload.updatedAt
string
createdAt
string
wymagane
updatedAt
string
wymagane
availability
object
Pokaż atrybuty podrzędne
availability.status
string
Possible values: active, away, out-of-office
availability.activity
string
Possible values: available, in-call, busy, wrap-up-time, do-not-disturb, offline, not-available, out-of-hours, custom
availability.activityTtl
integer
availability.activityText
string
availability.lastStatusSet
string
availability.lastActivitySet
string
availability.updatedAt
string
timezone
string
defaultCountryCode
string
defaultCallerId
string
forwardNumber
object
Pokaż atrybuty podrzędne
forwardNumber.enabled
boolean
forwardNumber.number
string
forwardNumber.maskCaller
boolean
transcriptionLocale
string
Curated set of BCP47 locale identifiers supported by Bird speech-to-text products
Possible values: ar-AE, ar-SA, cmn-CN, cy-GB, da-DK, de-CH, de-DE, el-GR, en-AU, en-GB, en-GB-WLS, en-IE, en-IN, en-NZ, en-US, en-ZA, es-ES, es-MX, es-US, fr-CA, fr-FR, he-IL, hi-IN, id-ID, is-IS, it-IT, ja-JP, ko-KR, ms-MY, nb-NO, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sv-SE, ta-IN, te-IN, th-TH, tr-TR, vi-VN, zh-CN, zh-HK, zh-TW, arb, af-ZA, bn-IN, ca-ES, cmn-TW, cs-CZ, fi-FI, fil-PH, gu-IN, hu-HU, kn-IN, lt-LT, lv-LV, ml-IN, mr-IN, pa-IN, sk-SK, sr-RS, uk-UA, yue-HK, no-NO
roles
array of object
Pokaż atrybuty podrzędne
roles.id
string
wymagane
roles.type
string
wymagane
Possible values: organization, managed
roles.workspaces
array of string
user
object
Pokaż atrybuty podrzędne
user.id
string
ID of the user
user.name
string
The display name for the user
user.avatarUrl
string
URL to the user's profile picture.
user.defaultEmail
string
The default email of the user in the list of emails.
user.phoneNumber
string
weeklySchedule
object
Pokaż atrybuty podrzędne
weeklySchedule.monday
object
Pokaż atrybuty podrzędne
weeklySchedule.monday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.monday.from.hour
integer
wymagane
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.monday.to.hour
integer
wymagane
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.from.hour
integer
wymagane
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.to.hour
integer
wymagane
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.from.hour
integer
wymagane
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.to.hour
integer
wymagane
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Pokaż atrybuty podrzędne
weeklySchedule.thursday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.thursday.from.hour
integer
wymagane
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.thursday.to.hour
integer
wymagane
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Pokaż atrybuty podrzędne
weeklySchedule.friday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.friday.from.hour
integer
wymagane
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.friday.to.hour
integer
wymagane
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Pokaż atrybuty podrzędne
weeklySchedule.saturday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.saturday.from.hour
integer
wymagane
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.saturday.to.hour
integer
wymagane
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Pokaż atrybuty podrzędne
weeklySchedule.sunday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.sunday.from.hour
integer
wymagane
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.sunday.to.hour
integer
wymagane
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Pokaż atrybuty podrzędne
holidays.name
string
wymagane
holidays.day
integer
wymagane
holidays.month
integer
wymagane
assignedSkills
array of object
Pokaż atrybuty podrzędne
assignedSkills.id
string
wymagane
assignedSkills.name
string
wymagane
assignedSkills.selectedValues
array of object
wymagane
Pokaż atrybuty podrzędne
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
wymagane
assignedSkills.selectedValues.value
string
wymagane
assignedSkills.valueType
string
wymagane
AgentSkillValueType defines how can the Values of a Skill can be selected.
Possible values: single, multiple, boolean
defaultSenderId
string
The default Sender Profile to select for this agent when composing a new message.
outOfOfficeResponse
string
Przykład kodu
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/agents/{agentId}' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
GET
/workspaces/{workspaceId}/agents/{agentId}/presigned-upload
Retrieve the url and form data to post profile avatar directly.
Treść odpowiedzi
mediaUrl
string
URL to download the media from
fileId
string
File ID
url
string
wymagane
URL to post the image to
formData
object
wymagane
expectedFields
array of string
Przykład kodu
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/agents/{agentId}/presigned-upload' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
POST
/workspaces/{workspaceId}/agents/{agentId}/presigned-upload/audio
Retrieve the url and form data to post audio files directly.
Treść odpowiedzi
mediaUrl
string
URL to download the media from
fileId
string
File ID
url
string
wymagane
URL to post the image to
formData
object
wymagane
expectedFields
array of string
Przykład kodu
curl -X POST 'https://api.bird.com/workspaces/{workspaceId}/agents/{agentId}/presigned-upload/audio' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
GET
/workspaces/{workspaceId}/agents/{agentId}/media/{fileId}/download
Get media download from an agent
Przykład kodu
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/agents/{agentId}/media/{fileId}/download' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
PATCH
/workspaces/{workspaceId}/agents/{agentId}
Modify the details of a specific agent, such as their name, bio, status.
Treść żądania
name
string
bio
string
status
string
Possible values: active, away, out-of-office
avatarUrl
string
dropVms
array
Pokaż parametry podrzędne
dropVms.name
string
dropVms.playback
object
wymagane
Pokaż parametry podrzędne
dropVms.playback.media
array of string
wymagane
dropVms.playback.pauseMilliseconds
integer
wrapUpTime
integer
timezone
string
defaultCountryCode
string
defaultCallerId
string
forwardNumber
object
Pokaż parametry podrzędne
forwardNumber.enabled
boolean
forwardNumber.number
string
forwardNumber.maskCaller
boolean
transcriptionLocale
string
Curated set of BCP47 locale identifiers supported by Bird speech-to-text products
Possible values: ar-AE, ar-SA, cmn-CN, cy-GB, da-DK, de-CH, de-DE, el-GR, en-AU, en-GB, en-GB-WLS, en-IE, en-IN, en-NZ, en-US, en-ZA, es-ES, es-MX, es-US, fr-CA, fr-FR, he-IL, hi-IN, id-ID, is-IS, it-IT, ja-JP, ko-KR, ms-MY, nb-NO, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sv-SE, ta-IN, te-IN, th-TH, tr-TR, vi-VN, zh-CN, zh-HK, zh-TW, arb, af-ZA, bn-IN, ca-ES, cmn-TW, cs-CZ, fi-FI, fil-PH, gu-IN, hu-HU, kn-IN, lt-LT, lv-LV, ml-IN, mr-IN, pa-IN, sk-SK, sr-RS, uk-UA, yue-HK, no-NO
weeklySchedule
object
Pokaż parametry podrzędne
weeklySchedule.monday
object
Pokaż parametry podrzędne
weeklySchedule.monday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.monday.from.hour
integer
wymagane
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.monday.to.hour
integer
wymagane
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Pokaż parametry podrzędne
weeklySchedule.tuesday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.tuesday.from.hour
integer
wymagane
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.tuesday.to.hour
integer
wymagane
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Pokaż parametry podrzędne
weeklySchedule.wednesday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.wednesday.from.hour
integer
wymagane
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.wednesday.to.hour
integer
wymagane
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Pokaż parametry podrzędne
weeklySchedule.thursday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.thursday.from.hour
integer
wymagane
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.thursday.to.hour
integer
wymagane
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Pokaż parametry podrzędne
weeklySchedule.friday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.friday.from.hour
integer
wymagane
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.friday.to.hour
integer
wymagane
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Pokaż parametry podrzędne
weeklySchedule.saturday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.saturday.from.hour
integer
wymagane
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.saturday.to.hour
integer
wymagane
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Pokaż parametry podrzędne
weeklySchedule.sunday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.sunday.from.hour
integer
wymagane
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.sunday.to.hour
integer
wymagane
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Pokaż parametry podrzędne
holidays.name
string
wymagane
holidays.day
integer
wymagane
holidays.month
integer
wymagane
assignedSkills
array of object
Pokaż parametry podrzędne
assignedSkills.id
string
wymagane
assignedSkills.name
string
wymagane
assignedSkills.selectedValues
array of object
wymagane
Pokaż parametry podrzędne
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
wymagane
assignedSkills.selectedValues.value
string
wymagane
assignedSkills.valueType
string
wymagane
AgentSkillValueType defines how can the Values of a Skill can be selected.
Possible values: single, multiple, boolean
defaultSenderId
string
The default Sender Profile to select for this agent when composing a new message.
outOfOfficeResponse
string
Treść odpowiedzi
id
string
wymagane
status
string
Possible values: active, away, out-of-office
statusBeforeOffline
string
Possible values: active, away, out-of-office
name
string
overrideName
boolean
workspaceId
string
wymagane
type
string
Possible values: user, ai
userEmails
array of string
bio
string
avatarUrl
string
dropVms
array
Pokaż atrybuty podrzędne
dropVms.name
string
dropVms.playback
object
wymagane
Pokaż atrybuty podrzędne
dropVms.playback.media
array of string
wymagane
dropVms.playback.pauseMilliseconds
integer
tagCount
integer
wrapUpTime
integer
rootItemAssignedCount
integer
lastAssignedAt
string
lastSetToAwayAt
string
teams
array of object
Pokaż atrybuty podrzędne
teams.id
string
The team's ID this agent belongs to.
teams.name
string
The name of the team this agent belongs to.
teams.memberSince
string
The timestamp of when this agent joined the team.
teams.activeMemberCount
integer
The number of active members in the team.
teams.pendingMemberCount
integer
The number of pending members in the team.
workload
object
Pokaż atrybuty podrzędne
workload.id
string
workload.workload
object
Pokaż atrybuty podrzędne
workload.workload.messaging
integer
workload.workload.email
integer
workload.rule
object
Pokaż atrybuty podrzędne
workload.rule.id
string
wymagane
workload.rule.workspaceId
string
wymagane
workload.rule.name
string
wymagane
workload.rule.description
string
wymagane
workload.rule.default
boolean
workload.rule.capacity
object
wymagane
Pokaż atrybuty podrzędne
workload.rule.capacity.messaging
integer
workload.rule.capacity.email
integer
workload.rule.assignedAgentIds
array of string
workload.rule.createdAt
string
workload.rule.updatedAt
string
workload.ruleId
string
workload.updatedAt
string
createdAt
string
wymagane
updatedAt
string
wymagane
availability
object
Pokaż atrybuty podrzędne
availability.status
string
Possible values: active, away, out-of-office
availability.activity
string
Possible values: available, in-call, busy, wrap-up-time, do-not-disturb, offline, not-available, out-of-hours, custom
availability.activityTtl
integer
availability.activityText
string
availability.lastStatusSet
string
availability.lastActivitySet
string
availability.updatedAt
string
timezone
string
defaultCountryCode
string
defaultCallerId
string
forwardNumber
object
Pokaż atrybuty podrzędne
forwardNumber.enabled
boolean
forwardNumber.number
string
forwardNumber.maskCaller
boolean
transcriptionLocale
string
Curated set of BCP47 locale identifiers supported by Bird speech-to-text products
Possible values: ar-AE, ar-SA, cmn-CN, cy-GB, da-DK, de-CH, de-DE, el-GR, en-AU, en-GB, en-GB-WLS, en-IE, en-IN, en-NZ, en-US, en-ZA, es-ES, es-MX, es-US, fr-CA, fr-FR, he-IL, hi-IN, id-ID, is-IS, it-IT, ja-JP, ko-KR, ms-MY, nb-NO, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sv-SE, ta-IN, te-IN, th-TH, tr-TR, vi-VN, zh-CN, zh-HK, zh-TW, arb, af-ZA, bn-IN, ca-ES, cmn-TW, cs-CZ, fi-FI, fil-PH, gu-IN, hu-HU, kn-IN, lt-LT, lv-LV, ml-IN, mr-IN, pa-IN, sk-SK, sr-RS, uk-UA, yue-HK, no-NO
roles
array of object
Pokaż atrybuty podrzędne
roles.id
string
wymagane
roles.type
string
wymagane
Possible values: organization, managed
roles.workspaces
array of string
user
object
Pokaż atrybuty podrzędne
user.id
string
ID of the user
user.name
string
The display name for the user
user.avatarUrl
string
URL to the user's profile picture.
user.defaultEmail
string
The default email of the user in the list of emails.
user.phoneNumber
string
weeklySchedule
object
Pokaż atrybuty podrzędne
weeklySchedule.monday
object
Pokaż atrybuty podrzędne
weeklySchedule.monday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.monday.from.hour
integer
wymagane
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.monday.to.hour
integer
wymagane
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.from.hour
integer
wymagane
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.to.hour
integer
wymagane
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.from.hour
integer
wymagane
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.to.hour
integer
wymagane
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Pokaż atrybuty podrzędne
weeklySchedule.thursday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.thursday.from.hour
integer
wymagane
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.thursday.to.hour
integer
wymagane
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Pokaż atrybuty podrzędne
weeklySchedule.friday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.friday.from.hour
integer
wymagane
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.friday.to.hour
integer
wymagane
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Pokaż atrybuty podrzędne
weeklySchedule.saturday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.saturday.from.hour
integer
wymagane
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.saturday.to.hour
integer
wymagane
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Pokaż atrybuty podrzędne
weeklySchedule.sunday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.sunday.from.hour
integer
wymagane
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.sunday.to.hour
integer
wymagane
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Pokaż atrybuty podrzędne
holidays.name
string
wymagane
holidays.day
integer
wymagane
holidays.month
integer
wymagane
assignedSkills
array of object
Pokaż atrybuty podrzędne
assignedSkills.id
string
wymagane
assignedSkills.name
string
wymagane
assignedSkills.selectedValues
array of object
wymagane
Pokaż atrybuty podrzędne
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
wymagane
assignedSkills.selectedValues.value
string
wymagane
assignedSkills.valueType
string
wymagane
AgentSkillValueType defines how can the Values of a Skill can be selected.
Possible values: single, multiple, boolean
defaultSenderId
string
The default Sender Profile to select for this agent when composing a new message.
outOfOfficeResponse
string
Przykład kodu
curl -X PATCH 'https://api.bird.com/workspaces/{workspaceId}/agents/{agentId}' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
DELETE
/workspaces/{workspaceId}/agents/{agentId}
Remove a specific agent from the system, permanently deleting their profile and associated data.
Przykład kodu
curl -X DELETE 'https://api.bird.com/workspaces/{workspaceId}/agents/{agentId}' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
GET
/workspaces/{workspaceId}/agents/me
Retrieve information about a specific agent, including their name, bio, status.
Treść odpowiedzi
id
string
wymagane
status
string
Possible values: active, away, out-of-office
statusBeforeOffline
string
Possible values: active, away, out-of-office
name
string
overrideName
boolean
workspaceId
string
wymagane
type
string
Possible values: user, ai
userEmails
array of string
bio
string
avatarUrl
string
dropVms
array
Pokaż atrybuty podrzędne
dropVms.name
string
dropVms.playback
object
wymagane
Pokaż atrybuty podrzędne
dropVms.playback.media
array of string
wymagane
dropVms.playback.pauseMilliseconds
integer
tagCount
integer
wrapUpTime
integer
rootItemAssignedCount
integer
lastAssignedAt
string
lastSetToAwayAt
string
teams
array of object
Pokaż atrybuty podrzędne
teams.id
string
The team's ID this agent belongs to.
teams.name
string
The name of the team this agent belongs to.
teams.memberSince
string
The timestamp of when this agent joined the team.
teams.activeMemberCount
integer
The number of active members in the team.
teams.pendingMemberCount
integer
The number of pending members in the team.
workload
object
Pokaż atrybuty podrzędne
workload.id
string
workload.workload
object
Pokaż atrybuty podrzędne
workload.workload.messaging
integer
workload.workload.email
integer
workload.rule
object
Pokaż atrybuty podrzędne
workload.rule.id
string
wymagane
workload.rule.workspaceId
string
wymagane
workload.rule.name
string
wymagane
workload.rule.description
string
wymagane
workload.rule.default
boolean
workload.rule.capacity
object
wymagane
Pokaż atrybuty podrzędne
workload.rule.capacity.messaging
integer
workload.rule.capacity.email
integer
workload.rule.assignedAgentIds
array of string
workload.rule.createdAt
string
workload.rule.updatedAt
string
workload.ruleId
string
workload.updatedAt
string
createdAt
string
wymagane
updatedAt
string
wymagane
availability
object
Pokaż atrybuty podrzędne
availability.status
string
Possible values: active, away, out-of-office
availability.activity
string
Possible values: available, in-call, busy, wrap-up-time, do-not-disturb, offline, not-available, out-of-hours, custom
availability.activityTtl
integer
availability.activityText
string
availability.lastStatusSet
string
availability.lastActivitySet
string
availability.updatedAt
string
timezone
string
defaultCountryCode
string
defaultCallerId
string
forwardNumber
object
Pokaż atrybuty podrzędne
forwardNumber.enabled
boolean
forwardNumber.number
string
forwardNumber.maskCaller
boolean
transcriptionLocale
string
Curated set of BCP47 locale identifiers supported by Bird speech-to-text products
Possible values: ar-AE, ar-SA, cmn-CN, cy-GB, da-DK, de-CH, de-DE, el-GR, en-AU, en-GB, en-GB-WLS, en-IE, en-IN, en-NZ, en-US, en-ZA, es-ES, es-MX, es-US, fr-CA, fr-FR, he-IL, hi-IN, id-ID, is-IS, it-IT, ja-JP, ko-KR, ms-MY, nb-NO, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sv-SE, ta-IN, te-IN, th-TH, tr-TR, vi-VN, zh-CN, zh-HK, zh-TW, arb, af-ZA, bn-IN, ca-ES, cmn-TW, cs-CZ, fi-FI, fil-PH, gu-IN, hu-HU, kn-IN, lt-LT, lv-LV, ml-IN, mr-IN, pa-IN, sk-SK, sr-RS, uk-UA, yue-HK, no-NO
roles
array of object
Pokaż atrybuty podrzędne
roles.id
string
wymagane
roles.type
string
wymagane
Possible values: organization, managed
roles.workspaces
array of string
user
object
Pokaż atrybuty podrzędne
user.id
string
ID of the user
user.name
string
The display name for the user
user.avatarUrl
string
URL to the user's profile picture.
user.defaultEmail
string
The default email of the user in the list of emails.
user.phoneNumber
string
weeklySchedule
object
Pokaż atrybuty podrzędne
weeklySchedule.monday
object
Pokaż atrybuty podrzędne
weeklySchedule.monday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.monday.from.hour
integer
wymagane
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.monday.to.hour
integer
wymagane
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.from.hour
integer
wymagane
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.to.hour
integer
wymagane
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.from.hour
integer
wymagane
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.to.hour
integer
wymagane
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Pokaż atrybuty podrzędne
weeklySchedule.thursday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.thursday.from.hour
integer
wymagane
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.thursday.to.hour
integer
wymagane
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Pokaż atrybuty podrzędne
weeklySchedule.friday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.friday.from.hour
integer
wymagane
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.friday.to.hour
integer
wymagane
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Pokaż atrybuty podrzędne
weeklySchedule.saturday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.saturday.from.hour
integer
wymagane
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.saturday.to.hour
integer
wymagane
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Pokaż atrybuty podrzędne
weeklySchedule.sunday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.sunday.from.hour
integer
wymagane
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.sunday.to.hour
integer
wymagane
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Pokaż atrybuty podrzędne
holidays.name
string
wymagane
holidays.day
integer
wymagane
holidays.month
integer
wymagane
assignedSkills
array of object
Pokaż atrybuty podrzędne
assignedSkills.id
string
wymagane
assignedSkills.name
string
wymagane
assignedSkills.selectedValues
array of object
wymagane
Pokaż atrybuty podrzędne
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
wymagane
assignedSkills.selectedValues.value
string
wymagane
assignedSkills.valueType
string
wymagane
AgentSkillValueType defines how can the Values of a Skill can be selected.
Possible values: single, multiple, boolean
defaultSenderId
string
The default Sender Profile to select for this agent when composing a new message.
outOfOfficeResponse
string
Przykład kodu
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/agents/me' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
PATCH
/workspaces/{workspaceId}/agents/me
Modify the details of a specific agent, such as their name, bio, status.
Treść żądania
name
string
bio
string
status
string
Possible values: active, away, out-of-office
avatarUrl
string
dropVms
array
Pokaż parametry podrzędne
dropVms.name
string
dropVms.playback
object
wymagane
Pokaż parametry podrzędne
dropVms.playback.media
array of string
wymagane
dropVms.playback.pauseMilliseconds
integer
wrapUpTime
integer
timezone
string
defaultCountryCode
string
defaultCallerId
string
forwardNumber
object
Pokaż parametry podrzędne
forwardNumber.enabled
boolean
forwardNumber.number
string
forwardNumber.maskCaller
boolean
transcriptionLocale
string
Curated set of BCP47 locale identifiers supported by Bird speech-to-text products
Possible values: ar-AE, ar-SA, cmn-CN, cy-GB, da-DK, de-CH, de-DE, el-GR, en-AU, en-GB, en-GB-WLS, en-IE, en-IN, en-NZ, en-US, en-ZA, es-ES, es-MX, es-US, fr-CA, fr-FR, he-IL, hi-IN, id-ID, is-IS, it-IT, ja-JP, ko-KR, ms-MY, nb-NO, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sv-SE, ta-IN, te-IN, th-TH, tr-TR, vi-VN, zh-CN, zh-HK, zh-TW, arb, af-ZA, bn-IN, ca-ES, cmn-TW, cs-CZ, fi-FI, fil-PH, gu-IN, hu-HU, kn-IN, lt-LT, lv-LV, ml-IN, mr-IN, pa-IN, sk-SK, sr-RS, uk-UA, yue-HK, no-NO
weeklySchedule
object
Pokaż parametry podrzędne
weeklySchedule.monday
object
Pokaż parametry podrzędne
weeklySchedule.monday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.monday.from.hour
integer
wymagane
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.monday.to.hour
integer
wymagane
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Pokaż parametry podrzędne
weeklySchedule.tuesday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.tuesday.from.hour
integer
wymagane
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.tuesday.to.hour
integer
wymagane
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Pokaż parametry podrzędne
weeklySchedule.wednesday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.wednesday.from.hour
integer
wymagane
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.wednesday.to.hour
integer
wymagane
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Pokaż parametry podrzędne
weeklySchedule.thursday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.thursday.from.hour
integer
wymagane
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.thursday.to.hour
integer
wymagane
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Pokaż parametry podrzędne
weeklySchedule.friday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.friday.from.hour
integer
wymagane
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.friday.to.hour
integer
wymagane
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Pokaż parametry podrzędne
weeklySchedule.saturday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.saturday.from.hour
integer
wymagane
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.saturday.to.hour
integer
wymagane
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Pokaż parametry podrzędne
weeklySchedule.sunday.from
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.sunday.from.hour
integer
wymagane
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
wymagane
Pokaż parametry podrzędne
weeklySchedule.sunday.to.hour
integer
wymagane
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Pokaż parametry podrzędne
holidays.name
string
wymagane
holidays.day
integer
wymagane
holidays.month
integer
wymagane
assignedSkills
array of object
Pokaż parametry podrzędne
assignedSkills.id
string
wymagane
assignedSkills.name
string
wymagane
assignedSkills.selectedValues
array of object
wymagane
Pokaż parametry podrzędne
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
wymagane
assignedSkills.selectedValues.value
string
wymagane
assignedSkills.valueType
string
wymagane
AgentSkillValueType defines how can the Values of a Skill can be selected.
Possible values: single, multiple, boolean
defaultSenderId
string
The default Sender Profile to select for this agent when composing a new message.
outOfOfficeResponse
string
Treść odpowiedzi
id
string
wymagane
status
string
Possible values: active, away, out-of-office
statusBeforeOffline
string
Possible values: active, away, out-of-office
name
string
overrideName
boolean
workspaceId
string
wymagane
type
string
Possible values: user, ai
userEmails
array of string
bio
string
avatarUrl
string
dropVms
array
Pokaż atrybuty podrzędne
dropVms.name
string
dropVms.playback
object
wymagane
Pokaż atrybuty podrzędne
dropVms.playback.media
array of string
wymagane
dropVms.playback.pauseMilliseconds
integer
tagCount
integer
wrapUpTime
integer
rootItemAssignedCount
integer
lastAssignedAt
string
lastSetToAwayAt
string
teams
array of object
Pokaż atrybuty podrzędne
teams.id
string
The team's ID this agent belongs to.
teams.name
string
The name of the team this agent belongs to.
teams.memberSince
string
The timestamp of when this agent joined the team.
teams.activeMemberCount
integer
The number of active members in the team.
teams.pendingMemberCount
integer
The number of pending members in the team.
workload
object
Pokaż atrybuty podrzędne
workload.id
string
workload.workload
object
Pokaż atrybuty podrzędne
workload.workload.messaging
integer
workload.workload.email
integer
workload.rule
object
Pokaż atrybuty podrzędne
workload.rule.id
string
wymagane
workload.rule.workspaceId
string
wymagane
workload.rule.name
string
wymagane
workload.rule.description
string
wymagane
workload.rule.default
boolean
workload.rule.capacity
object
wymagane
Pokaż atrybuty podrzędne
workload.rule.capacity.messaging
integer
workload.rule.capacity.email
integer
workload.rule.assignedAgentIds
array of string
workload.rule.createdAt
string
workload.rule.updatedAt
string
workload.ruleId
string
workload.updatedAt
string
createdAt
string
wymagane
updatedAt
string
wymagane
availability
object
Pokaż atrybuty podrzędne
availability.status
string
Possible values: active, away, out-of-office
availability.activity
string
Possible values: available, in-call, busy, wrap-up-time, do-not-disturb, offline, not-available, out-of-hours, custom
availability.activityTtl
integer
availability.activityText
string
availability.lastStatusSet
string
availability.lastActivitySet
string
availability.updatedAt
string
timezone
string
defaultCountryCode
string
defaultCallerId
string
forwardNumber
object
Pokaż atrybuty podrzędne
forwardNumber.enabled
boolean
forwardNumber.number
string
forwardNumber.maskCaller
boolean
transcriptionLocale
string
Curated set of BCP47 locale identifiers supported by Bird speech-to-text products
Possible values: ar-AE, ar-SA, cmn-CN, cy-GB, da-DK, de-CH, de-DE, el-GR, en-AU, en-GB, en-GB-WLS, en-IE, en-IN, en-NZ, en-US, en-ZA, es-ES, es-MX, es-US, fr-CA, fr-FR, he-IL, hi-IN, id-ID, is-IS, it-IT, ja-JP, ko-KR, ms-MY, nb-NO, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sv-SE, ta-IN, te-IN, th-TH, tr-TR, vi-VN, zh-CN, zh-HK, zh-TW, arb, af-ZA, bn-IN, ca-ES, cmn-TW, cs-CZ, fi-FI, fil-PH, gu-IN, hu-HU, kn-IN, lt-LT, lv-LV, ml-IN, mr-IN, pa-IN, sk-SK, sr-RS, uk-UA, yue-HK, no-NO
roles
array of object
Pokaż atrybuty podrzędne
roles.id
string
wymagane
roles.type
string
wymagane
Possible values: organization, managed
roles.workspaces
array of string
user
object
Pokaż atrybuty podrzędne
user.id
string
ID of the user
user.name
string
The display name for the user
user.avatarUrl
string
URL to the user's profile picture.
user.defaultEmail
string
The default email of the user in the list of emails.
user.phoneNumber
string
weeklySchedule
object
Pokaż atrybuty podrzędne
weeklySchedule.monday
object
Pokaż atrybuty podrzędne
weeklySchedule.monday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.monday.from.hour
integer
wymagane
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.monday.to.hour
integer
wymagane
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.from.hour
integer
wymagane
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.tuesday.to.hour
integer
wymagane
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.from.hour
integer
wymagane
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.wednesday.to.hour
integer
wymagane
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Pokaż atrybuty podrzędne
weeklySchedule.thursday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.thursday.from.hour
integer
wymagane
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.thursday.to.hour
integer
wymagane
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Pokaż atrybuty podrzędne
weeklySchedule.friday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.friday.from.hour
integer
wymagane
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.friday.to.hour
integer
wymagane
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Pokaż atrybuty podrzędne
weeklySchedule.saturday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.saturday.from.hour
integer
wymagane
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.saturday.to.hour
integer
wymagane
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Pokaż atrybuty podrzędne
weeklySchedule.sunday.from
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.sunday.from.hour
integer
wymagane
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
wymagane
Pokaż atrybuty podrzędne
weeklySchedule.sunday.to.hour
integer
wymagane
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Pokaż atrybuty podrzędne
holidays.name
string
wymagane
holidays.day
integer
wymagane
holidays.month
integer
wymagane
assignedSkills
array of object
Pokaż atrybuty podrzędne
assignedSkills.id
string
wymagane
assignedSkills.name
string
wymagane
assignedSkills.selectedValues
array of object
wymagane
Pokaż atrybuty podrzędne
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
wymagane
assignedSkills.selectedValues.value
string
wymagane
assignedSkills.valueType
string
wymagane
AgentSkillValueType defines how can the Values of a Skill can be selected.
Possible values: single, multiple, boolean
defaultSenderId
string
The default Sender Profile to select for this agent when composing a new message.
outOfOfficeResponse
string
Przykład kodu
curl -X PATCH 'https://api.bird.com/workspaces/{workspaceId}/agents/me' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
GET
/workspaces/{workspaceId}/agents/{agentId}/availability
Retrieve information about availability of a specific agent.
Treść odpowiedzi
status
string
Possible values: active, away, out-of-office
activity
string
Possible values: available, in-call, busy, wrap-up-time, do-not-disturb, offline, not-available, out-of-hours, custom
activityTtl
integer
activityText
string
lastStatusSet
string
lastActivitySet
string
updatedAt
string
Przykład kodu
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/agents/{agentId}/availability' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
PATCH
/workspaces/{workspaceId}/agents/{agentId}/availability
Modify the availability of a specific agent.
Treść żądania
status
string
wymagane
Possible values: active, away, out-of-office
activity
string
Possible values: available, in-call, busy, wrap-up-time, do-not-disturb, offline, not-available, out-of-hours, custom
activityTtl
integer
activityText
string
Treść odpowiedzi
status
string
Possible values: active, away, out-of-office
activity
string
Possible values: available, in-call, busy, wrap-up-time, do-not-disturb, offline, not-available, out-of-hours, custom
activityTtl
integer
activityText
string
lastStatusSet
string
lastActivitySet
string
updatedAt
string
Przykład kodu
curl -X PATCH 'https://api.bird.com/workspaces/{workspaceId}/agents/{agentId}/availability' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
GET
/workspaces/{workspaceId}/agents/{agentId}/workload
Retrieve information about workload of a specific agent.
Treść odpowiedzi
id
string
workload
object
Pokaż atrybuty podrzędne
workload.messaging
integer
workload.email
integer
rule
object
Pokaż atrybuty podrzędne
rule.id
string
wymagane
rule.workspaceId
string
wymagane
rule.name
string
wymagane
rule.description
string
wymagane
rule.default
boolean
rule.capacity
object
wymagane
Pokaż atrybuty podrzędne
rule.capacity.messaging
integer
rule.capacity.email
integer
rule.assignedAgentIds
array of string
rule.createdAt
string
rule.updatedAt
string
ruleId
string
updatedAt
string
Przykład kodu
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/agents/{agentId}/workload' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'