Mit Amazon Connect Telefonnummern bei Traffic-Verteilergruppen beanspruchen - Amazon Connect
Beispiel-ArbeitsFlowsWarum schlägt ein ClaimPhoneNumber Anruf fehlDefinitionen der Rufnummernstatuswerte

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.

Mit Amazon Connect Telefonnummern bei Traffic-Verteilergruppen beanspruchen

Anmerkung

Neuer Benutzer? Schauen Sie sich den Amazon Connect Global Resiliency Workshop an. Dieser Online-Kurs führt Sie durch den Prozess des Onboardings und Testens von Telefonnummer und Agenten-Failover mithilfe von New APIs Through the. AWS CLI

Global Resiliency ist nur für Amazon Connect Connect-Instances verfügbar, die in den folgenden AWS Regionen erstellt wurden: USA Ost (Nord-Virginia), USA West (Oregon), Europa (Frankfurt) und Europa (London).

Sie können ein Replikat in der Region USA Ost (Nord-Virginia) nur erstellen, wenn Ihre Quelle USA West (Oregon) ist, oder umgekehrt. Ebenso können Sie in der Region Europa (Frankfurt) nur dann ein Replikat erstellen, wenn Ihre Quelle Europa (London) ist, oder umgekehrt.

Um Zugriff auf diese Funktion zu erhalten, wenden Sie sich an Ihren Amazon Connect Solutions Architect oder Technical Account Manager.

Nachdem Ihre Verkehrsverteilergruppe erfolgreich erstellt wurde (StatusistACTIVE), können Sie sie verwenden, SearchAvailablePhoneNumbersum nach verfügbaren Telefonnummern zu suchen und diese ClaimPhoneNumberzu beanspruchen.

Bevor Sie eine Telefonnummer für Ihre Verkehrsverteilergruppe beanspruchen, empfehlen wir, anhand der DescribeTrafficDistributionGroupAPIzu überprüfen, ob der Status der Verkehrsverteilergruppe lautetACTIVE. Das Zuweisen einer Telefonnummer zu einer Datenverkehr-Verteilergruppe, die nicht ACTIVE ist, führt zum Fehler ResourceNotFoundException.

Sie können eine Telefonnummer für eine Verkehrsverteilergruppe beanspruchen, indem Sie die Verkehrsverteilergruppe ARN im TargetArnParameter angeben, wenn Sie die aufrufen ClaimPhoneNumberAPI. Sie können den auch verwenden UpdatePhoneNumberAPI, um eine Telefonnummer, die zuvor für eine Instanz beansprucht wurde, einer Verkehrsverteilergruppe zuzuweisen.

Anmerkung

Um das Feld Beschreibung zu aktualisieren, müssen Sie die Amazon-Connect-Konsole verwenden.

Beispiel-ArbeitsFlows

Im Folgenden finden Sie ein Beispiel für einen ArbeitsFlow, um Telefonnummern zu beanspruchen und sie für mehrere AWS-Regionen zu verwenden:

  1. Erstellen Sie ein Replikat Ihrer Instance:

    1. Rufen Sie die an ReplicateInstanceAPI.

  2. Erstellen Sie eine Datenverkehr-Verteilergruppe, die diese Instances miteinander verbindet:

    1. Ruf die an CreateTrafficDistributionGroupAPI.

  3. Suchen Sie nach verfügbaren Telefonnummern, die für die Datenverkehr-Verteilergruppe beansprucht werden können:

    1. Rufen Sie die SearchAvailablePhoneNumbersAPIin der Region an, in der die Verkehrsverteilergruppe erstellt wurde. Geben Sie die Verkehrsverteilergruppe ARN für den TargetArn Parameter an.

  4. Rufen Sie in der Region, in der die Verkehrsverteilergruppe erstellt wurde, den folgenden Befehl auf ClaimPhoneNumberAPI:

    1. Geben Sie Ihre Verkehrsverteilergruppe ARN für den TargetArn Parameter an.

    2. Geben Sie den E164-Telefonnummernwert an, der durch den SearchAvailablePhoneNumbersAPIAnruf in Schritt 3 zurückgegeben wurde.

    Eine PhoneNumberId und ein PhoneNumberArn werden zurückgegeben. Sie können diese Werte für Folgeoperationen verwenden.

  5. Stellen Sie sicher, dass der Status der Telefonnummer CLAIMED lautet:

    1. Rufen Sie den DescribePhoneNumberAPIan.

      (DescribePhoneNumber kann auch in der anderen Region angerufen werden, die der Verkehrsverteilergruppe zugeordnet ist. Es werden dieselben Telefonnummerndetails zurückgegeben.)

    Die Telefonnummer kann erst dann für Folgeoperationen verwendet werden, wenn ihr Status CLAIMED lautet.

    Eine Beschreibung der möglichen Statuswerte finden Sie unter Definitionen der Rufnummernstatuswerte.

  6. Wiederholen Sie die Schritte 3 bis 5 für alle Telefonnummern, die Sie für die Datenverkehr-Verteilergruppe beanspruchen möchten.

  7. Gehen Sie wie folgt vor, um Telefonnummern Flows zuzuordnen. Führen Sie sie in beiden Regionen aus, in denen die Datenverkehr-Verteilergruppe aktiv ist.

    Diese Schritte stellen sicher, dass Ihr Telefonieverkehr korrekt an Ihre DatenFlows weitergeleitet wird, um Ihre Konfiguration der Datenverkehrsverteilung zu unterstützen.

    1. Gehen Sie in Ihrer bestehenden Amazon-Connect-Instance in der Region, in der die Datenverkehr-Verteilergruppe erstellt wurde, wie folgt vor:

      1. Ruf an ListContactFlowsAPI. Geben Sie die InstanceId an, die der replizierten Instance entspricht.

      2. Eine Flow-Liste ARNs wird zurückgegeben. Verwenden Sie diese ARNs Flows, um einen Flow einer Telefonnummer zuzuordnen. Rufen Sie die an AssociatePhoneNumberContactFlowAPI.

    2. Führen Sie in der replizierten Amazon Connect Connect-Instance in der anderen AWS Region die folgenden Schritte aus:

      1. Rufen Sie an. ListContactFlowsAPI Geben Sie die InstanceId an, die der replizierten Instance entspricht.

      2. Eine Flow-Liste ARNs wird zurückgegeben. Verwenden Sie diese ARNs Flows, um einen Flow einer Telefonnummer zuzuordnen. Rufen Sie die an AssociatePhoneNumberContactFlowAPI.

Warum schlägt ein ClaimPhoneNumber Anruf fehl

Ihr ClaimPhoneNumberAPIAnruf schlägt ResourceNotFoundException in den folgenden Fällen mit einem fehl:

  • Die angegebene Datenverkehr-Verteilergruppe ist nicht vorhanden, der Status der Datenverkehr-Verteilergruppe ist nicht ACTIVE oder Sie sind nicht Eigentümer der Datenverkehr-Verteilergruppe.

  • Die Telefonnummer ist nicht verfügbar, um Ansprüche geltend zu machen. In einigen Fällen wurde eine Telefonnummer, von der Sie gefunden haben, SearchAvailablePhoneNumbersmöglicherweise von einem anderen Kunden angefordert.

ClaimPhoneNumberschlägt im folgenden Fall mit einem InvalidParameterException Fehler fehl:

  • Der Endpunkt, den Sie aufrufen, befindet sich nicht in derselben Region, in der die Datenverkehr-Verteilergruppe erstellt wurde.

Definitionen der Rufnummernstatuswerte

Im Folgenden finden Sie eine Beschreibung der Rufnummernstatuswerte:

  • CLAIMEDbedeutet, dass die ClaimPhoneNumbervorherige UpdatePhoneNumberOder-Operation erfolgreich war.

  • IN_PROGRESSbedeutet a ClaimPhoneNumber, der UpdatePhoneNumberVorgang ist noch im Gange und wurde noch nicht abgeschlossen. Sie können zu einem späteren DescribePhoneNumberZeitpunkt anrufen, um zu überprüfen, ob der vorherige Vorgang abgeschlossen wurde.

  • FAILEDzeigt an, dass der ClaimPhoneNumbervorherige UpdatePhoneNumberOder-Vorgang fehlgeschlagen ist. Enthält eine Meldung, in der die Ursache des Fehlers angegeben ist.

    Ein häufiger Grund für einen Fehlschlag ist, dass der Wert TargetArn, mit dem Sie eine Telefonnummer beanspruchen oder auf den Sie eine Telefonnummer aktualisieren, das Limit für die Gesamtzahl der beanspruchten Nummern erreicht hat.

    Wenn Sie aufgrund eines ClaimPhoneNumber API Anrufs einen FAILED Status erhalten haben, haben Sie einen Tag Zeit, um erneut zu versuchen, die Telefonnummer zu beanspruchen, bevor die Nummer wieder in den Bestand aufgenommen wird, sodass andere Kunden sie einholen können.