Uso de EventBridge las notificaciones de Amazon

Amazon Chime SDK Call Analytics permite enviar eventos al EventBridge bus predeterminado cuando cambia el estado de la canalización de información de los medios o cuando se cumplen las condiciones de alerta en tiempo real de la analítica de llamadas. Para actualizar el estado de los errores de Media Insights Pipeline, le recomendamos que configure un EventBridge objetivo para que le notifique si sus recursos fallan de forma asíncrona. Las notificaciones de análisis de llamadas tienen una fuente de aws.chime y varios tipos de detalles, que se muestran en las siguientes secciones. Para obtener más información, consulta la Guía del EventBridge usuario de Amazon.

Actualizaciones de estado

Los canales de información multimedia envían EventBridge notificaciones a medida que avanza una sesión de análisis de llamadas y finaliza correctamente o detecta errores. Recibirás una EventBridge notificación con el tipo de detalle «Media Insights State Change» cuando:

• Cambia el estado de una canalización de información multimedia.

• Cambia el estado de un elemento del canalización de información multimedia.

• Se detiene cualquier elemento de la canalización.

• Falla cualquier elemento de la canalización.

La sección de detalles siempre incluye los siguientes campos:

• version

• mediaInsightsPipelineArn

• eventType

La sección de detalles también incluye un campo mediaInsightsPipelineElementStatuses si la canalización de información multimedia contiene varios elementos, como procesadores de análisis y receptores de datos. Este campo indica los estados de cada elemento de la canalización. El estado posible de cada elemento de la canalización podría ser:

• NotStarted

• InProgress

• Stopped

• Failed

La sección de detalles también incluye los pares clave-valor especificados durante el MediaInsightsRuntimeMetadata CreateMediaInsightsPipelineAPIllamada. Si un Voice Connector inició una sesión de análisis de llamadas, la sección de metadatos se rellena automáticamente con los siguientes parámetros:

• transactionId

• fromNumber

• toNumber

• callId

• voiceConnectorId

• direction

Los siguientes tipos de eventos pueden aparecer siempre que una canalización de información multimedia contenga un solo elemento. Amplíe cada sección para obtener más información.

Información SDK multimedia sobre Amazon Chime en progreso

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0",
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number,
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "resources": [] 
    "detail": {
        "version": "0",
        "mediaInsightsPipelineArn": "string",
        "eventType": "chime:MediaInsightsInProgress",
        "version": "0",
        "callId": "string",
        "transactionId": "string",
        "fromNumber": "string",
        "toNumber": "string",
        "voiceConnectorId": "string", 
        "direction": "string"
    }
}

La SDK información multimedia de Amazon Chime está en pausa

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0",
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number,
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "resources": [] 
    "detail": {
        "version": "0",
        "mediaInsightsPipelineArn": "string",
        "eventType": "chime:MediaInsightsPaused",
        "callId": "string",
        "transactionId": "string",
        "fromNumber": "string",
        "toNumber": "string",
        "voiceConnectorId": "string", 
        "direction": "string"
    }
}

Se detuvo la SDK información multimedia de Amazon Chime

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0",
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number,
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "resources": [] 
    "detail": {
        "version": "0",
        "mediaInsightsPipelineArn": "string",
        "eventType": "chime:MediaInsightsStopped",
        "callId": "string",
        "transactionId": "string",
        "fromNumber": "string",
        "toNumber": "string",
        "voiceConnectorId": "string", 
        "direction": "string"
    }
}

Fallo temporal de Amazon Chime SDK Media Insights

Indica que el servicio ha detectado un error temporal e intentará volver a intentarlo. No es necesario que realice ninguna acción.

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0",
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number,
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "resources": [] 
    "detail": {
        "version": "0",
        "mediaInsightsPipelineArn": "string",
        "eventType": "chime:MediaInsightsTemporaryFailure",
        "callId": "string",
        "transactionId": "string",
        "fromNumber": "string",
        "toNumber": "string",
        "voiceConnectorId": "string", 
        "direction": "string"
    }
}

Amazon Chime SDK Media Insights: un fracaso permanente

Indica un error que requiere que tome medidas. Utilice la failureReason para solucionar el problema. Los errores típicos pueden incluir los siguientes:

• Permisos insuficientes para el rol de acceso a recursos

• Recursos ausentes o eliminados

• Limitarse desde un AWS servicio que invoca el análisis en su nombre, como Amazon Transcribe o Amazon Kinesis.

• Formatos multimedia incompatibles en las transmisiones KVS

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0",
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number,
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "resources": [] 
    "detail": {
        "version": "0",
        "mediaInsightsPipelineArn": "string",
        "eventType": "chime:MediaInsightsPermanentFailure",
        "callId": "string",
        "transactionId": "string",
        "fromNumber": "string",
        "toNumber": "string",
        "voiceConnectorId": "string", 
        "direction": "string",
        "failureReason": "string"              
    }
}

nota

El campo failureReason es opcional. Por ejemplo, una razón típica podría ser Access denied when assuming resource access role.

Los siguientes tipos de eventos pueden aparecer siempre que se cree una canalización de información multimedia, o el intento de creación falle, para una sesión de análisis de llamadas iniciada por un conector de SDK voz de Amazon Chime. Amplíe cada sección para obtener más información.

Creación de SDK información multimedia sobre Amazon Chime

En este ejemplo se muestra un evento de éxito típico.

{
    "version": "0",
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number,
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "resources": [] 
    "detail": 
    {
        "version": "0",
        "mediaInsightsPipelineConfigurationArn": "string",
        "mediaInsightsPipelineArn": "string",
        "eventType": "chime:MediaInsightsCreated",
        "callId": "string",
        "transactionId": "string",
        "fromNumber": "string",
        "toNumber": "string",
        "voiceConnectorId": "string", 
        "direction": "string",
    }
}

La creación de información SDK multimedia de Amazon Chime falló

En este ejemplo, se muestra un evento de error típico.

{
    "version": "0",
    "id": "string",
    "detail-type": "Media Insights State Change",     
    "source": "aws.chime", 
    "account": number,
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "resources": [] 
    "detail": 
    {
        "version": "0",
        "mediaInsightsPipelineConfigurationArn": "string",
        "eventType": "chime:MediaInsightsCreateFailed", 
        "callId": "string",
        "transactionId": "string",
        "fromNumber": "string",
        "toNumber": "string",
        "voiceConnectorId": "string", 
        "direction": "string",
        "failureOrigin": "Voice Connector",
        "httpStatusCode": "string",
        "failureReason": "string"
    }
}

Los siguientes tipos de eventos pueden aparecer cuando una canalización de información multimedia contiene varios elementos. Las notificaciones de ejemplo son para el AmazonTranscribeProcessor en combinación con el S3RecordingSink. Amplíe cada sección para obtener más información.

AmazonTranscribeProcessor está en progreso y S3 no RecordingSink se ha iniciado

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0", 
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number, 
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": [],
    "detail": {
        "version": "0", 
        "mediaInsightsPipelineArn": "string", 
        "eventType": "chime:MediaInsightsInProgress",
        "mediaInsightsPipelineElementStatuses": [
            { 
                "type": "AmazonTranscribeProcessor", 
                "status": "InProgress",
                "updatedOn": 1686184070655             
            },
            { 
                "type": "S3RecordingSink", 
                "status": "NotStarted",
                "updatedOn": 1686184070655 
            }
        ] 
        "callId": "string", 
        "transactionId": "string", 
        "fromNumber": "string", 
        "toNumber": "string", 
        "voiceConnectorId": "string", 
        "direction": "string" 
    } 
}

AmazonTranscribeProcessor ha tenido éxito y el S3 RecordingSink está en curso

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0", 
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number, 
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": [],
    "detail": {
        "version": "0", 
        "mediaInsightsPipelineArn": "string", 
        "eventType": "chime:MediaInsightsInProgress",
        "mediaInsightsPipelineElementStatuses": [
            { 
                "type": "AmazonTranscribeProcessor", 
                "status": "Stopped",
                "updatedOn": 1686184070655             
            },
            { 
                "type": "S3RecordingSink", 
                "status": "InProgress",
                "updatedOn": 1686184070655 
            }
        ] 
        "callId": "string", 
        "transactionId": "string", 
        "fromNumber": "string", 
        "toNumber": "string", 
        "voiceConnectorId": "string", 
        "direction": "string" 
    } 
}

AmazonTranscribeProcessor ha fallado y S3 RecordingSink está en curso

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0", 
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number, 
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": [],
    "detail": {
        "version": "0", 
        "mediaInsightsPipelineArn": "string", 
        "eventType": "chime:MediaInsightsInProgress",
        "mediaInsightsPipelineElementStatuses": [
            { 
                "type": "AmazonTranscribeProcessor", 
                "status": "Failed",
                "updatedOn": 1686184070655             
            },
            { 
                "type": "S3RecordingSink", 
                "status": "InProgress",
                "updatedOn": 1686184070655 
            }
        ] 
        "callId": "string", 
        "transactionId": "string", 
        "fromNumber": "string", 
        "toNumber": "string", 
        "voiceConnectorId": "string", 
        "direction": "string" 
    } 
}

AmazonTranscribeProcessor ha fallado y S3 RecordingSink ha tenido éxito

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0", 
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number, 
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": [],
    "detail": {
        "version": "0", 
        "mediaInsightsPipelineArn": "string", 
        "eventType": "chime:MediaInsightsPermanentFailure",
        "mediaInsightsPipelineElementStatuses": [
            { 
                "type": "AmazonTranscribeProcessor", 
                "status": "Failed",
                "updatedOn": 1686184070655             
            },
            { 
                "type": "S3RecordingSink", 
                "status": "Stopped",
                "updatedOn": 1686184070655 
            }
        ] 
        "callId": "string", 
        "transactionId": "string", 
        "fromNumber": "string", 
        "toNumber": "string", 
        "voiceConnectorId": "string", 
        "direction": "string",
        "failureReason": "string" 
    } 
}

AmazonTranscribeProcessor ha tenido éxito y S3 RecordingSink ha fallado

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0", 
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number, 
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": [],
    "detail": {
        "version": "0", 
        "mediaInsightsPipelineArn": "string", 
        "eventType": "chime:MediaInsightsPermanentFailure",
        "mediaInsightsPipelineElementStatuses": [
            { 
                "type": "AmazonTranscribeProcessor", 
                "status": "Stopped",
                "updatedOn": 1686184070655             
            },
            { 
                "type": "S3RecordingSink", 
                "status": "Failed",
                "updatedOn": 1686184070655 
            }
        ] 
        "callId": "string", 
        "transactionId": "string", 
        "fromNumber": "string", 
        "toNumber": "string", 
        "voiceConnectorId": "string", 
        "direction": "string",
        "failureReason": "string" 
    } 
}

AmazonTranscribeProcessor está en pausa y S3 no RecordingSink se ha iniciado

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0", 
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number, 
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": [],
    "detail": {
        "version": "0", 
        "mediaInsightsPipelineArn": "string", 
        "eventType": "chime:MediaInsightsPaused",
        "mediaInsightsPipelineElementStatuses": [
            { 
                "type": "AmazonTranscribeProcessor", 
                "status": "Paused",
                "updatedOn": 1686184070655             
            },
            { 
                "type": "S3RecordingSink", 
                "status": "NotStarted",
                "updatedOn": 1686184070655 
            }
        ] 
        "callId": "string", 
        "transactionId": "string", 
        "fromNumber": "string", 
        "toNumber": "string", 
        "voiceConnectorId": "string", 
        "direction": "string" 
    } 
}

AmazonTranscribeProcessor ha fallado temporalmente y S3 no RecordingSink se ha iniciado

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0", 
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number, 
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": [],
    "detail": {
        "version": "0", 
        "mediaInsightsPipelineArn": "string", 
        "eventType": "chime:MediaInsightsTemporaryFailure",
        "mediaInsightsPipelineElementStatuses": [
            { 
                "type": "AmazonTranscribeProcessor", 
                "status": "TemporarilyFailed",
                "updatedOn": 1686184070655             
            },
            { 
                "type": "S3RecordingSink", 
                "status": "NotStarted",
                "updatedOn": 1686184070655 
            }
        ] 
        "callId": "string", 
        "transactionId": "string", 
        "fromNumber": "string", 
        "toNumber": "string", 
        "voiceConnectorId": "string", 
        "direction": "string" 
    } 
}

AmazonTranscribeProcessor y S3 RecordingSink lo consiguió

Este ejemplo muestra una estructura de eventos típica.

{
    "version": "0", 
    "id": "string",
    "detail-type": "Media Insights State Change", 
    "source": "aws.chime", 
    "account": number, 
    "region": "string",
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": [],
    "detail": {
        "version": "0", 
        "mediaInsightsPipelineArn": "string", 
        "eventType": "chime:MediaInsightsStopped",
        "mediaInsightsPipelineElementStatuses": [
            { 
                "type": "AmazonTranscribeProcessor", 
                "status": "Stopped",
                "updatedOn": 1686184070655             
            },
            { 
                "type": "S3RecordingSink", 
                "status": "Stopped",
                "updatedOn": 1686184070655 
            }
        ] 
        "callId": "string", 
        "transactionId": "string", 
        "fromNumber": "string", 
        "toNumber": "string", 
        "voiceConnectorId": "string", 
        "direction": "string" 
    } 
}

S3 RecordingSink tuvo éxito y VoiceEnhancement está en progreso

Este ejemplo muestra una estructura de eventos típica.

{
  "version": "0",
  "id": "string",
  "detail-type": "Media Insights State Change",
  "source": "aws.chime",
  "account": number,
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "region": "string",
  "detail": {
    "mediaInsightsPipelineArn": "string",
    "eventType": "chime:MediaInsightsInProgress",
    "version": "0",
    "mediaInsightsPipelineElementStatuses": [
      {
        "type": "VoiceEnhancementSink",
        "status": "InProgress",
        "updatedOn": 1686184070655
      },
      {
        "type": "S3RecordingSink",
        "status": "Stopped",
        "updatedOn": 1686184070655
      }
    ]
  }
}

S3 RecordingSink tuvo éxito y VoiceEnhancement falló debido a llamadas de más de 30 minutos

Este ejemplo muestra una estructura de eventos típica.

{
  "version": "0",
  "id": "string",
  "detail-type": "Media Insights State Change",
  "source": "aws.chime",
  "account": number,
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "region": "string",
  "detail": {
    "mediaInsightsPipelineArn": "string",
    "eventType": "chime:MediaInsightsStopped",
    "version": "0",
    "mediaInsightsPipelineElementStatuses": [
      {
        "type": "VoiceEnhancement",
        "status": "NotSupported",
        "updatedOn": 1686184070655,
        "statusDetail": "Unsupported recording length"
      },
      {
        "type": "S3RecordingSink",
        "status": "Stopped",
        "updatedOn": 1686184070655
      }
    ]
  }
} 

S3 RecordingSink tuvo éxito y VoiceEnhancement falló debido a que las llamadas duraron menos de 30 minutos

Este ejemplo muestra una estructura de eventos típica.

{
  "version": "0",
  "id": "string",
  "detail-type": "Media Insights State Change",
  "source": "aws.chime",
  "account": number,
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "region": "string",
  "detail": {
    "mediaInsightsPipelineArn": "string",
    "eventType": "chime:MediaInsightsPermanentFailure",
    "version": "0",
    "mediaInsightsPipelineElementStatuses": [
      {
        "type": "VoiceEnhancement",
        "status": "Failed",
        "updatedOn": 1686184070655
      },
      {
        "type": "S3RecordingSink",
        "status": "Stopped",
        "updatedOn": 1686184070655
      }
    ]
  }
}

Alertas en tiempo real

nota

Solo los procesadores Amazon Transcribe y de análisis de llamadas con Amazon Transcribe admiten alertas en tiempo real.

El análisis de SDK llamadas de Amazon Chime permite a los desarrolladores configurar reglas para enviar alertas en tiempo real a través de un procesador durante una sesión de análisis. Las alertas se envían a Amazon EventBridge con el tipo de detalleMedia Insights Rules Matched. EventBridge admite la integración con servicios descendentes como Lambda, Amazon y SQS SNS Amazon para activar notificaciones para el usuario final o iniciar otra lógica empresarial personalizada.

Las alertas en tiempo real se configuran como parte del campo RealTimeAlertConfiguration para la MediaInsightsPipelineConfiguration. Puede usar la SDK consola Amazon Chime para configurar el campo o puede llamar al CreateMediaInsightsPipelineConfiguration o UpdateMediaInsightsPipelineConfiguration APIs.

En este ejemplo, se muestra cómo crear o actualizar una configuración de alertas en tiempo real mediante. API

{
    "MediaInsightsPipelineConfigurationName": "config_name",
    "ResourceAccessRoleArn": "arn:aws:iam::account_id:role/role_name",
    "RealTimeAlertConfiguration": {
        "Disabled": false,
        "Rules": [{
                "Type": "KeywordMatch",
                "KeywordMatchConfiguration": {
                    "RuleName": "rule_name_1",
                    "Keywords": [
                        "hello",
                        "thank you"
                    ],
                    "Negate": false
                }
            },
            {
                "Type": "Sentiment",
                "RuleName": "rule_name_2",
                "SentimentType": "NEGATIVE",
                "TimePeriod": 60
            },
            {
                "Type": "IssueDetection",
                "RuleName": "rule_name_3"
            }
        ]
    },
    "Elements": [{
            "Type": "AmazonTranscribeCallAnalyticsProcessor",
            "AmazonTranscribeCallAnalyticsProcessorConfiguration": {
                "LanguageCode": "en-US"
            }
        },
        {
            "Type": "KinesisDataStreamSink",
            "KinesisDataStreamSinkConfiguration": {
                "InsightsTarget": "arn:aws:kinesis:us-east-1:account_id:stream/stream_name"
            }
        }
    ]
}

Cada regla de una configuración de alertas en tiempo real se activa de forma independiente. Puede recibir varias EventBridge notificaciones si se cumplen varias condiciones de la regla al mismo tiempo. Para crear una lista de reglas para sus alertas, puede seleccionar uno de los siguientes tipos de reglas:

Coincidencia de palabra clave

Alerta cuando un conjunto específico de palabras clave o frases coincide en un evento de enunciado o transcripción. Puede configurar la alerta para que emita un evento si:

• Todas las palabras clave especificadas se pronuncian y Negate se configura como false.

• Todas las palabras clave especificadas no se pronuncian durante toda la llamada, si Negate se establece como true.

Amazon Transcribe y Amazon Transcribe Analytics admiten este tipo de regla.

Análisis de opiniones

Avisa cuando un tipo de sentimiento en particular está en curso durante un período de tiempo continuo. Solo Transcribe Call Analytics admite esta regla.

Detección de problema

Alerta cuando se detecta un problema en un evento de enunciado. Solo Transcribe Call Analytics admite este tipo de regla.

En el siguiente ejemplo se muestra un evento de alerta en tiempo real para una regla de KeywordMatch.

{
    "version": "0",
    "id": "string",
    "detail-type": "Media Insights Rules Matched", 
    "source": "aws.chime", 
    "account": number,
    "region": "us-east-1",
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": [],
    "detail":   {
        "version": "0",
        "sourceMetadata": {}
        "ruleName": "string"
        "utteranceId": "string",
        "beginTimestamp": "yyyy-mm-ddThh:mm:ssZ",
    }
}

Algunos EventBridge campos son específicos del tipo de regla que coincide:

Campos de coincidencia de palabras clave

utteranceId: ID de la transcripción que contiene una palabra clave coincidente si utiliza el análisis de llamadas con Amazon Transcribe. Solo para la coincidencia de palabras clave pronunciadas.

resultId: ID de la transcripción que contiene una palabra clave coincidente si utiliza Amazon Transcribe. Solo para la coincidencia de palabras clave pronunciadas.

beginTimestamp: Hora de inicio de la transcripción que contiene una palabra clave coincidente. Solo para la coincidencia de palabras clave pronunciadas.

Campos de análisis de sentimiento

beginTimestamp: Hora de inicio de la ventana móvil del sentimiento coincidente.

endTimestamp: Hora de finalización de la ventana variable del sentimiento coincidente.