Salta al contenuto
Usando AWS re:Post, accetti AWS re:Post Termini di utilizzo
AWS re:Postre:Post
Informazioni su re:Post

Come posso configurare la registrazione dei messaggi vocali del sistema di messaggistica per utenti finali AWS SMS con Amazon Pinpoint?

7 minuti di lettura
0

Desidero registrare lo stato dei messaggi vocali che invio tramite Amazon Pinpoint.

Risoluzione

Per registrare lo stato dei messaggi vocali di Amazon Pinpoint, crea un set di configurazione e una destinazione dell'evento. Quindi mappa la destinazione dell'evento sul set di configurazione. Utilizza la configurazione per ricevere informazioni di risposta per i messaggi vocali inviati tramite Amazon Pinpoint.

Puoi configurare le seguenti risorse AWS come destinazioni di eventi vocali Amazon Pinpoint:

Per configurare la destinazione di un evento, utilizza le API del sistema di messaggistica per utenti finali AWS SMS o uno degli AWS SDK.

Nota: la seguente configurazione di registrazione dei messaggi vocali si applica solo al sistema di messaggistica per utenti finali AWS SMS. Per SMS and Voice v1, consulta Come si configura la registrazione per i messaggi vocali Amazon Pinpoint per l'API di messaggistica vocale e SMS di Amazon Pinpoint v1?

Configura un topic Amazon SNS come destinazione degli eventi vocali di Amazon Pinpoint

Nota: se ricevi errori quando esegui i comandi dell'Interfaccia della linea di comando AWS (AWS CLI), consulta Risoluzione degli errori per AWS CLI. Inoltre, assicurati di utilizzare la versione più recente di AWS CLI.

Completa i seguenti passaggi:

  1. Per creare un set di configurazione, esegui il comando create-configuration-set:

    aws pinpoint-sms-voice-v2 create-configuration-set --configuration-set-name VoiceSNS

    Nota: sostituisci VoiceSNS con il nome del tuo set di configurazione.

  2. Effettua la sottoscrizione per l'endpoint su cui desideri registrare i messaggi vocali a un topic Amazon SNS. Il topic SNS può essere un topic nuovo o esistente.

  3. Aggiungi le seguenti autorizzazioni alla policy di accesso ai topic SNS per consentire al servizio vocale del sistema di messaggistica per utenti finali AWS SMS di fornire log:

    {
  "Effect": "Allow",
  "Principal": {
    "Service": "sms-voice.amazonaws.com"
  },
  "Action": "sns:Publish",
  "Resource": "arn:aws:sns:us-east-1:ACCOUNT_ID:pinpointsmsvoice",
  "Condition": {
    "StringEquals": {
      "aws:SourceAccount": "ACCOUNT_ID"
    },
    "ArnLike": {
      "aws:SourceArn": "arn:aws:sms-voice:us-east-1:ACCOUNT_ID:configuration-set/VoiceSNS"
    }
  }
}

    Nota: sostituisci us-east-1 con la tua Regione AWS, pinpointsmsvoice con il nome del tuo topic SNS e ACCOUNT_ID con l'ID del tuo account AWS.

  4. In un editor di testo, crea un file di richiesta di input denominato matching.json per MatchingEventTypes. Specifica gli eventi che desideri ricevere o specifica "ALL" per ricevere tutti gli eventi:

    [
"ALL"
]

  5. Per mappare la destinazione dell'evento su configuration-set-name, esegui il comando create-event-destination:

    aws pinpoint-sms-voice-v2 create-event-destination --configuration-set-name VoiceSNS --event-destination-name VoiceSNS --matching-event-types file://matching.json --sns-destination TopicArn=arn:aws:sns:us-east-1:ACCOUNT_ID:pinpointsmsvoice

    Nota: sostituisci us-east-1 con la tua Regione, ACCOUNT_ID con l'ID del tuo account e pinpointsmsvoice con il nome del tuo topic SNS.

  6. Per verificare la configurazione, invia un messaggio vocale di Amazon Pinpoint utilizzando l'operazione API V2 SendVoiceMessage. L'evento viene visualizzato dopo alcuni minuti nell'endpoint per cui è stato sottoscritto il topic SNS.

Configura CloudWatch Logs come destinazione degli eventi vocali di Amazon Pinpoint

Completa i seguenti passaggi:

  1. Per creare un set di configurazione, esegui il comando create-configuration-set:

    aws pinpoint-sms-voice-v2 create-configuration-set --configuration-set-name VoiceCW

    Nota: sostituisci VoiceCW con il nome del tuo set di configurazione.

  2. Per creare un gruppo di log, esegui il comando create-log-group:

    aws logs create-log-group --log-group-name /aws/pinpoint/voice

    Nota: sostituisci log-group-name con il nome del tuo gruppo di log. Nell'output del comando, annota il nome della risorsa Amazon (ARN) del gruppo di log da utilizzare in una fase successiva. Se stai utilizzando un gruppo di log esistente, chiama l'operazione API LogGroup per ottenere l'ARN.

  3. Crea un nuovo ruolo AWS Identity and Access Management (AWS IAM) da far assumere al servizio Amazon Pinpoint.

  4. Aggiorna la policy di attendibilità del ruolo IAM con la seguente istruzione per consentire al servizio vocale SMS di assumere il ruolo IAM:

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "sms-voice.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "ACCOUNT_ID"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:sms-voice:us-east-1:ACCOUNT_ID:configuration-set/VoiceCW"
        }
      }
    }
  ]
}

    Nota: sostituisci us-east-1 con la tua Regione, ACCOUNT_ID con l'ID del tuo account e VoiceCW con il tuo set di configurazione.

  5. Aggiorna la policy delle autorizzazioni del ruolo IAM con la seguente istruzione:

    {    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogStream",
                "logs:DescribeLogStreams",
                "logs:PutLogEvents"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:ACCOUNT_ID:log-group:/aws/pinpoint/voice:*"
            ]
        }
    ]
}

    Nota: sostituisci us-east-1 con la tua Regione e ACCOUNT_ID con l'ID del tuo account. La policy precedente concede le autorizzazioni per chiamare specifiche operazioni API di CloudWatch Logs. Per ulteriori informazioni, consulta Riferimento alle autorizzazioni di CloudWatch Logs.

  6. In un editor di testo, crea un file di richiesta di input denominato CloudWatchDestination.json. Quindi inserisci i seguenti parametri di destinazione nel file:

    `{   "IamRoleArn": "arn:aws:iam::ACCOUNT_ID:role/IAM_ROLE",   "LogGroupArn": "arn:aws:logs:us-east-1:ACCOUNT_ID:log-group:/aws/pinpoint/voice" }`

    Nota: sostituisci il valore IamRoleArn con l’ARN del tuo ruolo IAM. Sostituisci il valore LogGroupArn con l'ARN del gruppo di log di CloudWatch a cui desideri inviare gli eventi.

  7. In un editor di testo, crea un file di richiesta di input denominato matching.json per MatchingEventTypes. Specifica gli eventi che desideri ricevere o specifica "ALL" per ricevere tutti gli eventi:

    [
"ALL"
]

  8. Esegui il comando create-event-destination per mappare la destinazione dell'evento su configuration-set-name:

    aws pinpoint-sms-voice-v2 create-event-destination --configuration-set-name VoiceCW --event-destination-name CloudWatch_Destination --matching-event-types file://matching.json --cloud-watch-logs-destination file://CloudWatchDestination.json

    Nota: sostituisci VoiceCW con il nome del tuo set di configurazione.

  9. Per verificare la configurazione, invia un messaggio vocale di Amazon Pinpoint utilizzando l'operazione API V2 SendVoiceMessage. L'evento viene visualizzato dopo alcuni minuti nel gruppo di log di CloudWatch.

Configura un flusso di distribuzione Firehose come destinazione degli eventi vocali di Amazon Pinpoint

Completa i seguenti passaggi:

  1. Per creare un set di configurazione, esegui il comando create-configuration-set:

    aws pinpoint-sms-voice-v2 create-configuration-set --configuration-set-name VoiceKinesis

    Nota: sostituisci VoiceKinesis con il nome del tuo set di configurazione.

  2. Crea un flusso di distribuzione Firehose e annotane l'ARN. Per Destination setting (Impostazione della destinazione), scegli Amazon Simple Storage Service (Amazon S3).

  3. Crea un nuovo ruolo IAM da far assumere al servizio Amazon Pinpoint.

  4. Aggiorna la policy di attendibilità del ruolo IAM con la seguente istruzione di autorizzazione nella sezione principale della policy:

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "sms-voice.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "ACCOUNT_ID"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:sms-voice:us-east-1:ACCOUNT_ID:configuration-set/VoiceKinesis"
        }
      }
    }
  ]
}

    Nota: sostituisci us-east-1 con la tua Regione e ACCOUNT_ID con l'ID del tuo account. La policy precedente consente al servizio vocale SMS di assumere il ruolo IAM.

  5. Aggiorna la policy delle autorizzazioni del ruolo IAM per includere l'ARN del flusso di distribuzione Firehose:

    {    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "firehose:PutRecord",
            "Resource": "arn:aws:firehose:us-east-1:ACCOUNT_ID:deliverystream/KINESIS_FIREHOSE_NAME"
        }
    ]
}

    Nota: sostituisci ACCOUNT_ID con l'ID del tuo account e KINESIS_FIREHOSE_NAME con il nome dell'ARN del tuo flusso di distribuzione Firehose.

  6. In un editor di testo, crea un file di richiesta di input denominato KinesisFirehoseDestination.json. Quindi copia e incolla i seguenti parametri di destinazione nel file:

    {    "IamRoleArn": "arn:aws:iam::ACCOUNT_ID:role/IAM_ROLE",
    "DeliveryStreamArn": "arn:aws:firehose:us-east-1:ACCOUNT_ID:deliverystream/KINESIS_FIREHOSE_NAME"
}

    Nota: sostituisci us-east-1 con la tua Regione, ACCOUNT_ID con l'ID del tuo account, KINESIS_FIREHOSE_NAME con il nome del tuo flusso di distribuzione Firehose e IAM_ROLE con il nome del tuo ruolo IAM.

  7. In un editor di testo, crea un file di richiesta di input denominato matching.json per MatchingEventTypes. Specifica gli eventi che desideri ricevere o specifica "ALL" per ricevere tutti gli eventi:

    [
"ALL"
]

  8. Per mappare la destinazione dell'evento su configuration-set-name, esegui il comando create-event-destination con un file di richiesta di input:

    aws pinpoint-sms-voice-v2 create-event-destination --configuration-set-name VoiceKinesis --event-destination-name KinesisFirehose_Destination --matching-event-types file://matching.json --kinesis-firehose-destination file://KinesisFirehoseDestination.json

    Nota: sostituisci VoiceKinesis con il nome del tuo set di configurazione.

  9. Per verificare la configurazione, invia un messaggio vocale di Amazon Pinpoint utilizzando l'operazione API V2 SendVoiceMessage. L'evento viene visualizzato dopo alcuni minuti nel bucket Amazon S3 che hai configurato quando hai creato il flusso di distribuzione Firehose.

Argomenti
Front-End Web & MobileBusiness Applications
Tag
Amazon Pinpoint
Lingua
Italiano
AWS UFFICIALEAggiornata 6 mesi fa

Contenuto pertinente