CallAndBridge - Amazon Chime SDK
Anrufabläufe

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ürPSTN Endpoints muss die URI eine gültige E.164-Telefonnummer sein.

    BeiAWS Endpunkten legt der URI-Wert denuser Teil von festRequest-URI. Sie müssen das Augmented Backus-Naur-Format verwenden. Erforderliche Länge: zwischen 1 und 30, einschließlich. Verwenden Sie die folgenden Werte:a-z, A-Z, 0-9, &, =, +, $, /, %, -, _, !, ~, *, (,), (.)

    Der Hostwert vonRequest-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 demAWS 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.

Der Ablauf eines beantworteten Anrufs während derCallAndBridge Aktion.

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

Der Ablauf eines Anrufs durch dieCallAndBridge Aktion.
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 einHangup 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 gestelltCallAndBridge:

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