Solicitud de números de teléfono para grupos de distribución de tráfico

nota

Esta función solo está disponible para las instancias de Amazon Connect creadas en las siguientes AWS regiones: EE. UU. Este (Virginia del Norte), EE. UU. Oeste (Oregón), Europa (Fráncfort) y Europa (Londres).

Solo puede crear una réplica en la región EE.UU. Este (Norte de Virginia) si su origen es EE.UU. Oeste (Oregón) o viceversa. Del mismo modo, solo puede crear una réplica en la región de Europa (Fráncfort) si su origen es Europa (Londres) o viceversa.

Para obtener acceso a esta característica, contacte con su arquitecto de soluciones o administrador técnico de cuentas de Amazon Connect.

Una vez que el grupo de distribución de tráfico Status se ACTIVE haya creado correctamente, podrá utilizarlo SearchAvailablePhoneNumberspara buscar los números de teléfono disponibles y ClaimPhoneNumberreclamarlos.

Antes de solicitar un número de teléfono para tu grupo de distribución de tráfico, te recomendamos que DescribeTrafficDistributionGrouputilices la API para comprobar el estado del grupo de distribución de tráficoACTIVE. Asignar un número de teléfono a un grupo de distribución de tráfico que no tiene el estado ACTIVE da como resultado ResourceNotFoundException.

Para solicitar un número de teléfono a un grupo de distribución de tráfico, proporciona el ARN del grupo de distribución de tráfico en el TargetArnparámetro al llamar a la ClaimPhoneNumberAPI. También puedes usar la UpdatePhoneNumberAPI para asignar un número de teléfono previamente reclamado a una instancia a un grupo de distribución de tráfico.

nota

Para actualizar el campo Descripción, debe utilizar la consola de Amazon Connect.

Ejemplo de flujo de trabajo

A continuación, se muestra un ejemplo de flujo de trabajo para solicitar números de teléfono y utilizarlos en varias Regiones de AWS:

1. Cree una réplica de su instancia:

   1. Llame a la API de ReplicateInstance.

2. Cree un grupo de distribución de tráfico que vincule estas instancias:

   1. Llame a la API de CreateTrafficDistributionGroup.

3. Busque números de teléfono disponibles que puedan solicitarse para su grupo de distribución de tráfico:

   1. Llama a la SearchAvailablePhoneNumbersAPI de la región en la que se creó el grupo de distribución de tráfico. Proporcione el ARN de grupo de distribución de tráfico para el parámetro TargetArn.

4. En la región en la que se creó el grupo de distribución de tráfico, llama a la ClaimPhoneNumberAPI:

   1. Proporcione el ARN de grupo de distribución de tráfico para el parámetro TargetArn.

   2. Proporcione el valor del número de teléfono E164 que devolvió la llamada a la SearchAvailablePhoneNumbersAPI en el paso 3.

   Se devuelven PhoneNumberId y PhoneNumberArn. Puede utilizar estos valores para las operaciones de seguimiento.

5. Compruebe que el estado del número de teléfono es CLAIMED:

   1. Llame a la API de DescribePhoneNumber.

      (también se DescribePhoneNumber puede llamar en la otra región asociada al grupo de distribución de tráfico. Devolverá los mismos detalles del número de teléfono).

   El número de teléfono puede utilizarse mediante operaciones de seguimiento solo después de que su estado sea CLAIMED.

   Para obtener una descripción de los posibles estados, consulte Definición de los estados de número de teléfono.

6. Repita los pasos del 3 al 5 para todos los números de teléfono que necesite solicitar para su grupo de distribución de tráfico.

7. Realice los siguientes pasos para asociar flujos a números de teléfono. Hágalos en las dos regiones en las que opera el grupo de distribución de tráfico.

   Estos pasos garantizan que el tráfico de telefonía se enrute correctamente hacia sus flujos para admitir su configuración de distribución de tráfico.

   1. En su instancia de Amazon Connect existente en la región en la que se creó el grupo de distribución de tráfico, realice los pasos siguientes:

      1. Llame a ListContactFlowsla API. Proporcione el InstanceId que corresponda a la instancia que se ha replicado.

      2. Se devuelve una lista de ARN de flujo. Utilice estos ARN de flujo para asociar un flujo a un número de teléfono; llame a la AssociatePhoneNumberContactFlowAPI.

   2. En la instancia de Amazon Connect replicada en la otra AWS región, lleve a cabo los siguientes pasos:

      1. Llame a la ListContactFlowsAPI. Proporcione el InstanceId que corresponda a la instancia que se ha replicado.

      2. Se devuelve una lista de ARN de flujo. Utilice estos ARN de flujo para asociar un flujo a un número de teléfono; llame a la AssociatePhoneNumberContactFlowAPI.

Por qué falla una ClaimPhoneNumber llamada

ClaimPhoneNumberLa llamada a la API fallará con un ResourceNotFoundException en los siguientes casos:

• El grupo de distribución de tráfico especificado no existe, el estado del grupo de distribución de tráfico no es ACTIVE o usted no tiene la propiedad del grupo de distribución de tráfico.

• El número de teléfono no está disponible para realizar una solicitud. En algunos casos, un número de teléfono encontrado SearchAvailablePhoneNumberspuede haber sido reclamado por otro cliente.

ClaimPhoneNumberfallará y se producirá un InvalidParameterException error en el siguiente caso:

• El punto de conexión al que llama no se encuentra en la misma región en la que se creó el grupo de distribución de tráfico.

Definición de los estados de número de teléfono

A continuación, se describen los estados de número de teléfono:

• CLAIMEDsignifica que la operación anterior ClaimPhoneNumbero la UpdatePhoneNumberoperación se realizó correctamente.

• IN_PROGRESSsignifica que ClaimPhoneNumber, UpdatePhoneNumberla operación aún está en curso y aún no se ha completado. Puede llamar DescribePhoneNumbermás adelante para comprobar si la operación anterior se ha completado.

• FAILEDindica que la UpdatePhoneNumberoperación ClaimPhoneNumbero operación anterior ha fallado. Incluye un mensaje que indica el motivo del error.

  Un motivo habitual de error es que el valor de TargetArn del que está solicitando o actualizando un número de teléfono haya alcanzado su límite de números totales solicitados.

  Si ha recibido un estado FAILED de una llamada a la API ClaimPhoneNumber, dispone de un día para volver a intentar solicitar el número de teléfono antes de que el número se devuelva al inventario para que otros clientes lo soliciten.