View a markdown version of this page

Fordern Sie mithilfe von Connect Customer Telefonnummern bei Traffic-Verteilergruppen an - Amazon Connect-Kunde
Beispiel-ArbeitsFlowsWarum ein ClaimPhoneNumber Anruf fehlschlägtDefinitionen 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.

Fordern Sie mithilfe von Connect Customer Telefonnummern bei Traffic-Verteilergruppen an

Anmerkung

Neuer Benutzer? Schauen Sie sich den Connect Customer Global Resiliency Workshop an. Dieser Online-Kurs führt Sie durch den Einstieg in die Anwendung und das Failover-Testing von Rufnummern und Kundendienstmitarbeitern unter Verwendung neuer APIs über die AWS-CLI.

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

  • Sie können ein Replikat in der Region USA Ost (Nord-Virginia) nur dann erstellen, wenn sich die Quelle in der Region USA West (Oregon) befindet oder umgekehrt.

  • Sie können ein Replikat in der Region Europa (Frankfurt) nur dann erstellen, wenn die Quelle sich in der Region Europa (London) befindet oder umgekehrt.

  • Sie können ein Replikat in der Region Asien-Pazifik (Osaka) nur dann erstellen, wenn die Quelle sich in der Region Asien-Pazifik (Tokio) befindet.

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

Nachdem Ihre Traffic-Verteilergruppe erfolgreich erstellt wurde (StatusistACTIVE), können Sie sie verwenden, SearchAvailablePhoneNumbers um nach verfügbaren Telefonnummern zu suchen und diese ClaimPhoneNumber zu beanspruchen.

Bevor Sie eine Telefonnummer für Ihre Traffic-Verteilergruppe beanspruchen, empfehlen wir Ihnen, mithilfe der DescribeTrafficDistributionGroup API zu überprüfen, ob der Status der Traffic-Verteilergruppe 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 Traffic-Verteilergruppe beanspruchen, indem Sie beim Aufrufen der ClaimPhoneNumber API den ARN der Traffic-Verteilergruppe im TargetArn Parameter angeben. Sie können die UpdatePhoneNumber API auch verwenden, um eine zuvor für eine Instance beanspruchte Telefonnummer einer Traffic-Verteilergruppe zuzuweisen.

Anmerkung

Um das Feld Beschreibung zu aktualisieren, müssen Sie die Connect Customer-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 ReplicateInstance-API auf.

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

    1. Rufen Sie die CreateTrafficDistributionGroup-API auf.

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

    1. Rufen Sie die SearchAvailablePhoneNumbers API in der Region auf, in der die Traffic-Verteilergruppe erstellt wurde. Geben Sie den ARN der Datenverkehr-Verteilergruppe für den Parameter TargetArn an.

  4. Rufen Sie in der Region, in der die Traffic-Verteilergruppe erstellt wurde, die ClaimPhoneNumber API auf:

    1. Geben Sie den ARN der Datenverkehr-Verteilergruppe für den Parameter TargetArn an.

    2. Geben Sie den E164-Telefonnummernwert ein, der vom SearchAvailablePhoneNumbers API-Aufruf 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 die DescribePhoneNumber-API auf.

      (DescribePhoneNumber kann auch in der anderen Region aufgerufen werden, die der Traffic-Verteilergruppe 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 Connect Customer-Instanz in der Region, in der die Traffic-Verteilergruppe erstellt wurde, wie folgt vor:

      1. Rufen Sie die ListContactFlows API auf. Geben Sie die InstanceId an, die der replizierten Instance entspricht.

      2. Eine Liste von Flow-ARNs wird zurückgegeben. Verwenden Sie diese Flow-ARNs, um einen Flow einer Telefonnummer zuzuordnen; rufen Sie die AssociatePhoneNumberContactFlow API auf.

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

      1. Rufen Sie die ListContactFlows API auf. Geben Sie die InstanceId an, die der replizierten Instance entspricht.

      2. Eine Liste von Flow-ARNs wird zurückgegeben. Verwenden Sie diese Flow-ARNs, um einen Flow einer Telefonnummer zuzuordnen; rufen Sie die AssociatePhoneNumberContactFlow API auf.

Warum ein ClaimPhoneNumber Anruf fehlschlägt

Ihr ClaimPhoneNumber API-Aufruf 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, die von gefunden wurde, SearchAvailablePhoneNumbers möglicherweise von einem anderen Kunden beansprucht.

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 vorherige UpdatePhoneNumber Operation ClaimPhoneNumber oder der vorherige Vorgang erfolgreich war.

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

  • FAILEDzeigt an, dass der ClaimPhoneNumber vorherige UpdatePhoneNumber 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 API-Aufrufs von ClaimPhoneNumber den Status FAILED 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 anfordern können.