Fordere Telefonnummern bei Verteilergruppen an

Anmerkung

Diese Funktion ist nur für Amazon Connect Connect-Instances verfügbar, die in den Regionen USA Ost (Nord-Virginia) und USA West (Oregon) erstellt wurden.

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

Nachdem Ihre Traffic-Verteilergruppe erfolgreich erstellt wurde (StatusistACTIVE), können Sie SearchAvailablePhoneNumbersdamit ClaimPhoneNumbernach verfügbaren Telefonnummern suchen und diese anfordern.

Bevor Sie eine Telefonnummer für Ihre Verkehrsverteilergruppe beanspruchen, empfehlen wir, mithilfe der DescribeTrafficDistributionGroupAPI zu überprüfen, ob der Status der Verkehrsverteilergruppe lautetACTIVE. Das Zuweisen einer Telefonnummer zu einer Verkehrsverteilergruppe ACTIVE führt dazu, dass dies nicht der Fall ResourceNotFoundException ist.

Sie können eine Telefonnummer für eine Verkehrsverteilergruppe beanspruchen, indem Sie beim Aufrufen der ClaimPhoneNumberAPI den ARN der Verkehrsverteilergruppe im TargetArnParameter angeben. Sie können die UpdatePhoneNumberAPI auch verwenden, 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 Connect-Konsole verwenden.

Beispiel für einen Arbeitsablauf

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

1. Erstellen Sie ein Replikat Ihrer Instanz:

   1. Rufen Sie die ReplicateInstance-API auf.

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

   1. Rufen Sie die CreateTrafficDistributionGroup-API auf.

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

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

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

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

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

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

5. Stellen Sie sicher, dass der Status der Telefonnummer wie folgt lautetCLAIMED:

   1. Rufen Sie die DescribePhoneNumber-API auf.

      (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 lautetCLAIMED.

   Eine Beschreibung der möglichen Status finden Sie unterDer Status von Telefonnummern ist definiert.

6. Wiederholen Sie die Schritte 3 bis 5 für alle Telefonnummern, die Sie bei Ihrer Traffic-Verteilergruppe beanspruchen müssen.

7. Gehen Sie wie folgt vor, um Telefonnummern Flows zuzuordnen. Führen Sie sie in beiden Regionen aus, in denen die Verkehrsverteilergruppe tätig ist.

   Diese Schritte stellen sicher, dass Ihr Telefonverkehr korrekt an Ihre Datenflüsse weitergeleitet wird, um Ihre Konfiguration der Verkehrsverteilung zu unterstützen.

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

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

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

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

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

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

Warum schlägt ein ClaimPhoneNumber Anruf fehl

Ihr ClaimPhoneNumberAPI-Aufruf schlägt ResourceNotFoundException in den folgenden Fällen mit einer fehl:

• Die angegebene Verkehrsverteilergruppe ist nicht vorhanden, der Status der Verkehrsverteilergruppe ist nichtACTIVE, oder Sie sind nicht Eigentümer der Verkehrsverteilergruppe.

• 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 beansprucht.

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

• Der Endpunkt, den Sie anrufen, befindet sich nicht in derselben Region, in der die Verkehrsverteilergruppe erstellt wurde.

Der Status von Telefonnummern ist definiert

Im Folgenden finden Sie eine Beschreibung des Rufnummernstatus:

• CLAIMEDbedeutet, dass der vorherige UpdatePhoneNumberVorgang ClaimPhoneNumberoder die 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. Es enthält eine Meldung, in der die Ursache des Fehlers angegeben ist.

  Ein häufiger Grund für einen Ausfall ist, dass der TargetArn Wert, auf den 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-Aufrufs 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 einfordern können.