DokumentacjaEngagement Platform API
Sign inGet started
Guides
API

Forward a call

Forward a call to another phone number or to a SIP URI. This command will create a new call resource and both calls will be connected (bridged).
POST
/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/bridge
Creates a new channel call and forward to it
Treść żądania
from
string
to
string
wymagane
ringTimeout
integer
maxDuration
integer
ringTone
string
Possible values: be, ca, cn, cy, cz, de, dk, dz, eg, fi, fr, hk, hu, il, in, jp, ko, pk, pl, ro, rs, ru, sa, tr, uk, us
hangupAfterBridge
boolean
record
boolean
recordStart
string
Possible values: record-from-answer, record-from-ringing
recordStereo
boolean
callFlow
array of object
Pokaż parametry podrzędne
callFlow.command
string
Possible values: hangup, playback, say, gather, pause
callFlow.conditions
array of object
Pokaż parametry podrzędne
callFlow.conditions.variable
string
Possible values: keys, speech
callFlow.conditions.operator
string
Possible values: eq, ne, ==, !=, contains
callFlow.conditions.value
string
callFlow.options
object
Pokaż parametry podrzędne
callFlow.options.media
array of string
wymagane
callFlow.options.loop
integer
callFlow.options.timeout
integer
callFlow.options.pauseMilliseconds
integer
notification
object
Pokaż parametry podrzędne
notification.url
string
amdSettings
object
Pokaż parametry podrzędne
amdSettings.enabled
boolean
wymagane
amdSettings.wordCount
number
wymagane
amdSettings.speechTimeout
number
wymagane
amdSettings.speechLocale
string
wymagane
Possible values: de-DE, en-AU, en-GB, en-US, es-US, it-IT, ja-JP, ko-KR, pt-BR, th-TH, zh-CN
amdSettings.beepTimeout
number
amdSettings.ifMachineNotifyAfter
string
wymagane
Possible values: beep, wordCount
Treść odpowiedzi
command
object
Pokaż atrybuty podrzędne
command.id
string
command.callId
string
command.callFlowId
string
command.status
string
command.command
string
command.conditions
array of object
Pokaż atrybuty podrzędne
command.conditions.variable
string
Possible values: keys, speech
command.conditions.operator
string
Possible values: eq, ne, ==, !=, contains
command.conditions.value
string
bridgedCall
object
Pokaż atrybuty podrzędne
bridgedCall.id
string
wymagane
bridgedCall.channelId
string
wymagane
bridgedCall.from
string
wymagane
bridgedCall.to
string
wymagane
bridgedCall.originator
object
wymagane
Pokaż atrybuty podrzędne
bridgedCall.originator.contact
object
Pokaż atrybuty podrzędne
bridgedCall.originator.contact.id
string
wymagane
bridgedCall.originator.contact.identifierKey
string
wymagane
bridgedCall.originator.contact.identifierValue
string
wymagane
bridgedCall.originator.number
object
wymagane
Pokaż atrybuty podrzędne
bridgedCall.originator.number.type
string
wymagane
Possible values: pstn, sip, webrtc
bridgedCall.originator.number.number
string
wymagane
bridgedCall.originator.number.anonymous
boolean
bridgedCall.originator.number.callerIdName
string
bridgedCall.originator.number.identity
string
bridgedCall.originator.number.countryIsoCode
string
bridgedCall.originator.number.pstnNumberType
string
bridgedCall.receiver
object
wymagane
Pokaż atrybuty podrzędne
bridgedCall.receiver.contact
object
Pokaż atrybuty podrzędne
bridgedCall.receiver.contact.id
string
wymagane
bridgedCall.receiver.contact.identifierKey
string
wymagane
bridgedCall.receiver.contact.identifierValue
string
wymagane
bridgedCall.receiver.number
object
wymagane
Pokaż atrybuty podrzędne
bridgedCall.receiver.number.type
string
wymagane
Possible values: pstn, sip, webrtc
bridgedCall.receiver.number.number
string
wymagane
bridgedCall.receiver.number.anonymous
boolean
bridgedCall.receiver.number.callerIdName
string
bridgedCall.receiver.number.identity
string
bridgedCall.receiver.number.countryIsoCode
string
bridgedCall.receiver.number.pstnNumberType
string
bridgedCall.parentId
string
bridgedCall.direction
string
wymagane
Possible values: incoming, outgoing
bridgedCall.status
string
wymagane
Possible values: accepted, starting, ringing, ongoing, completed, busy, no-answer, failed, cancelled, scheduled
bridgedCall.reason
string
bridgedCall.type
string
wymagane
Possible values: pstn, sip, webrtc
bridgedCall.duration
integer
bridgedCall.hangupCauseCode
integer
bridgedCall.hangupSource
string
Possible values: callee, caller, api, timeout, media-timeout, none
bridgedCall.hangupSipCode
string
bridgedCall.createdAt
string
wymagane
bridgedCall.updatedAt
string
wymagane
bridgedCall.ringingAt
string
bridgedCall.answeredAt
string
bridgedCall.endedAt
string
bridgedCall.scheduledFor
string
bridgedCall.callFlow
object
Pokaż atrybuty podrzędne
bridgedCall.callFlow.id
string
bridgedCall.callFlow.commands
array of object
Pokaż atrybuty podrzędne
bridgedCall.callFlow.commands.id
string
bridgedCall.callFlow.commands.callId
string
bridgedCall.callFlow.commands.callFlowId
string
bridgedCall.callFlow.commands.status
string
bridgedCall.callFlow.commands.command
string
bridgedCall.callFlow.commands.conditions
array of object
Pokaż atrybuty podrzędne
bridgedCall.callFlow.commands.conditions.variable
string
Possible values: keys, speech
bridgedCall.callFlow.commands.conditions.operator
string
Possible values: eq, ne, ==, !=, contains
bridgedCall.callFlow.commands.conditions.value
string
bridgedCall.notification
object
Pokaż atrybuty podrzędne
bridgedCall.notification.url
string
bridgedCall.qualityInsights
object
Pokaż atrybuty podrzędne
bridgedCall.qualityInsights.mos
string
bridgedCall.qualityInsights.pdd
string
bridgedCall.sipInsights
object
Pokaż atrybuty podrzędne
bridgedCall.sipInsights.hangupSipCode
string
bridgedCall.sipInsights.edgeRegion
string
bridgedCall.sipInsights.providerName
string
bridgedCall.sipInsights.userAgent
string
bridgedCall.sipInsights.remoteSignallingIp
string
bridgedCall.sipInsights.remoteMediaIp
string
bridgedCall.amdResult
object
Pokaż atrybuty podrzędne
bridgedCall.amdResult.result
string
Possible values: human, machine, noSpeech, beep, unknown
bridgedCall.amdResult.speech
string
bridgedCall.amdResult.locale
string
bridgedCall.sipType
string
Possible values: elastic, byoc, forward
bridgedCall.tags
array of string
Tags to associate with the call. Tags are converted to lower case and tags that do not exist are automatically created. You can view your created tags in the UI. You can specify up to 10 tags per call.
Przykład kodu
curl -X POST 'https://api.bird.com/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/bridge' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'

Example 1: Forward an inbound call to an external number

Przykład kodu
curl -X POST "https://api.bird.com/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/bridge" \
     -H "Authorization: AccessKey YOUR_SECRET_TOKEN"