Automatizando o Amazon Chime SDK com EventBridge - SDK do Amazon Chime

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Automatizando o Amazon Chime SDK com EventBridge

A Amazon EventBridge permite que você automatize seus AWS serviços e responda automaticamente a eventos do sistema, como problemas de disponibilidade de aplicativos ou alterações de recursos. Para obter mais informações sobre os eventos da reunião, consulte Eventos de reunião no Guia do desenvolvedor do Amazon Chime SDK.

Quando o Amazon Chime SDK gera eventos, ele os envia EventBridge para a melhor entrega possível, o que significa que o Amazon Chime SDK tenta enviar todos os eventos para EventBridge, mas em casos raros, um evento pode não ser entregue. Para obter mais informações, consulte Eventos de AWS serviços no Guia do EventBridge usuário da Amazon.

nota

Se você precisar criptografar dados, deverá usar as chaves gerenciadas pelo Amazon S3. Não oferecemos suporte à criptografia do lado do servidor usando chaves mestras do cliente armazenadas no serviço de gerenciamento de AWS chaves.

Automatizando conectores de voz do Amazon Chime SDK com EventBridge

As ações que podem ser acionadas automaticamente para os conectores de voz do Amazon Chime SDK incluem o seguinte:

  • Invocando uma função AWS Lambda

  • Liberar uma tarefa do Amazon Elastic Container Service

  • Retransmitir o evento para o Amazon Kinesis Video Streams

  • Ativando uma máquina de AWS Step Functions estado

  • Notificar um tópico do Amazon SNS ou uma fila do Amazon SQS

Alguns exemplos de uso EventBridge com os conectores de voz do Amazon Chime SDK incluem:

  • Ativar uma função do Lambda para fazer download do áudio de uma chamada depois que ela é encerrada.

  • Executar uma tarefa do Amazon ECS para habilitar a transcrição em tempo real depois que uma chamada é iniciada.

Para obter mais informações, consulte o Guia EventBridge do usuário da Amazon.

Eventos de streaming do Amazon Chime SDK Voice Connector

Os conectores de voz do Amazon Chime SDK oferecem suporte ao envio de eventos para EventBridge quando os eventos discutidos nesta seção ocorrerem.

Os conectores de voz do Amazon Chime SDK enviam esse evento quando o streaming de mídia para o Kinesis Video Streams começa.

exemplo Dados de eventos

A seguir estão dados de exemplo para esse evento.

{ "version": "0", "id": "12345678-1234-1234-1234-111122223333", "detail-type": "Chime VoiceConnector Streaming Status", "source": "aws.chime", "account": "111122223333", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": [], "detail": { "callId": "1112-2222-4333", "direction": "Outbound", "fromNumber": "+12065550100", "inviteHeaders": { "from": "\"John\" <sip:+12065550100@10.24.34.0>;tag=abcdefg", "to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4M.voiceconnector.chime.aws:5060>", "call-id": "1112-2222-4333", "cseq": "101 INVITE", "contact": "<sip:user@10.24.34.0:6090>;", "content-type": "application/sdp", "content-length": "246" }, "isCaller": false, "mediaType": "audio/L16", "sdp": { "mediaIndex": 0, "mediaLabel": "1" }, "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>;\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>", "startFragmentNumber": "1234567899444", "startTime": "yyyy-mm-ddThh:mm:ssZ", "streamArn": "arn:aws:kinesisvideo:us-east-1:123456M:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333", "toNumber": "+13605550199", "transactionId": "12345678-1234-1234", "voiceConnectorId": "abcdef1ghij2klmno3pqr4", "streamingStatus": "STARTED", "version": "0" } }

Os conectores de voz do Amazon Chime SDK enviam esse evento quando o streaming de mídia para o Kinesis Video Streams termina.

exemplo Dados de eventos

A seguir estão dados de exemplo para esse evento.

{ "version": "0", "id": "12345678-1234-1234-1234-111122223333", "detail-type": "Chime VoiceConnector Streaming Status", "source": "aws.chime", "account": "111122223333", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": [], "detail": { "streamingStatus": "ENDED", "voiceConnectorId": "abcdef1ghij2klmno3pqr4", "transactionId": "12345678-1234-1234", "callId": "1112-2222-4333", "direction": "Inbound", "fromNumber": "+12065550100", "inviteHeaders": { "from": "\"John\" <sip:+12065550100@10.24.34.0>;tag=abcdefg", "to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws:5060>", "call-id": "1112-2222-4333", "cseq": "101 INVITE", "contact": "<sip:user@10.24.34.0:6090>", "content-type": "application/sdp", "content-length": "246" }, "isCaller": false, "mediaType": "audio/L16", "sdp": { "mediaIndex": 0, "mediaLabel": "1" }, "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>", "startFragmentNumber": "1234567899444", "startTime": "yyyy-mm-ddThh:mm:ssZ", "endTime": "yyyy-mm-ddThh:mm:ssZ", "streamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333", "toNumber": "+13605550199", "version": "0" } }

Os conectores de voz do Amazon Chime SDK enviam esse evento quando o streaming de mídia para o Kinesis Video Streams é atualizado.

exemplo Dados de eventos

A seguir estão dados de exemplo para esse evento.

{ "version": "0", "id": "12345678-1234-1234-1234-111122223333", "detail-type": "Chime VoiceConnector Streaming Status", "source": "aws.chime", "account": "111122223333", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": [], "detail": { "callId": "1112-2222-4333", "updateHeaders": { "from": "\"John\" <sip:+12065550100@10.24.34.0>;;tag=abcdefg", "to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws:5060>", "call-id": "1112-2222-4333", "cseq": "101 INVITE", "contact": "<sip:user@10.24.34.0:6090>", "content-type": "application/sdp", "content-length": "246" }, "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>", "streamingStatus": "UPDATED", "transactionId": "12345678-1234-1234", "version": "0", "voiceConnectorId": "abcdef1ghij2klmno3pqr4" } }

Os conectores de voz do Amazon Chime SDK enviam esse evento quando o streaming de mídia para o Kinesis Video Streams falha.

exemplo Dados de eventos

A seguir estão dados de exemplo para esse evento.

{ "version": "0", "id": "12345678-1234-1234-1234-111122223333", "detail-type": "Chime VoiceConnector Streaming Status", "source": "aws.chime", "account": "111122223333", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": [], "detail": { "streamingStatus":"FAILED", "voiceConnectorId":"abcdefghi", "transactionId":"12345678-1234-1234", "callId":"1112-2222-4333", "direction":"Inbound", "failTime":"yyyy-mm-ddThh:mm:ssZ", "failureReason": "Internal failure", "version":"0" } }