Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
CallAndBridge
Erzeugt einen ausgehenden Anruf an eine PSTN-Telefonnummer oder an einen SIP-Trunk, der als Amazon Chime SDK Voice Connector oder Amazon Chime SDK Voice Connector-Gruppe konfiguriert ist, und verbindet ihn dann mit einem vorhandenen Anrufabschnitt. Sie verwendenPSTN
, wenn Sie eine Telefonnummer anrufen, undAWS
wenn Sie einen SIP-Trunk anrufen.
Ein vorhandener Anrufabschnitt kann ein ausgehender Anrufabschnitt sein, der mithilfe der MediaApplicationCallCreateSIP-API erstellt wurde, oder ein eingehender Abschnitt, der durch eine SIP-Regel erstellt wurde, die dieAWS Lambda Funktion mit einemNewInboundCall
Ereignis aufruft. Wenn Sie eineCallAndBridge
Aktion für einen Voice Connector- oder Voice Connector-Gruppen-Endpunkt implementieren, müssen Sie die Amazon Resource Number (ARN) des Voice Connector oder der Voice Connector-Gruppe angeben.
Sie können auch benutzerdefinierte SIP-Header zu abgehenden Anrufabschnitten undAWS Lambda Funktionen hinzufügen. Mit benutzerdefinierten Headern können Sie Werte wie Stockwerksnummern und Postleitzahlen übergeben. Weitere Informationen zu benutzerdefinierten Headern finden Sie unterSIP-Header verwenden.
Der folgende Beispielcode zeigt eine typische Aktion, die eine Verbindung zu einem PSTN-Endpunkt herstellt.
{ "SchemaVersion":"1.0", "Actions":[ { "Type":"CallAndBridge", "Parameters":{ "CallTimeoutSeconds":
30
, "CallerIdNumber": "e164PhoneNumber
", // required "Endpoints":[ { "BridgeEndpointType":"PSTN" // required "Uri":"e164PhoneNumber
", // required } ], } } } ] }
Das folgende Beispiel zeigt eine typische Aktion, bei der ein Voice Connector oder eine Voice Connector-Gruppe sowie ein benutzerdefinierter SIP-Header verwendet werden.
{ "SchemaVersion":"1.0", "Actions":[ { "Type":"CallAndBridge", "Parameters":{ "CallTimeoutSeconds":
30
, "CallerIdNumber": "e164PhoneNumber
", // required "RingbackTone": { // optional "Type": "S3", "BucketName": "s3_bucket_name
", "Key": "audio_file_name
" }, "Endpoints":[ { "BridgeEndpointType":"AWS", // enum type, required "Arn":"arn:aws:chime:us-east-1
:0123456789101
:vc/abcdefg1hijklm2nopq3rs
" //VC or VCG ARN, required for AWS endpoints "Uri":"ValidString
", // required, see description below } ], "SipHeaders": { "x-String
":"String
" } } } ] }
- CallTimeoutSeconds
-
Beschreibung — Das Intervall, bevor ein Anruf das Timeout überschreitet. Der Timer beginnt bei der Einrichtung des Anrufs
Zulässige Werte — Zwischen 1 und 120, einschließlich
Erforderlich — Nein
Standardwert — 30
- CallerIdNumber
-
Beschreibung — Eine Nummer, die dem Kunden gehört, oder die Absendernummer des A-Leg
Zulässige Werte — Eine gültige Telefonnummer im E.164-Format
Erforderlich — Ja
Standardwert – Kein
- Endpunkte
-
Beschreibung — Die Endpunkte eines Anrufs
Zulässige Werte:
-
BridgeEndpointType
— andernfallsAWS
für Voice Connectors und Voice Connector-GruppenPSTN
. -
Arn
— Der ARN eines Voice Connectors oder einer Voice Connector-Gruppe. Nur erforderlich, wenn SieAWS
es als verwendenBridgeEndpointType
. -
Uri
— Der URI-Wert hängt von der Art des Endpunkts ab.Für
PSTN
Endpoints muss die URI eine gültige E.164-Telefonnummer sein.Bei
AWS
Endpunkten legt der URI-Wert denuser
Teil von festRequest-URI
. Sie müssen das Augmented Backus-Naur-Formatverwenden. Erforderliche Länge: zwischen 1 und 30, einschließlich. Verwenden Sie die folgenden Werte: a-z, A-Z, 0-9, &, =, +, $, /, %, -, _, !, ~, *,
(,
), (.
)Der Hostwert von
Request-URI
wird von den eingehenden Routen des Ziel-Voice Connectors abgeleitet. Das folgende Beispiel zeigt eineCallAndBridge
Aktion mit einemAWS
Endpunkt.{ "SchemaVersion":"1.0", "Actions":[ { "Type":"CallAndBridge", "Parameters":{ "CallTimeoutSeconds":
30
, "CallerIdNumber": "+18005550122
", "Endpoints":[ { "BridgeEndpointType":"AWS", "Arn":"arn:aws:chime:us-east-1
:0123456789101
:vc/abcdefg1hijklm2nopq3rs
", "Uri":"5550
" } ], "SipHeaders": { "x-String
":"String
" } } } ] }Weitere Informationen zu eingehenden Routen und Voice Connectors finden Sie unter Bearbeiten der Amazon Chime SDK Voice Connector-Einstellungen.
Erforderlich — Ja
Standardwert – Kein
-
- SipHeaders
-
Beschreibung — Ermöglicht es Ihnen, zusätzliche Werte zu übergeben. Nur mit dem
AWS
Endpunkttyp verwenden.Zulässige Werte — Gültiger SIP-Header
Erforderlich — Nein
Standardwert – Kein
Das folgende Beispiel zeigt eineCallAndBridge
Aktion, die einen PSTN-Endpunkt verwendet:
{ "SchemaVersion": "1.0", "Sequence": 3, "InvocationEventType": "ACTION_SUCCESSFUL", "ActionData": { "Type": "CallAndBridge", "Parameters": { "CallTimeoutSeconds":
30
, "CallerIdNumber": "e164PhoneNumber
", "Endpoints":[ { "BridgeEndpointType": "PSTN", "Uri": "e164PhoneNumber
" } ], "CallId": "call-id-1
" } }, "CallDetails":{ ..... ..... "Participants":[ { "CallId": "call-id-1
", "ParticipantTag": "LEG-A", ..... "Status": "Connected" }, { "CallId": "call-id-2
", "ParticipantTag": "LEG-B", ..... "Status": "Connected" } ] } }
Das folgende Beispiel zeigt eineCallAndBridge
Aktion.
{ "SchemaVersion": "1.0", "Sequence":2, "InvocationEventType": "ACTION_FAILED", "ActionData":{ "Type": "CallAndBridge", "Parameters":{ "CallTimeoutSeconds":
30
, "CallerIdNumber": "e164PhoneNumber
", "Endpoints": [ { "BridgeEndpointType": "PSTN", "Uri": "e164PhoneNumber
" } ], "CallId": "call-id-1
" }, "ErrorType": "CallNotAnswered", "ErrorMessage": "Call not answered" }, "CallDetails":{ ..... ..... "Participants":[ { "CallId": "call-id-1
", "ParticipantTag": "LEG-A", ..... } ] } }
Anrufabläufe
DieCallAndBridge
Aktion bietet ein anderes Rufsignalisierungs- und Audioerlebnis für einen vorhandenen Anrufabschnitt, abhängig von den Parametern und davon, ob der Abschnitt angeschlossen ist.
Das folgende Diagramm zeigt die Anruffläufe mit unterschiedlichen Parametern, wenn ein eingehender Anrufabschnitt A bereits verbunden ist.

Das folgende Diagramm zeigt den Anruffluss für einen unbeantworteten Anruf.

Weitere Details
Denken Sie an diese Fakten über dieCallAndBridge
Aktion.
CallTimeoutSeconds— Dieser Timer beginnt, wenn die SIP-Einladung auf dem B-Leg gesendet wird. Sie können einen gewünschten Zielwert festlegen, dieser Wert kann jedoch von den vorgelagerten Transporteuren ignoriert werden.
CallerIdNumber— Diese Telefonnummer muss dem Kunden gehören oder die Absendernummer eines A-Leg sein.
-
Verhalten beim Auflegen und Randfälle — Wenn ein Gesprächsabschnitt auflegt, legt der andere Gesprächsabschnitt den Anruf nicht automatisch auf. Wenn ein
Hangup
Ereignis an dieAWS Lambda Funktion gesendet wird, muss das verbleibende Bein unabhängig voneinander getrennt werden. Bleibt ein Gesprächsabschnitt hängen, wird der Anruf so lange abgerechnet, bis er aufgelegt wird. Das folgende Szenario kann beispielsweise zu unerwarteten Gebühren führen:Sie versuchen eine Verbindung zu einer Zieltelefonnummer herzustellen. Das Ziel ist besetzt und leitet den Anruf direkt an die Voicemail weiter. Aus Sicht des Audiodienstes ist das Aufrufen der Voicemail ein beantworteter Anruf. Das A-Leg legt auf, aber das B-Leg wartet weiter auf die Voicemail-Nachricht. Während das B-Leg zuhört, bekommst du eine Rechnung.
Es hat sich bewährt, dieAWS Lambda Funktion oder den Teilnehmer am anderen Ende des Anrufs zu verwenden, um jeden Gesprächsabschnitt unabhängig voneinander aufzulegen.
Abrechnung — Bei der Nutzung wird Ihnen Folgendes in Rechnung gestellt
CallAndBridge
:Aktive Gesprächsminuten für jeden erstellten Gesprächsabschnitt (A-Leg, B-Leg usw.) zum PSTN.
Minuten der Nutzung des Audiodienstes.
Arbeitsbeispiele finden Sie unter GitHub: