Automatizando o Amazon Chime com EventBridge - Amazon Chime
Automatizando os conectores de voz do Amazon Chime com EventBridgeEventos de streaming do Amazon Chime Voice Connector

Aviso de fim do suporte: em 20 de fevereiro de 2026, AWS encerrará o suporte para o serviço Amazon Chime. Depois de 20 de fevereiro de 2026, você não poderá mais acessar o console do Amazon Chime ou os recursos do aplicativo Amazon Chime. Para obter mais informações, acesse a postagem do blog. Nota: Isso não afeta a disponibilidade do serviço Amazon Chime SDK.

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 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 Meeting events no Guia do desenvolvedor do Amazon Chime.

Quando o Amazon Chime gera eventos, ele os envia EventBridge para a melhor entrega, o que significa que o Amazon Chime tenta enviar todos os eventos EventBridge para, 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 os conectores de voz do Amazon Chime com EventBridge

As ações que podem ser automaticamente acionadas para os Amazon Chime Voice Connectors incluem as seguintes:

  • 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 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 Voice Connector

Os Amazon Chime Voice Connectors oferecem suporte ao envio de eventos para EventBridge quando os eventos discutidos nesta seção ocorrerem.

Os Amazon Chime Voice Connectors enviam esse evento quando o streaming de mídia para o Kinesis Video Streams se inicia.

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@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",
        "streamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333",
        "toNumber": "+13605550199",
        "transactionId": "12345678-1234-1234",
        "voiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "streamingStatus": "STARTED",
        "version": "0"
    }
}

Os Amazon Chime Voice Connectors 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 Amazon Chime Voice Connectors 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 Amazon Chime Voice Connectors 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"
  }
}