View a markdown version of this page

Asigne números de teléfono reclamados a grupos de distribución de tráfico en Connect Customer - Amazon Connect Customer

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Asigne números de teléfono reclamados a grupos de distribución de tráfico en Connect Customer

  • Ha creado un nuevo grupo de distribución de tráfico y su estado es ACTIVE. Recomendamos usar la DescribeTrafficDistributionGroupAPI para verificar el estado.

  • Ya ha solicitado números de teléfono a instancias u otros grupos de distribución de tráfico.

Ahora puedes asignar esos números de teléfono reclamados a tu nuevo grupo de distribución de tráfico mediante la UpdatePhoneNumberAPI. Proporcione el ARN de grupo de distribución de tráfico en el parámetro TargetArn.

nota

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

Ejemplo de flujo de trabajo

A continuación, se muestra un flujo de trabajo de ejemplo para asignar números de teléfono solicitados a su grupo de distribución de tráfico:

  1. Llame a la UpdatePhoneNumberAPI para asignar el número de teléfono a uno nuevoTargetArn.

    TargetArnPuede ser para otra instancia de Connect Customer o para un grupo de distribución de tráfico creado en la misma región en la que se reclamó inicialmente el número de teléfono.

  2. Realice los siguientes pasos para asociar flujos a números de teléfono.

    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 Connect Customer existente en la región en la que se creó el grupo de distribución de tráfico, lleve a cabo los siguientes pasos:

      1. Llame a la API ListContactFlows. 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.

    La asociación entre AWS el número de teléfono y el flujo se reflejará entre las instancias de Connect Customer de todas las regiones.

Por qué se produce un error en una llamada AssociatePhoneNumberContactFlow

Si el número se reclama a un grupo de distribución de tráfico y llamas AssociatePhoneNumberContactFlowmediante una instancia en la que se creó el Región de AWS grupo de distribución de tráfico, puedes usar un número de teléfono completo (ARN) o un valor UUID para el parámetro de solicitud de PhoneNumberId URI.

Sin embargo, si el número se reclama a un grupo de distribución de tráfico y llamas a esta API mediante una instancia de la réplica Región de AWS asociada al grupo de distribución de tráfico, debes proporcionar un número de teléfono completo (ARN). Si se proporciona un UUID en este escenario, recibirá un ResourceNotFoundException.

¿Por qué falla una UpdatePhoneNumber llamada?

UpdatePhoneNumberLa 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.

UpdatePhoneNumberfallará 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.