Como faço para configurar o registro em log para o AWS End User Messaging SMS?

Resolução

Para registrar o status das suas mensagens SMS, MMS e voz, defina um conjunto de configurações e o destino de evento. Em seguida, associe o destino de evento ao seu conjunto de configurações. Você recebe as informações de resposta das mensagens enviadas por meio do AWS End User Messaging SMS.

Crie um conjunto de configurações

Para criar um conjunto de configurações, conclua as seguintes etapas:

1. Abra o console do AWS End User Messaging SMS.
2. No painel de navegação, em Configurações, selecione Conjuntos de configurações.
3. Clique em Criar conjunto de configurações.
4. Em Nome do conjunto de configurações, insira um nome.
5. Clique em Criar conjunto de configurações.

Crie e associe o destino de evento ao conjunto de configurações

O conjunto de configurações oferece suporte a três tipos de destinos de eventos, como um grupo do Amazon CloudWatch, um fluxo do Amazon Data Firehose ou um tópico do Amazon Simple Notification Service (Amazon SNS). É possível enviar eventos de SMS, MMS e voz para esses destinos de eventos. Para obter mais informações, consulte Destinos de eventos em SMS de mensagens de usuário AWS final.

Configure o CloudWatch Logs como um destino de evento do AWS End User Messaging SMS

Para criar um destino de evento do CloudWatch, conclua as seguintes etapas:

1. Abra o console do AWS End User Messaging SMS.
2. Em Configurações, clique em Conjuntos de configurações.
3. Selecione o conjunto de configurações ao qual adicionar um destino de evento.
4. Clique em Adicionar destino de evento.
5. Em Detalhes do evento, em Nome do destino de evento, insira um nome.
6. Na lista suspensa Tipo de destino, clique em Amazon CloudWatch.
7. Em ARN do perfil do IAM, insira o ARN do perfil do AWS Identity and Access Management (AWS IAM).
   Observação: para obter mais informações, consulte Política de IAM para a Amazon CloudWatch.
8. Em ARN do grupo de logs, insira o ARN do grupo de logs do CloudWatch para o qual entregar os eventos. Para obter mais informações sobre como criar um grupo de logs do CloudWatch, consulte Crie um grupo de registros em CloudWatch Registros.
9. Clique em Publicação de eventos.
10. Em Tipos de eventos, selecione seu tipo de evento.
    Observação: é possível selecionar tipos específicos de eventos que deseja enviar para diferentes destinos de eventos. Por exemplo, é possível enviar todos os eventos relacionados à entrega para o Data Firehose para armazenamento. Ou é possível enviar todos os eventos de falha para um tópico do Amazon SNS para receber uma notificação quando eles ocorrerem.
    Importante: selecione TUDO para enviar todos os eventos de SMS, MMS e voz para o destino especificado.
11. Selecione Criar evento.

Para obter mais informações, consulte Exibir dados de registro enviados para o CloudWatch Logs e Configure um destino de CloudWatch evento da Amazon em AWS End User Messaging SMS.

Configure um stream de entrega do Firehose como um destino de evento do AWS End User Messaging SMS

Para criar um destino de evento do Firehose, conclua as seguintes etapas:

1. Abra o console do AWS End User Messaging SMS.
2. Em Configurações, clique em Conjuntos de configurações.
3. Selecione o conjunto de configurações ao qual adicionar um destino de evento.
4. Clique em Adicionar destino de evento.
5. Em Detalhes do evento, em Nome do destino de evento, insira um nome.
6. Na lista suspensa Tipo de destino, selecione Amazon Data Firehose.
7. Em ARN do perfil do IAM, insira o ARN do perfil do IAM.
   Observação: para obter mais informações, consulte Política de IAM para Amazon Data Firehose.
8. Em ARN do stream de entrega, insira o ARN do grupo de logs do Firehose para o qual entregar os eventos. Para obter mais informações sobre como criar um grupo de logs de fluxo do Firehose, consulte Tutorial: Criação de um fluxo do Firehose a partir do console.
9. Clique em Publicação de eventos.
10. Em Tipos de eventos, selecione seu tipo de evento.
    Observação: é possível selecionar tipos específicos de eventos que deseja enviar para diferentes destinos de eventos. Por exemplo, é possível enviar todos os eventos relacionados a entrega para o Firehose para armazenamento. Ou é possível enviar todos os eventos de falha para um tópico do Amazon SNS para receber uma notificação quando eles ocorrerem.
    Importante: selecione TUDO para enviar todos os eventos de SMS, MMS e voz para o destino especificado.
11. Selecione Criar evento.

Para obter mais informações, consulte Configurar um destino de evento do Amazon Data Firehose no AWS End User Messaging SMS.

Configure um tópico do Amazon SNS como um destino de evento do AWS End User Messaging SMS

Para criar um destino de evento do Amazon SNS, conclua as seguintes etapas:

1. Abra o console do AWS End User Messaging SMS.
2. Em Configurações, clique em Conjuntos de configurações.
3. Selecione o conjunto de configurações ao qual adicionar um destino de evento.
4. Clique em Adicionar destino de evento.
5. Em Detalhes do evento, em Nome do destino de evento, insira um nome.
6. Na lista suspensa Tipo de destino, selecione Amazon SNS.
7. Para que o AWS End User Messaging SMS crie um tópico em sua conta, clique em Novo tópico do Amazon SNS.
   Observação: o tópico é criado automaticamente com todas as permissões necessárias. Para obter mais informações sobre tópicos do Amazon SNS, consulte Criar um tópico do Amazon SNS e publique mensagens.
8. Se você já tiver um tópico do Amazon SNS, selecione o Tópico existente do Amazon SNS na lista suspensa ARN do tópico.
   Observação: certifique-se de que seu tópico do Amazon SNS tenha a política de acesso para permitir que o AWS End User Messaging SMS publique no tópico do Amazon SNS.
9. Em Tipos de eventos, selecione seu tipo de evento.
   Observação: é possível selecionar tipos específicos de eventos que deseja enviar para diferentes destinos de eventos. Por exemplo, é possível enviar todos os eventos relacionados a entrega para o Firehose para armazenamento. Ou é possível enviar todos os eventos de falha para um tópico do Amazon SNS para receber uma notificação quando eles ocorrerem.
   Importante: selecione TUDO para enviar todos os eventos de SMS, MMS e voz para o destino especificado.
10. Selecione Criar evento.

Se o seu tópico do Amazon SNS tiver a criptografia do lado do servidor ativada com o AWS Key Management Service, adicione a seguinte política à chave gerenciada pelo cliente associada:

{
    "Version": "2012-10-17",
    "Id": "example-ID",
    "Statement": [
        {
            "Sid": "example-statement-ID",
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": [
                "kms:GenerateDataKey",
                "kms:Decrypt"
            ],
            "Resource": "*"
        }
    ]
}

Para obter mais informações, consulte Configure um destino de evento do Amazon SNS em AWS End User Messaging SMS.

Observação: para enviar eventos ou recibos de entrega para o destino configurado, as solicitações da API SendTextMessage, SendMediaMessage e SendVoiceMessage devem incluir o parâmetro de nome do conjunto de configurações. É possível associar até cinco destinos de eventos a um único conjunto de configurações. Pode levar até 72 horas para você receber eventos por SMS ou recibos de entrega das operadoras.

Informações relacionadas

Exemplo de dados de eventos de AWS End User Messaging SMS

Tipos de eventos para SMS, MMS e voz

Monitoramento de AWS End User Messaging SMS