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
Erstellt einen ausgehenden Anruf an eine PSTN-Telefonnummer oder einen als Voice Connector oder Voice Connector Group konfigurierten SIP-Trunk und verbindet ihn dann mit einem vorhandenen Anrufabschnitt. Du benutztPSTN
wenn Sie eine Telefonnummer anrufen undAWS
wenn Sie einen SIP-Trunk anrufen
Ein vorhandener Anrufabschnitt kann ein ausgehender Anrufabschnitt sein, der mithilfe desSIP erstellenMediaApplicationCallAPI, oder ein eingehender Abschnitt, der von einer SIP-Regel erstellt wurde, die dieAWS Lambda-Funktion mit einemNewInboundCall
event. Wenn Sie eineCallAndBridge
-Aktion für einen Voice Connector- oder Voice Connector-Gruppen-Endpunkt 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 ausgehenden Anrufteilen hinzufügen undAWS Lambda-Funktionen. Mit benutzerdefinierten Kopfzeilen können Sie Werte wie Stockwerkszahlen und Postleitzahlen übergeben. Weitere Informationen zu benutzerdefinierten Headern finden Sie unterSIP-Header verwendenaus.
Der folgende Beispielcode zeigt eine typische Aktion, die eine Brücke 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, die einen Voice Connector oder eine Voice Connector-Gruppe sowie einen benutzerdefinierten SIP-Header verwendet.
{ "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 vor einem Timeout eines Anrufs. Der Timer startet bei der Anrufeinrichtung
Zulässige Werte— 1 bis 120
Erforderlich— Nein
Standardwert— 30
- CallerIdNumber
-
Beschreibung— Eine Nummer, die dem Kunden gehört, oder die Von-Nummer des A-Beins
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
–AWS
für Sprachanschlüsse und Sprachanschluss-Gruppen, sonstPSTN
aus. -
Arn
— Der ARN eines Voice Connectors oder einer Voice Connector-Gruppe. Nur erforderlich bei Verwendung vonAWS
wie derBridgeEndpointType
aus. -
Uri
— Der URI-Wert hängt von der Art des Endpunkts ab.Für
PSTN
Endpunkten muss der URI eine gültige E.164-Telefonnummer sein.Für
AWS
Endpoints, der URI-Wert setzt dieuser
Teil desRequest-URI
aus. Sie müssen verwendenErweitertes Backus-Naur-Formataus. Erforderliche Länge: zwischen 1 und 30, einschließlich. Verwenden Sie die folgenden Werte: a-z, A-Z, 0-9, &, =, +, $, /, %, -, _, !, ~, *,
(,
), (.
)Der Host-Wert des
Request-URI
wird von den Inbound-Routen des Ziel-Voice Connectors abgeleitet. Das folgende Beispiel zeigt einenCallAndBridge
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 Inbound-Routen und Voice Connectors finden Sie unterAmazon-Chime-Voice-Connector-Einstellungen bearbeitenaus.
Erforderlich— Ja
Standardwert – Kein
-
- SipHeaders
-
Beschreibung— Ermöglicht die Übergabe zusätzlicher Werte. Nur mit dem verwenden
AWS
Endpunkttypen.Zulässige Werte— Gültiger SIP-Header
Erforderlich— Nein
Standardwert – Kein
Das folgende Beispiel zeigt einen erfolgreichenCallAndBridge
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 einen FehlerCallAndBridge
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", ..... } ] } }
Call Flows
DieCallAndBridge
-Aktion zeigt unterschiedliche Rufsignalisierungs- und Rückrufverhalten für den eingehenden A-Anrufabschnitt, je nachdem, ob dieser Abschnitt beantwortet wurde. Die folgenden Sequenzdiagramme zeigen das Verhalten.

Das folgende Diagramm zeigt den Anruffluss eines unbeantworteten Anrufs.

Weitere Details
Denken Sie an diese Fakten über dieCallAndBridge
Aktion
CallTimeoutSeconds— Dieser Timer startet, wenn die SIP-Einladung auf dem B-Leg gesendet wird. Sie können einen gewünschten Zielwert festlegen, dieser Wert kann jedoch von vorgelagerten Anbietern ignoriert werden.
CallerIdNumber— Diese Telefonnummer muss dem Kunden gehören oder die Von-Nummer eines A-Beins sein.
-
Hang-up-Verhalten und Randfälle— Wenn ein Call Leg auflegt, legt der andere Call Leg den Anruf nicht automatisch auf. Wenn ein
Hangup
-Ereignis wird gesendet anAWS Lambda-Funktion muss das verbleibende Bein unabhängig voneinander getrennt werden. Wenn ein Call Leg hängen bleibt, wird der Anruf in Rechnung gestellt, 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 sendet den Anruf direkt an die Voicemail. Aus Sicht des PSTN Audio-Dienstes ist das Gehen zur Voicemail ein beantworteter Anruf. Das A-Leg legt auf, aber das B-Leg hört weiter auf die Voicemail-Nachricht. Während das B-Leg zuhört, wird dir eine Rechnung gestellt.
Als bewährte Methode verwenden Sie denAWS LambdaFunktion, oder der Teilnehmer am anderen Ende des Anrufs, um jeden Anrufabschnitt unabhängig voneinander aufzulegen.
Fakturierung- Ihnen wird Folgendes in Rechnung gestellt, wenn Sie verwenden
CallAndBridge
:Aktive Gesprächsminuten für jeden erstellten Gesprächsabschnitt (A-Leg, B-Leg usw.) beim PSTN.
Nutzungsminuten des PSTN-Audiodienstes.
Siehe Arbeitsbeispiele auf GitHub: