Agent Management
GET
/workspaces/{workspaceId}/agents
List Agents
Abfrageparameter
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.
Antwort-Payload
results
array of object
erforderlich
Untergeordnete Attribute anzeigen
results.id
string
erforderlich
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
erforderlich
results.type
string
Possible values: user, ai
results.userEmails
array of string
results.bio
string
results.avatarUrl
string
results.dropVms
array
Untergeordnete Attribute anzeigen
results.dropVms.name
string
results.dropVms.playback
object
erforderlich
Untergeordnete Attribute anzeigen
results.dropVms.playback.media
array of string
erforderlich
results.dropVms.playback.pauseMilliseconds
integer
results.dropVms.name
string
results.dropVms.say
object
erforderlich
Untergeordnete Attribute anzeigen
results.dropVms.say.text
string
results.dropVms.say.voice
string
results.dropVms.say.locale
string
Possible values: arb, ar-AE, ca-ES, yue-CN, cmn-CN, da-DK, nl-BE, nl-NL, en-AU, en-GB, en-IN, en-NZ, en-ZA, en-US, en-GB-WLS, fi-FI, fr-FR, fr-CA, hi-IN, de-DE, de-AT, is-IS, it-IT, ja-JP, ko-KR, nb-NO, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, es-ES, es-MX, es-US, sv-SE, tr-TR, cy-GB
results.tagCount
integer
results.wrapUpTime
integer
results.rootItemAssignedCount
integer
results.lastAssignedAt
string
results.lastSetToAwayAt
string
results.teams
array of object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
results.workload.id
string
results.workload.workload
object
Untergeordnete Attribute anzeigen
results.workload.workload.messaging
integer
results.workload.workload.email
integer
results.workload.rule
object
Untergeordnete Attribute anzeigen
results.workload.rule.id
string
erforderlich
results.workload.rule.workspaceId
string
erforderlich
results.workload.rule.name
string
erforderlich
results.workload.rule.description
string
erforderlich
results.workload.rule.default
boolean
results.workload.rule.capacity
object
erforderlich
Untergeordnete Attribute anzeigen
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
erforderlich
results.updatedAt
string
erforderlich
results.availability
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
results.roles.id
string
erforderlich
results.roles.type
string
erforderlich
Possible values: organization, managed
results.roles.workspaces
array of string
results.user
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
results.weeklySchedule.monday
object
Untergeordnete Attribute anzeigen
results.weeklySchedule.monday.from
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.monday.from.hour
integer
erforderlich
results.weeklySchedule.monday.from.minute
integer
results.weeklySchedule.monday.to
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.monday.to.hour
integer
erforderlich
results.weeklySchedule.monday.to.minute
integer
results.weeklySchedule.tuesday
object
Untergeordnete Attribute anzeigen
results.weeklySchedule.tuesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.tuesday.from.hour
integer
erforderlich
results.weeklySchedule.tuesday.from.minute
integer
results.weeklySchedule.tuesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.tuesday.to.hour
integer
erforderlich
results.weeklySchedule.tuesday.to.minute
integer
results.weeklySchedule.wednesday
object
Untergeordnete Attribute anzeigen
results.weeklySchedule.wednesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.wednesday.from.hour
integer
erforderlich
results.weeklySchedule.wednesday.from.minute
integer
results.weeklySchedule.wednesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.wednesday.to.hour
integer
erforderlich
results.weeklySchedule.wednesday.to.minute
integer
results.weeklySchedule.thursday
object
Untergeordnete Attribute anzeigen
results.weeklySchedule.thursday.from
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.thursday.from.hour
integer
erforderlich
results.weeklySchedule.thursday.from.minute
integer
results.weeklySchedule.thursday.to
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.thursday.to.hour
integer
erforderlich
results.weeklySchedule.thursday.to.minute
integer
results.weeklySchedule.friday
object
Untergeordnete Attribute anzeigen
results.weeklySchedule.friday.from
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.friday.from.hour
integer
erforderlich
results.weeklySchedule.friday.from.minute
integer
results.weeklySchedule.friday.to
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.friday.to.hour
integer
erforderlich
results.weeklySchedule.friday.to.minute
integer
results.weeklySchedule.saturday
object
Untergeordnete Attribute anzeigen
results.weeklySchedule.saturday.from
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.saturday.from.hour
integer
erforderlich
results.weeklySchedule.saturday.from.minute
integer
results.weeklySchedule.saturday.to
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.saturday.to.hour
integer
erforderlich
results.weeklySchedule.saturday.to.minute
integer
results.weeklySchedule.sunday
object
Untergeordnete Attribute anzeigen
results.weeklySchedule.sunday.from
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.sunday.from.hour
integer
erforderlich
results.weeklySchedule.sunday.from.minute
integer
results.weeklySchedule.sunday.to
object
erforderlich
Untergeordnete Attribute anzeigen
results.weeklySchedule.sunday.to.hour
integer
erforderlich
results.weeklySchedule.sunday.to.minute
integer
results.holidays
array of object
Untergeordnete Attribute anzeigen
results.holidays.name
string
erforderlich
results.holidays.day
integer
erforderlich
results.holidays.month
integer
erforderlich
results.assignedSkills
array of object
Untergeordnete Attribute anzeigen
results.assignedSkills.id
string
erforderlich
results.assignedSkills.name
string
erforderlich
results.assignedSkills.selectedValues
array of object
erforderlich
Untergeordnete Attribute anzeigen
results.assignedSkills.selectedValues.icon
string
results.assignedSkills.selectedValues.id
string
erforderlich
results.assignedSkills.selectedValues.value
string
erforderlich
results.assignedSkills.valueType
string
erforderlich
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.
Codebeispiel
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.
Anfrage-Payload
bio
string
type
string
erforderlich
Possible values: user
userId
string
erforderlich
teamId
string
teamIds
array of string
timezone
string
defaultCountryCode
string
weeklySchedule
object
Untergeordnete Parameter anzeigen
weeklySchedule.monday
object
Untergeordnete Parameter anzeigen
weeklySchedule.monday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.monday.from.hour
integer
erforderlich
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.monday.to.hour
integer
erforderlich
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.from.hour
integer
erforderlich
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.to.hour
integer
erforderlich
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.from.hour
integer
erforderlich
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.to.hour
integer
erforderlich
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.from.hour
integer
erforderlich
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.to.hour
integer
erforderlich
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Untergeordnete Parameter anzeigen
weeklySchedule.friday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.friday.from.hour
integer
erforderlich
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.friday.to.hour
integer
erforderlich
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.from.hour
integer
erforderlich
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.to.hour
integer
erforderlich
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.from.hour
integer
erforderlich
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.to.hour
integer
erforderlich
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Untergeordnete Parameter anzeigen
holidays.name
string
erforderlich
holidays.day
integer
erforderlich
holidays.month
integer
erforderlich
name
string
erforderlich
email
string
erforderlich
teamId
string
teamIds
array of string
weeklySchedule
object
Untergeordnete Parameter anzeigen
weeklySchedule.monday
object
Untergeordnete Parameter anzeigen
weeklySchedule.monday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.monday.from.hour
integer
erforderlich
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.monday.to.hour
integer
erforderlich
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.from.hour
integer
erforderlich
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.to.hour
integer
erforderlich
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.from.hour
integer
erforderlich
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.to.hour
integer
erforderlich
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.from.hour
integer
erforderlich
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.to.hour
integer
erforderlich
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Untergeordnete Parameter anzeigen
weeklySchedule.friday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.friday.from.hour
integer
erforderlich
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.friday.to.hour
integer
erforderlich
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.from.hour
integer
erforderlich
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.to.hour
integer
erforderlich
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.from.hour
integer
erforderlich
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.to.hour
integer
erforderlich
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Untergeordnete Parameter anzeigen
holidays.name
string
erforderlich
holidays.day
integer
erforderlich
holidays.month
integer
erforderlich
type
string
erforderlich
Possible values: ai
botId
string
erforderlich
teamIds
array of string
Antwort-Payload
id
string
erforderlich
status
string
Possible values: active, away, out-of-office
statusBeforeOffline
string
Possible values: active, away, out-of-office
name
string
overrideName
boolean
workspaceId
string
erforderlich
type
string
Possible values: user, ai
userEmails
array of string
bio
string
avatarUrl
string
dropVms
array
Untergeordnete Attribute anzeigen
dropVms.name
string
dropVms.playback
object
erforderlich
Untergeordnete Attribute anzeigen
dropVms.playback.media
array of string
erforderlich
dropVms.playback.pauseMilliseconds
integer
dropVms.name
string
dropVms.say
object
erforderlich
Untergeordnete Attribute anzeigen
dropVms.say.text
string
dropVms.say.voice
string
dropVms.say.locale
string
Possible values: arb, ar-AE, ca-ES, yue-CN, cmn-CN, da-DK, nl-BE, nl-NL, en-AU, en-GB, en-IN, en-NZ, en-ZA, en-US, en-GB-WLS, fi-FI, fr-FR, fr-CA, hi-IN, de-DE, de-AT, is-IS, it-IT, ja-JP, ko-KR, nb-NO, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, es-ES, es-MX, es-US, sv-SE, tr-TR, cy-GB
tagCount
integer
wrapUpTime
integer
rootItemAssignedCount
integer
lastAssignedAt
string
lastSetToAwayAt
string
teams
array of object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
workload.id
string
workload.workload
object
Untergeordnete Attribute anzeigen
workload.workload.messaging
integer
workload.workload.email
integer
workload.rule
object
Untergeordnete Attribute anzeigen
workload.rule.id
string
erforderlich
workload.rule.workspaceId
string
erforderlich
workload.rule.name
string
erforderlich
workload.rule.description
string
erforderlich
workload.rule.default
boolean
workload.rule.capacity
object
erforderlich
Untergeordnete Attribute anzeigen
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
erforderlich
updatedAt
string
erforderlich
availability
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
roles.id
string
erforderlich
roles.type
string
erforderlich
Possible values: organization, managed
roles.workspaces
array of string
user
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
weeklySchedule.monday
object
Untergeordnete Attribute anzeigen
weeklySchedule.monday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.monday.from.hour
integer
erforderlich
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.monday.to.hour
integer
erforderlich
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.from.hour
integer
erforderlich
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.to.hour
integer
erforderlich
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.from.hour
integer
erforderlich
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.to.hour
integer
erforderlich
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.from.hour
integer
erforderlich
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.to.hour
integer
erforderlich
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Untergeordnete Attribute anzeigen
weeklySchedule.friday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.friday.from.hour
integer
erforderlich
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.friday.to.hour
integer
erforderlich
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.from.hour
integer
erforderlich
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.to.hour
integer
erforderlich
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.from.hour
integer
erforderlich
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.to.hour
integer
erforderlich
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Untergeordnete Attribute anzeigen
holidays.name
string
erforderlich
holidays.day
integer
erforderlich
holidays.month
integer
erforderlich
assignedSkills
array of object
Untergeordnete Attribute anzeigen
assignedSkills.id
string
erforderlich
assignedSkills.name
string
erforderlich
assignedSkills.selectedValues
array of object
erforderlich
Untergeordnete Attribute anzeigen
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
erforderlich
assignedSkills.selectedValues.value
string
erforderlich
assignedSkills.valueType
string
erforderlich
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
Codebeispiel
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.
Antwort-Payload
results
array of object
erforderlich
Untergeordnete Attribute anzeigen
results.id
string
erforderlich
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
erforderlich
Codebeispiel
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.
Antwort-Payload
id
string
erforderlich
status
string
Possible values: active, away, out-of-office
statusBeforeOffline
string
Possible values: active, away, out-of-office
name
string
overrideName
boolean
workspaceId
string
erforderlich
type
string
Possible values: user, ai
userEmails
array of string
bio
string
avatarUrl
string
dropVms
array
Untergeordnete Attribute anzeigen
dropVms.name
string
dropVms.playback
object
erforderlich
Untergeordnete Attribute anzeigen
dropVms.playback.media
array of string
erforderlich
dropVms.playback.pauseMilliseconds
integer
dropVms.name
string
dropVms.say
object
erforderlich
Untergeordnete Attribute anzeigen
dropVms.say.text
string
dropVms.say.voice
string
dropVms.say.locale
string
Possible values: arb, ar-AE, ca-ES, yue-CN, cmn-CN, da-DK, nl-BE, nl-NL, en-AU, en-GB, en-IN, en-NZ, en-ZA, en-US, en-GB-WLS, fi-FI, fr-FR, fr-CA, hi-IN, de-DE, de-AT, is-IS, it-IT, ja-JP, ko-KR, nb-NO, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, es-ES, es-MX, es-US, sv-SE, tr-TR, cy-GB
tagCount
integer
wrapUpTime
integer
rootItemAssignedCount
integer
lastAssignedAt
string
lastSetToAwayAt
string
teams
array of object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
workload.id
string
workload.workload
object
Untergeordnete Attribute anzeigen
workload.workload.messaging
integer
workload.workload.email
integer
workload.rule
object
Untergeordnete Attribute anzeigen
workload.rule.id
string
erforderlich
workload.rule.workspaceId
string
erforderlich
workload.rule.name
string
erforderlich
workload.rule.description
string
erforderlich
workload.rule.default
boolean
workload.rule.capacity
object
erforderlich
Untergeordnete Attribute anzeigen
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
erforderlich
updatedAt
string
erforderlich
availability
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
roles.id
string
erforderlich
roles.type
string
erforderlich
Possible values: organization, managed
roles.workspaces
array of string
user
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
weeklySchedule.monday
object
Untergeordnete Attribute anzeigen
weeklySchedule.monday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.monday.from.hour
integer
erforderlich
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.monday.to.hour
integer
erforderlich
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.from.hour
integer
erforderlich
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.to.hour
integer
erforderlich
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.from.hour
integer
erforderlich
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.to.hour
integer
erforderlich
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.from.hour
integer
erforderlich
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.to.hour
integer
erforderlich
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Untergeordnete Attribute anzeigen
weeklySchedule.friday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.friday.from.hour
integer
erforderlich
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.friday.to.hour
integer
erforderlich
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.from.hour
integer
erforderlich
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.to.hour
integer
erforderlich
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.from.hour
integer
erforderlich
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.to.hour
integer
erforderlich
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Untergeordnete Attribute anzeigen
holidays.name
string
erforderlich
holidays.day
integer
erforderlich
holidays.month
integer
erforderlich
assignedSkills
array of object
Untergeordnete Attribute anzeigen
assignedSkills.id
string
erforderlich
assignedSkills.name
string
erforderlich
assignedSkills.selectedValues
array of object
erforderlich
Untergeordnete Attribute anzeigen
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
erforderlich
assignedSkills.selectedValues.value
string
erforderlich
assignedSkills.valueType
string
erforderlich
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
Codebeispiel
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.
Antwort-Payload
mediaUrl
string
URL to download the media from
fileId
string
File ID
url
string
erforderlich
URL to post the image to
formData
object
erforderlich
expectedFields
array of string
Codebeispiel
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.
Antwort-Payload
mediaUrl
string
URL to download the media from
fileId
string
File ID
url
string
erforderlich
URL to post the image to
formData
object
erforderlich
expectedFields
array of string
Codebeispiel
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
Codebeispiel
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.
Anfrage-Payload
name
string
bio
string
status
string
Possible values: active, away, out-of-office
avatarUrl
string
dropVms
array
Untergeordnete Parameter anzeigen
dropVms.name
string
dropVms.playback
object
erforderlich
Untergeordnete Parameter anzeigen
dropVms.playback.media
array of string
erforderlich
dropVms.playback.pauseMilliseconds
integer
dropVms.name
string
dropVms.say
object
erforderlich
Untergeordnete Parameter anzeigen
dropVms.say.text
string
dropVms.say.voice
string
dropVms.say.locale
string
Possible values: arb, ar-AE, ca-ES, yue-CN, cmn-CN, da-DK, nl-BE, nl-NL, en-AU, en-GB, en-IN, en-NZ, en-ZA, en-US, en-GB-WLS, fi-FI, fr-FR, fr-CA, hi-IN, de-DE, de-AT, is-IS, it-IT, ja-JP, ko-KR, nb-NO, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, es-ES, es-MX, es-US, sv-SE, tr-TR, cy-GB
wrapUpTime
integer
timezone
string
defaultCountryCode
string
defaultCallerId
string
forwardNumber
object
Untergeordnete Parameter anzeigen
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
Untergeordnete Parameter anzeigen
weeklySchedule.monday
object
Untergeordnete Parameter anzeigen
weeklySchedule.monday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.monday.from.hour
integer
erforderlich
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.monday.to.hour
integer
erforderlich
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.from.hour
integer
erforderlich
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.to.hour
integer
erforderlich
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.from.hour
integer
erforderlich
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.to.hour
integer
erforderlich
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.from.hour
integer
erforderlich
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.to.hour
integer
erforderlich
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Untergeordnete Parameter anzeigen
weeklySchedule.friday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.friday.from.hour
integer
erforderlich
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.friday.to.hour
integer
erforderlich
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.from.hour
integer
erforderlich
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.to.hour
integer
erforderlich
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.from.hour
integer
erforderlich
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.to.hour
integer
erforderlich
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Untergeordnete Parameter anzeigen
holidays.name
string
erforderlich
holidays.day
integer
erforderlich
holidays.month
integer
erforderlich
assignedSkills
array of object
Untergeordnete Parameter anzeigen
assignedSkills.id
string
erforderlich
assignedSkills.name
string
erforderlich
assignedSkills.selectedValues
array of object
erforderlich
Untergeordnete Parameter anzeigen
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
erforderlich
assignedSkills.selectedValues.value
string
erforderlich
assignedSkills.valueType
string
erforderlich
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
Antwort-Payload
id
string
erforderlich
status
string
Possible values: active, away, out-of-office
statusBeforeOffline
string
Possible values: active, away, out-of-office
name
string
overrideName
boolean
workspaceId
string
erforderlich
type
string
Possible values: user, ai
userEmails
array of string
bio
string
avatarUrl
string
dropVms
array
Untergeordnete Attribute anzeigen
dropVms.name
string
dropVms.playback
object
erforderlich
Untergeordnete Attribute anzeigen
dropVms.playback.media
array of string
erforderlich
dropVms.playback.pauseMilliseconds
integer
dropVms.name
string
dropVms.say
object
erforderlich
Untergeordnete Attribute anzeigen
dropVms.say.text
string
dropVms.say.voice
string
dropVms.say.locale
string
Possible values: arb, ar-AE, ca-ES, yue-CN, cmn-CN, da-DK, nl-BE, nl-NL, en-AU, en-GB, en-IN, en-NZ, en-ZA, en-US, en-GB-WLS, fi-FI, fr-FR, fr-CA, hi-IN, de-DE, de-AT, is-IS, it-IT, ja-JP, ko-KR, nb-NO, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, es-ES, es-MX, es-US, sv-SE, tr-TR, cy-GB
tagCount
integer
wrapUpTime
integer
rootItemAssignedCount
integer
lastAssignedAt
string
lastSetToAwayAt
string
teams
array of object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
workload.id
string
workload.workload
object
Untergeordnete Attribute anzeigen
workload.workload.messaging
integer
workload.workload.email
integer
workload.rule
object
Untergeordnete Attribute anzeigen
workload.rule.id
string
erforderlich
workload.rule.workspaceId
string
erforderlich
workload.rule.name
string
erforderlich
workload.rule.description
string
erforderlich
workload.rule.default
boolean
workload.rule.capacity
object
erforderlich
Untergeordnete Attribute anzeigen
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
erforderlich
updatedAt
string
erforderlich
availability
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
roles.id
string
erforderlich
roles.type
string
erforderlich
Possible values: organization, managed
roles.workspaces
array of string
user
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
weeklySchedule.monday
object
Untergeordnete Attribute anzeigen
weeklySchedule.monday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.monday.from.hour
integer
erforderlich
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.monday.to.hour
integer
erforderlich
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.from.hour
integer
erforderlich
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.to.hour
integer
erforderlich
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.from.hour
integer
erforderlich
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.to.hour
integer
erforderlich
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.from.hour
integer
erforderlich
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.to.hour
integer
erforderlich
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Untergeordnete Attribute anzeigen
weeklySchedule.friday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.friday.from.hour
integer
erforderlich
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.friday.to.hour
integer
erforderlich
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.from.hour
integer
erforderlich
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.to.hour
integer
erforderlich
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.from.hour
integer
erforderlich
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.to.hour
integer
erforderlich
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Untergeordnete Attribute anzeigen
holidays.name
string
erforderlich
holidays.day
integer
erforderlich
holidays.month
integer
erforderlich
assignedSkills
array of object
Untergeordnete Attribute anzeigen
assignedSkills.id
string
erforderlich
assignedSkills.name
string
erforderlich
assignedSkills.selectedValues
array of object
erforderlich
Untergeordnete Attribute anzeigen
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
erforderlich
assignedSkills.selectedValues.value
string
erforderlich
assignedSkills.valueType
string
erforderlich
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
Codebeispiel
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.
Codebeispiel
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.
Antwort-Payload
id
string
erforderlich
status
string
Possible values: active, away, out-of-office
statusBeforeOffline
string
Possible values: active, away, out-of-office
name
string
overrideName
boolean
workspaceId
string
erforderlich
type
string
Possible values: user, ai
userEmails
array of string
bio
string
avatarUrl
string
dropVms
array
Untergeordnete Attribute anzeigen
dropVms.name
string
dropVms.playback
object
erforderlich
Untergeordnete Attribute anzeigen
dropVms.playback.media
array of string
erforderlich
dropVms.playback.pauseMilliseconds
integer
dropVms.name
string
dropVms.say
object
erforderlich
Untergeordnete Attribute anzeigen
dropVms.say.text
string
dropVms.say.voice
string
dropVms.say.locale
string
Possible values: arb, ar-AE, ca-ES, yue-CN, cmn-CN, da-DK, nl-BE, nl-NL, en-AU, en-GB, en-IN, en-NZ, en-ZA, en-US, en-GB-WLS, fi-FI, fr-FR, fr-CA, hi-IN, de-DE, de-AT, is-IS, it-IT, ja-JP, ko-KR, nb-NO, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, es-ES, es-MX, es-US, sv-SE, tr-TR, cy-GB
tagCount
integer
wrapUpTime
integer
rootItemAssignedCount
integer
lastAssignedAt
string
lastSetToAwayAt
string
teams
array of object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
workload.id
string
workload.workload
object
Untergeordnete Attribute anzeigen
workload.workload.messaging
integer
workload.workload.email
integer
workload.rule
object
Untergeordnete Attribute anzeigen
workload.rule.id
string
erforderlich
workload.rule.workspaceId
string
erforderlich
workload.rule.name
string
erforderlich
workload.rule.description
string
erforderlich
workload.rule.default
boolean
workload.rule.capacity
object
erforderlich
Untergeordnete Attribute anzeigen
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
erforderlich
updatedAt
string
erforderlich
availability
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
roles.id
string
erforderlich
roles.type
string
erforderlich
Possible values: organization, managed
roles.workspaces
array of string
user
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
weeklySchedule.monday
object
Untergeordnete Attribute anzeigen
weeklySchedule.monday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.monday.from.hour
integer
erforderlich
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.monday.to.hour
integer
erforderlich
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.from.hour
integer
erforderlich
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.to.hour
integer
erforderlich
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.from.hour
integer
erforderlich
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.to.hour
integer
erforderlich
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.from.hour
integer
erforderlich
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.to.hour
integer
erforderlich
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Untergeordnete Attribute anzeigen
weeklySchedule.friday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.friday.from.hour
integer
erforderlich
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.friday.to.hour
integer
erforderlich
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.from.hour
integer
erforderlich
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.to.hour
integer
erforderlich
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.from.hour
integer
erforderlich
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.to.hour
integer
erforderlich
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Untergeordnete Attribute anzeigen
holidays.name
string
erforderlich
holidays.day
integer
erforderlich
holidays.month
integer
erforderlich
assignedSkills
array of object
Untergeordnete Attribute anzeigen
assignedSkills.id
string
erforderlich
assignedSkills.name
string
erforderlich
assignedSkills.selectedValues
array of object
erforderlich
Untergeordnete Attribute anzeigen
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
erforderlich
assignedSkills.selectedValues.value
string
erforderlich
assignedSkills.valueType
string
erforderlich
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
Codebeispiel
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.
Anfrage-Payload
name
string
bio
string
status
string
Possible values: active, away, out-of-office
avatarUrl
string
dropVms
array
Untergeordnete Parameter anzeigen
dropVms.name
string
dropVms.playback
object
erforderlich
Untergeordnete Parameter anzeigen
dropVms.playback.media
array of string
erforderlich
dropVms.playback.pauseMilliseconds
integer
dropVms.name
string
dropVms.say
object
erforderlich
Untergeordnete Parameter anzeigen
dropVms.say.text
string
dropVms.say.voice
string
dropVms.say.locale
string
Possible values: arb, ar-AE, ca-ES, yue-CN, cmn-CN, da-DK, nl-BE, nl-NL, en-AU, en-GB, en-IN, en-NZ, en-ZA, en-US, en-GB-WLS, fi-FI, fr-FR, fr-CA, hi-IN, de-DE, de-AT, is-IS, it-IT, ja-JP, ko-KR, nb-NO, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, es-ES, es-MX, es-US, sv-SE, tr-TR, cy-GB
wrapUpTime
integer
timezone
string
defaultCountryCode
string
defaultCallerId
string
forwardNumber
object
Untergeordnete Parameter anzeigen
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
Untergeordnete Parameter anzeigen
weeklySchedule.monday
object
Untergeordnete Parameter anzeigen
weeklySchedule.monday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.monday.from.hour
integer
erforderlich
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.monday.to.hour
integer
erforderlich
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.from.hour
integer
erforderlich
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.tuesday.to.hour
integer
erforderlich
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.from.hour
integer
erforderlich
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.wednesday.to.hour
integer
erforderlich
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.from.hour
integer
erforderlich
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.thursday.to.hour
integer
erforderlich
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Untergeordnete Parameter anzeigen
weeklySchedule.friday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.friday.from.hour
integer
erforderlich
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.friday.to.hour
integer
erforderlich
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.from.hour
integer
erforderlich
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.saturday.to.hour
integer
erforderlich
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.from
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.from.hour
integer
erforderlich
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
erforderlich
Untergeordnete Parameter anzeigen
weeklySchedule.sunday.to.hour
integer
erforderlich
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Untergeordnete Parameter anzeigen
holidays.name
string
erforderlich
holidays.day
integer
erforderlich
holidays.month
integer
erforderlich
assignedSkills
array of object
Untergeordnete Parameter anzeigen
assignedSkills.id
string
erforderlich
assignedSkills.name
string
erforderlich
assignedSkills.selectedValues
array of object
erforderlich
Untergeordnete Parameter anzeigen
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
erforderlich
assignedSkills.selectedValues.value
string
erforderlich
assignedSkills.valueType
string
erforderlich
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
Antwort-Payload
id
string
erforderlich
status
string
Possible values: active, away, out-of-office
statusBeforeOffline
string
Possible values: active, away, out-of-office
name
string
overrideName
boolean
workspaceId
string
erforderlich
type
string
Possible values: user, ai
userEmails
array of string
bio
string
avatarUrl
string
dropVms
array
Untergeordnete Attribute anzeigen
dropVms.name
string
dropVms.playback
object
erforderlich
Untergeordnete Attribute anzeigen
dropVms.playback.media
array of string
erforderlich
dropVms.playback.pauseMilliseconds
integer
dropVms.name
string
dropVms.say
object
erforderlich
Untergeordnete Attribute anzeigen
dropVms.say.text
string
dropVms.say.voice
string
dropVms.say.locale
string
Possible values: arb, ar-AE, ca-ES, yue-CN, cmn-CN, da-DK, nl-BE, nl-NL, en-AU, en-GB, en-IN, en-NZ, en-ZA, en-US, en-GB-WLS, fi-FI, fr-FR, fr-CA, hi-IN, de-DE, de-AT, is-IS, it-IT, ja-JP, ko-KR, nb-NO, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, es-ES, es-MX, es-US, sv-SE, tr-TR, cy-GB
tagCount
integer
wrapUpTime
integer
rootItemAssignedCount
integer
lastAssignedAt
string
lastSetToAwayAt
string
teams
array of object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
workload.id
string
workload.workload
object
Untergeordnete Attribute anzeigen
workload.workload.messaging
integer
workload.workload.email
integer
workload.rule
object
Untergeordnete Attribute anzeigen
workload.rule.id
string
erforderlich
workload.rule.workspaceId
string
erforderlich
workload.rule.name
string
erforderlich
workload.rule.description
string
erforderlich
workload.rule.default
boolean
workload.rule.capacity
object
erforderlich
Untergeordnete Attribute anzeigen
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
erforderlich
updatedAt
string
erforderlich
availability
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
roles.id
string
erforderlich
roles.type
string
erforderlich
Possible values: organization, managed
roles.workspaces
array of string
user
object
Untergeordnete Attribute anzeigen
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
Untergeordnete Attribute anzeigen
weeklySchedule.monday
object
Untergeordnete Attribute anzeigen
weeklySchedule.monday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.monday.from.hour
integer
erforderlich
weeklySchedule.monday.from.minute
integer
weeklySchedule.monday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.monday.to.hour
integer
erforderlich
weeklySchedule.monday.to.minute
integer
weeklySchedule.tuesday
object
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.from.hour
integer
erforderlich
weeklySchedule.tuesday.from.minute
integer
weeklySchedule.tuesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.tuesday.to.hour
integer
erforderlich
weeklySchedule.tuesday.to.minute
integer
weeklySchedule.wednesday
object
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.from.hour
integer
erforderlich
weeklySchedule.wednesday.from.minute
integer
weeklySchedule.wednesday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.wednesday.to.hour
integer
erforderlich
weeklySchedule.wednesday.to.minute
integer
weeklySchedule.thursday
object
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.from.hour
integer
erforderlich
weeklySchedule.thursday.from.minute
integer
weeklySchedule.thursday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.thursday.to.hour
integer
erforderlich
weeklySchedule.thursday.to.minute
integer
weeklySchedule.friday
object
Untergeordnete Attribute anzeigen
weeklySchedule.friday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.friday.from.hour
integer
erforderlich
weeklySchedule.friday.from.minute
integer
weeklySchedule.friday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.friday.to.hour
integer
erforderlich
weeklySchedule.friday.to.minute
integer
weeklySchedule.saturday
object
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.from.hour
integer
erforderlich
weeklySchedule.saturday.from.minute
integer
weeklySchedule.saturday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.saturday.to.hour
integer
erforderlich
weeklySchedule.saturday.to.minute
integer
weeklySchedule.sunday
object
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.from
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.from.hour
integer
erforderlich
weeklySchedule.sunday.from.minute
integer
weeklySchedule.sunday.to
object
erforderlich
Untergeordnete Attribute anzeigen
weeklySchedule.sunday.to.hour
integer
erforderlich
weeklySchedule.sunday.to.minute
integer
holidays
array of object
Untergeordnete Attribute anzeigen
holidays.name
string
erforderlich
holidays.day
integer
erforderlich
holidays.month
integer
erforderlich
assignedSkills
array of object
Untergeordnete Attribute anzeigen
assignedSkills.id
string
erforderlich
assignedSkills.name
string
erforderlich
assignedSkills.selectedValues
array of object
erforderlich
Untergeordnete Attribute anzeigen
assignedSkills.selectedValues.icon
string
assignedSkills.selectedValues.id
string
erforderlich
assignedSkills.selectedValues.value
string
erforderlich
assignedSkills.valueType
string
erforderlich
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
Codebeispiel
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.
Antwort-Payload
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
Codebeispiel
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.
Anfrage-Payload
status
string
erforderlich
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
Antwort-Payload
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
Codebeispiel
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.
Antwort-Payload
id
string
workload
object
Untergeordnete Attribute anzeigen
workload.messaging
integer
workload.email
integer
rule
object
Untergeordnete Attribute anzeigen
rule.id
string
erforderlich
rule.workspaceId
string
erforderlich
rule.name
string
erforderlich
rule.description
string
erforderlich
rule.default
boolean
rule.capacity
object
erforderlich
Untergeordnete Attribute anzeigen
rule.capacity.messaging
integer
rule.capacity.email
integer
rule.assignedAgentIds
array of string
rule.createdAt
string
rule.updatedAt
string
ruleId
string
updatedAt
string
Codebeispiel
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/agents/{agentId}/workload' \
-H 'Authorization: AccessKey YOUR_ACCESS_KEY'