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 benutztPSTNwenn Sie eine Telefonnummer anrufen undAWSwenn 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 einemNewInboundCallevent. 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–AWSfür Sprachanschlüsse und Sprachanschluss-Gruppen, sonstPSTNaus.

• Arn— Der ARN eines Voice Connectors oder einer Voice Connector-Gruppe. Nur erforderlich bei Verwendung vonAWSwie derBridgeEndpointTypeaus.

• Uri— Der URI-Wert hängt von der Art des Endpunkts ab.

  FürPSTNEndpunkten muss der URI eine gültige E.164-Telefonnummer sein.

  FürAWSEndpoints, der URI-Wert setzt dieuserTeil desRequest-URIaus. 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 desRequest-URIwird von den Inbound-Routen des Ziel-Voice Connectors abgeleitet. Das folgende Beispiel zeigt einenCallAndBridgeAktion mit einemAWS-Endpunkt.

  {
     "SchemaVersion":"1.0",
     "Actions":[
        {
           "Type":"CallAndBridge",
           "Parameters":{
              "CallTimeoutSeconds":30,
              "CallerIdNumber": "[phone]",
              "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 verwendenAWSEndpunkttypen.

Zulässige Werte— Gültiger SIP-Header

Erforderlich— Nein

Standardwert – Kein

Das folgende Beispiel zeigt einen erfolgreichenCallAndBridgeAktion, 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 FehlerCallAndBridgeAktion

{
   "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 dieCallAndBridgeAktion

• 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 einHangup-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 verwendenCallAndBridge:

  • Aktive Gesprächsminuten für jeden erstellten Gesprächsabschnitt (A-Leg, B-Leg usw.) beim PSTN.

  • Nutzungsminuten des PSTN-Audiodienstes.

Siehe Arbeitsbeispiele auf GitHub:

• https://github.com/aws-samples/amazon-chime-sma-bridging

• https://github.com/aws-samples/amazon-chime-sma-call-Weiterleitung

• https://github.com/aws-samples/amazon-chime-sma-on-Aufnahme