Reclama números de teléfono a grupos de distribución de tráfico mediante Amazon Connect - Amazon Connect
Ejemplo de flujo de trabajoPor qué falla una ClaimPhoneNumber llamadaDefinición de los estados de número de teléfono

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.

Reclama números de teléfono a grupos de distribución de tráfico mediante Amazon Connect

nota

¿Usuario nuevo? Consulta el taller sobre resiliencia global de Amazon Connect. Este curso en línea lo guía a través del proceso de incorporación y prueba de la conmutación por error del número de teléfono y el agente utilizando nuevos APIs a través del. AWS CLI

La resiliencia global 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 su grupo de distribución de tráfico, le recomendamos que lo utilice DescribeTrafficDistributionGroupAPIpara 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 asignar un número de teléfono a un grupo de distribución de tráfico, indique el grupo de distribución de tráfico ARN en el TargetArnparámetro al llamar al ClaimPhoneNumberAPI. También puedes usar el UpdatePhoneNumberAPIpara 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. Llama al ReplicateInstanceAPI.

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

    1. Llama al CreateTrafficDistributionGroupAPI.

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

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

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

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

    2. Proporcione el valor del número de teléfono E164 que devolvió la SearchAvailablePhoneNumbersAPIllamada 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 al. DescribePhoneNumberAPI

      (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. Llama ListContactFlowsAPI. Proporcione el InstanceId que corresponda a la instancia que se ha replicado.

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

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

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

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

Por qué falla una ClaimPhoneNumber llamada

La ClaimPhoneNumberAPIllamada 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 has recibido el FAILED estado de una ClaimPhoneNumber API llamada, dispones de un día para volver a intentar reclamar el número de teléfono antes de que el número vuelva a figurar en el inventario para que lo reclamen otros clientes.