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á. # Destinos de eventos em SMS de mensagens de usuário AWS final O *destino de um evento* é um local (como um CloudWatch grupo, um stream do Amazon Data Firehose ou um tópico do Amazon SNS) para o qual os eventos de SMS e voz são enviados. Para usar destinos de eventos, primeiro você cria o destino e depois o associa a um [Conjuntos de configurações no AWS End User Messaging SMS](configuration-sets.md). Você pode associar até cinco destinos de evento com uma única configuração. Quando você envia uma mensagem, sua chamada para a API inclui uma referência ao conjunto de configurações. Eventos ou recibos de entrega (DLR) gerados pelas operadoras podem levar até 72 horas para serem recebidos e não devem ser usados para determinar se há um atraso na entrega das mensagens enviadas. Após 72 horas, se o SMS de mensagem para o usuário AWS final não tiver recebido um evento final de uma operadora, o serviço retornará automaticamente uma mensagem DESCONHECIDA, `messageStatus` pois não sabemos o que aconteceu com essa mensagem. **Pré-requisitos** Você já precisa ter criado um conjunto de configurações para associar os destinos do evento. Consulte [Conjuntos de configurações no AWS End User Messaging SMS](configuration-sets.md). **Topics** + [Tipos de eventos](configuration-sets-event-types.md) + [Exemplo de dados do evento](configuration-sets-event-format.md) + [Configurar o destino do CloudWatch evento na Amazon](configuration-sets-cloud-watch.md) + [Configurar destino de evento Amazon Data Firehose](configuration-sets-kinesis.md) + [Configurar um destino de evento do Amazon SNS](configuration-sets-sns.md) # Tipos de evento para SMS, MMS e voz A maneira mais fácil de usar destinos de eventos é enviar todos os eventos de SMS, MMS e voz a um único destino. No entanto, você pode configurar destinos de eventos para que tipos específicos de eventos sejam enviados para destinos diferentes. Por exemplo, você pode enviar todos os eventos relacionados à entrega para um Firehose para armazenamento e todos os eventos de falha para um tópico do Amazon SNS para que você possa ser notificado quando eles ocorrerem. Você também pode enviar eventos de SMS e de voz para locais diferentes. Você pode configurar destinos de eventos para enviar os seguintes tipos de eventos: **Eventos de SMS, MMS e voz** + **ALL**: envia todos os eventos de SMS, MMS e voz para o destino especificado. **Eventos de SMS** + **TEXT\$1ALL**: envia todos os eventos de SMS para o destino especificado. + **TEXT\$1DELIVERED (Delivered)**: – envia todos os eventos de SMS para o destino especificado. Dependendo do país de destino, os eventos TEXT\$1DELIVERED e **TEXT\$1SUCCESSFUL podem ser** **usados de forma intercambiável**. + **TEXT\$1SUCCESSFUL (Successful)** – Eventos com êxito ocorrem quando a mensagem é aceita pela operadora do destinatário. Dependendo do país de destino, os eventos TEXT\$1DELIVERED e **TEXT\$1SUCCESSFUL podem ser** **usados de forma intercambiável**. + **TEXT\$1QUEUED (Queued)** – Eventos em fila ocorrem quando a mensagem está na fila para entrega, mas ainda não foi entregue. + **TEXT\$1PENDING (Pending)** – Eventos pendentes ocorrem quando uma mensagem está em processo de entrega, mas ainda não foi entregue (ou houve falha na entrega). + **TEXT\$1BLOCKED (Blocked)** – Eventos bloqueados ocorrem quando o dispositivo ou a operadora do destinatário está bloqueando mensagens para esse destinatário. + **TEXT\$1TTL\$1EXPIRED (TTL expired)** – Os eventos TTL Expired ocorrem quando o tempo necessário para entregar a mensagem excede o valor `TTL` que você especificou ao enviar a mensagem. + **TEXT\$1CARRIER\$1UNREACHABLE (Carrier unreachable)** – eventos Carrier Unreachable ocorrem quando ocorre um erro transitório na rede da operadora do destinatário da mensagem. + **TEXT\$1INVALID (SMS invalid)** – Eventos inválidos ocorrem quando o número de telefone de destino não é válido. + **TEXT\$1INVALID\$1MESSAGE (Invalid message)** – eventos de mensagem inválida ocorrem quando o corpo da mensagem MMS é inválido ou não pode ser entregue. + **TEXT\$1CARRIER\$1BLOCKED (Carrier blocked)** - eventos bloqueados pela operadora ocorrem quando a operadora do destinatário bloqueia a entrega da mensagem. Isso geralmente ocorre quando a operadora identifica a mensagem como maliciosa (por exemplo, se a mensagem contiver informações relacionadas a um esquema de phishing) ou abusiva (por exemplo, se a mensagem for suspeita de ser conteúdo não solicitado ou proibido). + **TEXT\$1UNREACHABLE (Unreachable)** – eventos inacessíveis ocorrem quando o dispositivo do destinatário não está disponível. Isso pode ocorrer se o dispositivo não estiver conectado a uma rede móvel ou estiver desligado. + **TEXT\$1SPAM (Spam)** – Eventos de spam ocorrem quando a operadora do destinatário identifica a mensagem como contendo conteúdo comercial não solicitado e bloqueia a entrega da mensagem. + **TEXT\$1UNKNOWN (Unknown)** – Eventos desconhecidos ocorrem quando uma mensagem não é entregue por um motivo que não é coberto por nenhum dos outros tipos de eventos. Erros desconhecidos podem ser transitórios ou permanentes. + **TEXT\$1PROTECT\$1BLOCKED (Proteção bloqueada) — Mensagem bloqueada pela configuração de proteção**. **Eventos de voz** + **VOICE\$1ALL**: envia todos os eventos de voz para o destino especificado. + **VOICE\$1COMPLETED (Completed)** – Os eventos concluídos ocorrem quando a mensagem de áudio é reproduzida para o destinatário. Esse status não significa necessariamente que a mensagem foi entregue a um destinatário humano. Por exemplo, isso pode indicar que a mensagem foi entregue em um sistema de correio de voz. + **VOICE\$1ANSWERED (Respondido)**: eventos respondidos ocorrem quando o destinatário atende o telefone. + **VOICE\$1INITIATED (Initiated)** – envia eventos para o destino especificado sempre que uma mensagem de voz é iniciada. + **VOICE\$1TTL\$1EXPIRED (TTL expired)** – Os eventos TTL Expired ocorrem quando o tempo necessário para entregar a mensagem excede o valor `TTL` que você especificou ao enviar a mensagem. + **VOICE\$1BUSY (Busy)** – Eventos ocupados ocorrem quando a linha telefônica do destinatário está ocupada. + **VOICE\$1NO\$1ANSWER (No answer)** – Nenhum evento de resposta ocorre após a realização da chamada, mas o destinatário (ou seu sistema de correio de voz) nunca atende. + **VOICE\$1RINGING (Ringing)** – Os eventos de toque ocorrem após a chamada ser feita, mas antes que o destinatário atenda. + **VOICE\$1FAILED (Failed)** – Eventos de falha ocorrem quando a mensagem não é entregue. **eventos do MMS** + **MEDIA\$1ALL**: envia todos os eventos de MMS para o destino especificado. + **MEDIA\$1PENDING (Pending)** – Eventos pendentes ocorrem quando uma mensagem está em processo de entrega, mas ainda não foi entregue (ou houve falha na entrega). + **MEDIA\$1QUEUED (Queue)** – Eventos em fila ocorrem quando a mensagem está na fila para entrega, mas ainda não foi entregue. + **MEDIA\$1SUCCESSFUL (Successful)** – Eventos com êxito ocorrem quando a mensagem é aceita pela operadora do destinatário. + **MEDIA\$1DELIVERED (Delivered)** – envia todos os eventos de SMS para o destino especificado. + **MEDIA\$1INVALID (MMS invalid)** – Eventos inválidos ocorrem quando o número de telefone de destino não é válido. + **MEDIA\$1INVALID\$1MESSAGE (mensagem inválida): eventos de mensagem** inválida ocorrem quando o corpo da mensagem MMS é inválido ou não pode ser entregue. + **MEDIA\$1UNREACHABLE (Inacessível): eventos inacessíveis ocorrem quando** o dispositivo do destinatário não está disponível. Isso pode ocorrer se o dispositivo não estiver conectado a uma rede móvel ou estiver desligado. + **MEDIA\$1CARRIER\$1UNREACHABLE (Carrier unreachable)** - eventos Carrier Unreachable ocorrem quando ocorre um erro transitório na rede da operadora do destinatário da mensagem. + **MEDIA\$1BLOCKED (Blocked)** - Eventos bloqueados ocorrem quando o dispositivo ou a operadora do destinatário está bloqueando mensagens para esse destinatário. + **MEDIA\$1CARRIER\$1BLOCKED (Transportadora bloqueada)**: eventos bloqueados pela operadora ocorrem quando a operadora do destinatário bloqueia a entrega da mensagem. Isso geralmente ocorre quando a operadora identifica a mensagem como maliciosa (por exemplo, se a mensagem contiver informações relacionadas a um esquema de phishing) ou abusiva (por exemplo, se a mensagem for suspeita de ser conteúdo não solicitado ou proibido). + **MEDIA\$1SPAM (Spam)** – Eventos de spam ocorrem quando a operadora do destinatário identifica a mensagem como contendo conteúdo comercial não solicitado e bloqueia a entrega da mensagem. + **MEDIA\$1UNKNOWN (Unknown)** – Eventos desconhecidos ocorrem quando uma mensagem não é entregue por um motivo que não é coberto por nenhum dos outros tipos de eventos. Erros desconhecidos podem ser transitórios ou permanentes. + **MEDIA\$1TTL\$1EXPIRED (TTL expired)** - Os eventos TTL Expired ocorrem quando o tempo necessário para entregar a mensagem excede o valor `TTL` que você especificou ao enviar a mensagem. + **MEDIA\$1FILE\$1TYPE\$1UNSUPPORTED (Tipo de arquivo não suportado)** — Eventos de tipo de arquivo não suportado ocorrem quando um arquivo de mídia não está em um formato compatível. Para obter uma lista dos tipos de arquivo compatíveis, consulte [Tipos e tamanho de arquivo MMS e limites de caracteres](mms-limitations-character.md) + **MEDIA\$1FILE\$1SIZE\$1EXCEEDED (Tamanho do arquivo) — O evento Tamanho** do arquivo excedido ocorre quando o arquivo de mídia tem mais de 600 KB. + **MEDIA\$1FILE\$1INACCESSIBLE (Arquivo inacessível)** — Eventos de arquivo inacessível ocorrem quando o AWS End User Messaging SMS não tem permissões para acessar o arquivo. # Exemplo de dados de eventos de SMS de mensagens para o usuário AWS final AWS O SMS de mensagens para o usuário final pode transmitir dados de eventos para entregas de SMS, MMS e mensagens de voz. Como pode levar até 72 horas para receber os eventos gerados pelas operadoras, você não deve usá-los para determinar se há um atraso na entrega de mensagens enviadas. Após 72 horas, se o SMS de mensagem para o usuário AWS final não tiver recebido um evento final de uma operadora, o serviço retornará automaticamente, `UNKNOWN` `messageStatus` pois não sabemos o que aconteceu com essa mensagem. **Topics** + [exemplo de log de SMS](#configuration-sets-event-format-sms-example) + [Exemplo de log do SMS Protect](#configuration-sets-event-format-sms-protect-example) + [Exemplo de registro de eventos de voz](#configuration-sets-event-format-voice-example) + [Exemplo de log de MMS](#configuration-sets-event-format-mms-example) ## exemplo de log de SMS O objeto JSON de um evento de SMS contém os dados mostrados no exemplo a seguir. ``` { "eventType": "TEXT_SUCCESSFUL", "eventVersion": "1.0", "eventTimestamp": 1686975103470, "isFinal": true, "originationPhoneNumber": "+12065550152", "destinationPhoneNumber": "+14255550156", "isInternationalSend": false, "mcc": "310", "mnc": "800", "messageId": "862a8790-60c0-4430-9b2b-658bdexample", "messageRequestTimestamp": 1686975103170, "messageEncoding": "GSM", "messageType": "PROMOTIONAL", "messageStatus": "SUCCESSFUL", "messageStatusDescription": "Message has been accepted by phone carrier", "context": { "account": "bar" }, "totalMessageParts": 1, "totalMessagePrice": 0.09582, "totalCarrierFee": 0.0 } ``` **** | Atributo | Description | | --- | --- | | eventType | O tipo de evento. Os valores estão listados em [Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md) | | eventVersion | A versão do esquema do evento JSON. | | eventTimestamp | A hora em que o evento foi relatado, mostrada como horário do Unix em milissegundos. | | isFinal | True se esse for o status final da mensagem. Há status intermediários de mensagens e o recebimento do estado da mensagem final pode levar até 72 horas. | | originationPhoneNumber | O número de telefone do qual a mensagem foi enviada. | | destinationPhoneNumber | O número de telefone para o qual você tentou enviar a mensagem. | | isInternationalSend | True se as mensagens internacionais estiverem habilitadas para esse número de telefone. | | isoCountryCode | O país associada ao número de telefone do destinatário, mostrado no formato ISO 3166-1 alpha-2. | | mcc | Os códigos de país do celular identificam o país ao qual um número de telefone pertence. Esse campo é opcional e pode não estar presente. | | mnc | Os códigos de rede móvel identificam uma operadora de rede móvel. Esse campo é opcional e pode não estar presente. | | messageId | A ID exclusiva que o AWS End User Messaging SMS gera quando aceita a mensagem. | | messageRequestTimestamp | A hora em que a solicitação da mensagem SMS foi recebida, exibida em horário Unix em milissegundos. | | messageEncoding | A codificação da mensagem. Os valores possíveis são GSM e Unicode. Para obter mais informações sobre codificação de mensagens, consulte [Limites de caracteres de SMS](sms-limitations-character.md). | | messageType | O tipo de mensagem. Os valores possíveis são Promocional e Transacional. | | messageStatus | O status da mensagem. Os valores possíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/configuration-sets-event-format.html) | | messageStatusDescription | Uma descrição do estado da mensagem. | | context | Atributos personalizados que você pode especificar e serão registrados quando você enviar uma mensagem. | | totalMessageParts | O número de partes da mensagem que o AWS End User Messaging SMS criou para enviar a mensagem. Geralmente, as mensagens SMS podem conter apenas 160 caracteres GSM-7 ou 67 caracteres não GSM, embora esses limites possam variar de acordo com o país . Se você enviar uma mensagem que exceda esses limites, o AWS End User Messaging SMS divide automaticamente a mensagem em partes menores. Você será cobrado com base no número de partes de mensagens enviadas. Para obter mais informações sobre partes da mensagem, consulte [Quais são os limites de partes por segundo (MPS) de mensagens](sms-limitations-mps.md). | | totalMessagePrice | O valor cobrado pelo envio da mensagem. Esse preço é mostrado em milésimos de um centavo dos Estados Unidos. Por exemplo, se o valor desse atributo for 645, cobraremos USD 0,645 para enviar a mensagem (645/1000 = 0,645 = 0,00645). | | totalCarrierFee | O custo total das taxas da operadora para uma mensagem. | ## Exemplo de log do SMS Protect O objeto JSON para um evento SMS ao usar o [SMS Protect](protect.md) contém os dados mostrados no exemplo a seguir. ``` { "eventType": "TEXT_PROTECT_BLOCKED", "eventVersion": "1.0", "eventTimestamp": 1686975103470, "isFinal": true, "originationPhoneNumber": "+12065550152", "destinationPhoneNumber": "+14255550156", "isoCountryCode": "US", "mcc": "310", "mnc": "800", "messageId": "862a8790-60c0-4430-9b2b-658bdexample", "messageRequestTimestamp": 1686975103170, "messageEncoding": "GSM", "messageType": "PROMOTIONAL", "messageStatus": "PROTECT_BLOCKED", "messageStatusDescription": "Message blocked by protect configuration", "context": { "account": "bar" }, "totalMessageParts": 1, "totalMessagePrice": 0, "totalCarrierFee": 0, "protectConfiguration": { "protectConfigurationId": "protect-d777777777777771bbd5d59f4d903479", "protectStatus": "FILTER" }, "protectConfigurationAssessment": { "protectRecommendation": "BLOCK" "protectInsights": { "blockReason": "AIT_SUSPECTED" } } } ``` **** | Atributo | Description | | --- | --- | | eventType | O tipo de evento. Os valores estão listados em [Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md) | | eventVersion | A versão do esquema do evento JSON. | | eventTimestamp | A hora em que o evento foi relatado, mostrada como horário do Unix em milissegundos. | | isFinal | True se esse for o status final da mensagem. Há status intermediários de mensagens e o recebimento do estado da mensagem final pode levar até 72 horas. | | originationPhoneNumber | O número de telefone do qual a mensagem foi enviada. | | destinationPhoneNumber | O número de telefone para o qual você tentou enviar a mensagem. | | isoCountryCode | O país associada ao número de telefone do destinatário, mostrado no formato ISO 3166-1 alpha-2. | | mcc | Os códigos de país do celular identificam o país ao qual um número de telefone pertence. Esse campo é opcional e pode não estar presente. | | mnc | Os códigos de rede móvel identificam uma operadora de rede móvel. Esse campo é opcional e pode não estar presente. | | messageId | A ID exclusiva que o AWS End User Messaging SMS gera quando aceita a mensagem. | | messageRequestTimestamp | A hora em que a solicitação da mensagem SMS foi recebida, exibida em horário Unix em milissegundos. | | messageEncoding | A codificação da mensagem. Os valores possíveis são GSM e Unicode. Para obter mais informações sobre codificação de mensagens, consulte [Limites de caracteres de SMS](sms-limitations-character.md). | | messageType | O tipo de mensagem. Os valores possíveis são Promocional e Transacional. | | messageStatus | O status da mensagem. Os valores possíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/configuration-sets-event-format.html) | | messageStatusDescription | Uma descrição do estado da mensagem. | | context | Atributos personalizados que você pode especificar e serão registrados quando você enviar uma mensagem. | | totalMessageParts | O número de partes da mensagem que o AWS End User Messaging SMS criou para enviar a mensagem. Geralmente, as mensagens SMS podem conter apenas 160 caracteres GSM-7 ou 67 caracteres não GSM, embora esses limites possam variar de acordo com o país . Se você enviar uma mensagem que exceda esses limites, o AWS End User Messaging SMS divide automaticamente a mensagem em partes menores. Você será cobrado com base no número de partes de mensagens enviadas. Para obter mais informações sobre partes da mensagem, consulte [Quais são os limites de partes por segundo (MPS) de mensagens](sms-limitations-mps.md). | | totalMessagePrice | O valor cobrado pelo envio da mensagem. Esse preço é mostrado em milésimos de um centavo dos Estados Unidos. Por exemplo, se o valor desse atributo for 645, cobraremos USD 0,645 para enviar a mensagem (645/1000 = 0,645 = 0,00645). | | totalCarrierFee | O custo total das taxas da operadora para uma mensagem. | | protectConfiguration | O ID da configuração de proteção usada ao enviar a mensagem e o status do país de destino no momento. Para obter mais informações sobre SMS Protect, consulte [SMS Protect](protect.md). | | protectConfigurationAssessment | Uma avaliação sobre se o SMS Protect acha que o envio de sua mensagem deve ser permitido ou bloqueado e os motivos do bloqueio, quando disponíveis. | ## Exemplo de registro de eventos de voz O objeto JSON para um evento de voz contém os dados mostrados no exemplo a seguir. ``` { "eventType": "VOICE_COMPLETED", "eventVersion": "1.0", "eventTimestamp": 1697835373500, "isFinal": true, "originationPhoneNumber": "+12065550153", "destinationPhoneNumber": "+14255550159", "isoCountryCode": "US", "messageId": "567f6c11-6e8b-4352-9749-a42a0example", "messageRequestTimestamp": 1697835372720, "messageStatus": "COMPLETED", "callDurationInSeconds": 60, "totalDurationInMinutes": 1, "totalMessagePrice": 0.013, "context": { "account": "bar" } } ``` **** | Atributo | Description | | --- | --- | | eventType | O tipo de evento. Os valores estão listados em [Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md) | | eventVersion | A versão do esquema do evento JSON. | | eventTimestamp | A hora em que o evento foi relatado, mostrada como horário do Unix em milissegundos. | | isFinal | True se esse for o status final da mensagem. Há status de mensagens intermediárias. | | originationPhoneNumber | O número de telefone do qual a mensagem foi enviada. | | destinationPhoneNumber | O número de telefone para o qual você tentou enviar a mensagem. | | isoCountryCode | O país associada ao número de telefone do destinatário, mostrado no formato ISO 3166-1 alpha-2. | | messageId | A ID exclusiva que o AWS End User Messaging SMS gera quando aceita a mensagem. | | messageRequestTimestamp | A hora em que a solicitação da mensagem SMS foi recebida, exibida em horário Unix em milissegundos. | | messageStatus | O status da mensagem. Os valores possíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/configuration-sets-event-format.html) | | callDurationInSeconds | A duração da chamada em segundos. | | totalDurationInMinutes | A duração da chamada em minutos. | | totalMessagePrice | O valor que cobramos para enviar a mensagem de voz. Esse preço é mostrado em milésimos de um centavo dos Estados Unidos. | | context | Atributos personalizados que você pode especificar e serão registrados quando você enviar uma mensagem. | ## Exemplo de log de MMS O objeto JSON para um evento MMS contém os dados mostrados no exemplo a seguir. ``` { "contentType":"MMS", "eventType": "MEDIA_DELIVERED", "eventVersion": "1.0", "eventTimestamp": 1635197695208, "isFinal": true, "originationPhoneNumber": "+12065550153", "destinationPhoneNumber": "+14255550159", "isoCountryCode": "US", "messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235example", "messageRequestTimestamp": 1635197693241, "messageType": "TRANSACTIONAL", "messageStatus": "DELIVERED", "messageStatusDescription": "Message has been accepted by phone", "context": {"foo":"bar"}, "totalMessageParts": 1, "totalMessagePrice": 0.0195, "totalCarrierFee": 0.00266 } ``` **** | Atributo | Description | | --- | --- | | eventType | O tipo de evento. Os valores estão listados em [Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md) | | eventVersion | A versão do esquema do evento JSON. | | eventTimestamp | A hora em que o evento foi relatado, mostrada como horário do Unix em milissegundos. | | isFinal | True se esse for o status final da mensagem. Há status intermediários de mensagens e o recebimento do estado da mensagem final pode levar até 72 horas. | | originationPhoneNumber | O número de telefone do qual a mensagem foi enviada. | | destinationPhoneNumber | O número de telefone para o qual você tentou enviar a mensagem. | | isoCountryCode | O país associada ao número de telefone do destinatário, mostrado no formato ISO 3166-1 alpha-2. | | messageId | A ID exclusiva que o AWS End User Messaging SMS gera quando aceita a mensagem. | | messageRequestTimestamp | A hora em que a solicitação da mensagem SMS foi recebida, exibida em horário Unix em milissegundos. | | messageType | O tipo de mensagem. Os valores possíveis são Promocional e Transacional. | | messageStatus | O status da mensagem. Os valores possíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/configuration-sets-event-format.html) | | messageStatusDescription | Uma descrição do estado da mensagem. | | context | Atributos personalizados que você pode especificar e serão registrados quando você enviar uma mensagem. | | totalMessageParts | O número de partes da mensagem que o AWS End User Messaging SMS criou para enviar a mensagem. Para obter mais informações sobre partes da mensagem, consulte [Quais são os limites de partes por segundo (MPS) de mensagens](sms-limitations-mps.md). | | totalMessagePrice | O valor cobrado pelo envio da mensagem. Esse preço é mostrado em milésimos de um centavo dos Estados Unidos. Por exemplo, se o valor desse atributo for 645, cobraremos USD 0,645 para enviar a mensagem (645/1000 = 0,645 = 0,00645). | | totalCarrierFee | O custo total das taxas da operadora para uma mensagem. | # Configure um destino de CloudWatch evento da Amazon em AWS End User Messaging SMS O Amazon CloudWatch Logs é um AWS serviço que você pode usar para monitorar, armazenar e acessar arquivos de log. Quando você cria um destino de CloudWatch evento, o AWS End User Messaging SMS envia os tipos de eventos que você especificou no destino do evento para um CloudWatch grupo. Para saber mais sobre isso CloudWatch, consulte o [Guia do usuário do Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/). **Pré-requisitos** 1. Antes de criar um destino para o CloudWatch evento, você deve primeiro criar um CloudWatch grupo. Para obter mais informações sobre a criação de grupos de registros, consulte [Trabalho com grupos de registros e fluxos de registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) no *Guia do usuário do Amazon CloudWatch Logs*. **Importante** Você precisará do Amazon Resource Name (ARN) do CloudWatch grupo para criar o destino do evento. 1. Você deve criar uma [função do IAM](configuration-sets-cloud-watch-creating-role.md#configuration-sets-cloud-watch-creating-role.title) que permita que o AWS End User Messaging SMS grave no grupo de registros. **Importante** Você precisará do nome do recurso da Amazon (ARN) do perfil do IAM para criar o destino do evento. 1. Você também configurou um conjunto de configurações para associar os destinos do evento, consulte [Crie um conjunto de configurações no AWS End User Messaging SMS](configuration-set-create.md). # Política de IAM para a Amazon CloudWatch Use o exemplo a seguir para criar uma política para enviar eventos para um CloudWatch grupo. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:PutLogEvents" ], "Resource": [ "arn:aws:logs:us-east-1:111122223333:log-group:log-group-name:*" ] } ] } ``` ------ Para obter mais informações sobre as políticas do IAM, consulte [Políticas e permissões no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) no *Guia do usuário do IAM*. O exemplo de declaração a seguir usa as `SourceArn` condições opcionais, mas `SourceAccount` recomendadas, para verificar se somente a conta do proprietário do SMS do AWS End User Messaging tem acesso ao conjunto de configurações. Neste exemplo, *accountId* substitua pelo ID AWS da sua conta, *region* pelo Região da AWS nome e *ConfigSetName* pelo nome do Conjunto de Configurações. Depois de criar a política, crie um perfil do IAM e anexe a política a ele. Ao criar o perfil, adicione também a seguinte política de confiança a ele: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": { "Effect": "Allow", "Principal": { "Service": "sms-voice.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName" } } } } ``` ------ Para obter mais informações sobre como criar perfis do IAM, consulte [Criar perfis do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) no *Guia do usuário do IAM*. # Crie um destino de CloudWatch evento da Amazon em AWS End User Messaging SMS Depois de criar a função do IAM e o CloudWatch grupo, você pode criar o destino do evento. ------ #### [ Create event destination (Console) ] Para criar um destino de evento usando o console AWS End User Messaging SMS, siga estas etapas: 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações**, escolha **Conjuntos de configurações**. 1. Na página **Conjuntos de configurações**, escolha um conjunto de configurações no qual um destino de evento. 1. Na página de **detalhes do conjunto de configurações**, escolha **Adicionar destino de evento**. 1. Na seção **Detalhes do evento**, insira um nome amigável para o **nome do destino do evento**. 1. No menu suspenso **Tipo de destino**, escolha Amazon. CloudWatch 1. Em **Perfil do IAM arn**, insira o ARN para um perfil do IAM. Para obter mais informações sobre o perfil do IAM arn, consulte [Política de IAM para a Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md). 1. Em **Log group arn**, insira o ARN do grupo de log da CloudWatch Amazon para o qual entregar os eventos. 1. Ative a **publicação de eventos**. 1. Em **Tipos de eventos**, escolha: + **Todos os eventos de SMS (recomendado)** — Escolha essa opção para enviar todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para a Amazon CloudWatch. + **Eventos de SMS personalizados** — Escolha eventos de SMS específicos para os quais enviar CloudWatch. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na **seleção Editar evento por SMS**, marque somente os eventos que você deseja enviar para a Amazon CloudWatch. Escolha **Salvar seleção**. + **Todos os eventos de voz (recomendado)** — Escolha essa opção para enviar todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para a Amazon CloudWatch. + **Eventos de voz personalizados** — Escolha eventos de voz específicos para os quais enviar CloudWatch. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na **seleção Editar evento de voz**, marque somente os eventos que você deseja enviar para a Amazon CloudWatch. Escolha **Salvar seleção**. + **Todos os eventos MMS (recomendado)** — Escolha essa opção para enviar todos os eventos MMS listados para a [Tipos de eventos](configuration-sets-event-types.md) Amazon. CloudWatch + Eventos **MMS personalizados — Escolha eventos** MMS específicos para os quais enviar. CloudWatch Para editar a lista de eventos, escolha **Editar seleção de eventos por MMS**. Na **seleção Editar evento MMS**, marque somente os eventos que você deseja enviar para a Amazon CloudWatch. Escolha **Salvar seleção**. 1. Escolha **Create event (Criar evento)**. ------ #### [ Create event destination (AWS CLI) ] Você pode usar o [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)comando para criar um destino de evento. Na linha de comando, execute o seguinte comando: ``` $ aws pinpoint-sms-voice-v2 create-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event-types eventTypes \ > --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup ``` No comando anterior, faça as seguintes alterações: + *eventDestinationName*Substitua por um nome que descreva o destino do evento. + *configurationSet*Substitua pelo nome do conjunto de configurações ao qual você deseja associar o destino do evento. + *eventTypes*Substitua por um ou mais dos tipos de eventos listados em[Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md). + Substitua o valor do `IamRoleArn` pelo nome do recurso da Amazon (ARN) de um perfil do IAM que tenha as políticas descritas em [Política de IAM para a Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md). + Substitua o valor `LogGroupArn` de pelo ARN do CloudWatch grupo para o qual você deseja enviar eventos. ------ # Edite um destino de CloudWatch evento da Amazon em AWS End User Messaging SMS Use o console AWS End User Messaging SMS ou AWS CLI para editar o destino de um CloudWatch evento. ------ #### [ Update event destination (Console) ] Para atualizar o destino de um evento usando o console AWS End User Messaging SMS, siga estas etapas: 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações**, escolha **Conjuntos de configurações**. 1. Na página **Conjuntos de configurações**, escolha um conjunto de configurações para editar. 1. Na guia **Configurações do evento**, escolha um destino para CloudWatch eventos da Amazon e depois **Editar**. 1. Em **Perfil do IAM arn**, insira o ARN para um perfil do IAM. Para obter mais informações sobre o perfil do IAM arn, consulte [Política de IAM para a Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md). 1. Em **Log group arn**, insira o ARN do grupo de log da CloudWatch Amazon para o qual entregar os eventos. 1. Em **Tipos de eventos**, escolha: + **Todos os eventos de SMS (recomendado)** — Escolha essa opção para enviar todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para a Amazon CloudWatch. + **Eventos de SMS personalizados** — Escolha esta opção e escolha eventos de SMS específicos para os quais enviar CloudWatch. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na **seleção Editar evento por SMS**, marque somente os eventos que você deseja enviar para a Amazon CloudWatch. Escolha **Salvar seleção**. + **Todos os eventos de voz (recomendado)** — Escolha essa opção para enviar todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para a Amazon CloudWatch. + **Eventos de voz personalizados** — Escolha esta opção e escolha eventos de voz específicos para os quais enviar CloudWatch. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na **seleção Editar evento de voz**, marque somente os eventos que você deseja enviar para a Amazon CloudWatch. Escolha **Salvar seleção**. + **Todos os eventos MMS (recomendado)** — Escolha essa opção para enviar todos os eventos MMS listados para a [Tipos de eventos](configuration-sets-event-types.md) Amazon. CloudWatch + **Eventos MMS personalizados** — Escolha esta opção e escolha eventos MMS específicos para os quais enviar. CloudWatch Para editar a lista de eventos, escolha **Editar seleção de eventos por MMS**. Na **seleção Editar evento MMS**, marque somente os eventos que você deseja enviar para a Amazon CloudWatch. Escolha **Salvar seleção**. 1. Escolha **Editar evento**. ------ #### [ Update event destination AWS CLI) ] Você pode usar o [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)comando para atualizar o destino de um evento. O procedimento para atualizar um destino de CloudWatch evento é semelhante ao processo de criação de um destino de evento. Na linha de comando, execute o seguinte comando: ``` $ aws pinpoint-sms-voice-v2 update-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event types eventTypes \ > --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup ``` No comando anterior, faça as seguintes alterações: + *eventDestinationName*Substitua por um nome do destino do evento que você deseja modificar. + *configurationSet*Substitua pelo nome do conjunto de configurações ao qual você deseja associar o destino do evento. Você pode associar o destino do evento a um conjunto de configurações diferente. + *eventTypes*Substitua por um dos tipos de eventos listados em[Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md). + Substitua o valor do `IamRoleArn` pelo nome do recurso da Amazon (ARN) de um perfil do IAM que tenha as políticas descritas em [Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md). + Substitua o valor `LogGroupArn` de pelo ARN do CloudWatch grupo para o qual você deseja enviar eventos. ------ # Excluir um destino de CloudWatch evento da Amazon em AWS End User Messaging SMS Use o console AWS End User Messaging SMS ou AWS CLI exclua o destino de um CloudWatch evento. ------ #### [ Delete an CloudWatch event destination (Console) ] O processo para excluir um destino de evento é o mesmo, independentemente do tipo de destino do evento que você deseja excluir. **Para excluir um destino de CloudWatch evento no console** 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações**, escolha **Conjuntos de configurações**. 1. Na página **Conjuntos de configuração**, escolha o conjunto de configurações do qual remover um destino de evento. 1. Na seção **Todos os destinos**, escolha um destino para o evento e escolha **Excluir**. ------ #### [ Delete an CloudWatch event destination (AWS CLI) ] Você pode usar o [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)comando para excluir o destino de um evento. O processo para excluir um destino de evento é o mesmo, independentemente do tipo de destino do evento que você deseja excluir. **Para excluir um destino de CloudWatch evento no AWS CLI** + Na linha de comando, execute o seguinte comando: ``` $ aws pinpoint-sms-voice-v2 delete-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSetName ``` No comando anterior, faça as seguintes alterações: + *eventDestinationName*Substitua pelo nome ou Amazon Resource Name (ARN) do destino do evento que você deseja excluir. + *configurationSetName*Substitua pelo nome ou ARN do conjunto de configurações ao qual o destino do evento está associado. ------ # Configurar um destino de evento do Amazon Data Firehose no AWS End User Messaging SMS Amazon Data Firehose é um serviço totalmente gerenciado para fornecimento de transmissão de dados em tempo real a vários tipos de destino. O Amazon Data Firehose faz parte da plataforma de transmissão de dados Kinesis. Para saber mais sobre o Amazon Data Firehose, consulte o [Guia do desenvolvedor do Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/). Alguns dos exemplos desta seção também pressupõem que você já instalou e configurou a AWS Command Line Interface. Para obter mais informações sobre como configurar o AWS CLI, consulte o [Guia AWS Command Line Interface do usuário](https://docs.aws.amazon.com/cli/latest/userguide/). **Pré-requisitos** 1. Antes de criar um destino de evento do Amazon Data Firehose, você deve primeiro criar um fluxo de entrega do Amazon Data Firehose. Para obter mais informações sobre como [criar fluxos, consulte Criando um fluxo de entrega](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) do *Amazon Data Firehose no Guia do desenvolvedor do Amazon Data Firehose*. **Importante** Você precisará do nome do recurso da Amazon (ARN) do fluxo de entrega do Amazon Data Firehose para criar o destino do evento. 1. Você precisa criar uma função do IAM que permita que o AWS End User Messaging SMS grave no stream de entrega, consulte[Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md). **Importante** Você precisará do nome do recurso da Amazon (ARN) do perfil do IAM para criar o destino do evento. 1. Você também configurou um conjunto de configurações para associar os destinos do evento, consulte [Crie um conjunto de configurações no AWS End User Messaging SMS](configuration-set-create.md). **Topics** + [Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md) + [Crie um destino para eventos do Amazon Data Firehose](configuration-set-kinesis-add.md) + [Edite um destino de evento do Amazon Data Firehose](configuration-set-kinesis-edit.md) + [Excluir um destino de evento do Amazon Data Firehose](configuration-set-kinesis-delete.md) # Política de IAM para o Amazon Data Firehose Use o exemplo a seguir para criar uma política para enviar eventos para um fluxo do Amazon Data Firehose. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "firehose:PutRecord", "Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName" } ] } ``` ------ Para obter mais informações sobre as políticas do IAM, consulte [Políticas e permissões no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) no *Guia do usuário do IAM*. O exemplo de declaração a seguir usa as `SourceArn` condições opcionais, mas `SourceAccount` recomendadas, para verificar se somente a conta do proprietário do SMS do AWS End User Messaging tem acesso ao conjunto de configurações. Neste exemplo, *accountId* substitua pelo ID AWS da sua conta, *region* pelo Região da AWS nome e *ConfigSetName* pelo nome do Conjunto de Configurações. Depois de criar a política, crie um perfil do IAM e anexe a política a ele. Ao criar o perfil, adicione também a seguinte política de confiança a ele: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": { "Effect": "Allow", "Principal": { "Service": "sms-voice.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName" } } } } ``` ------ Para obter mais informações sobre como criar perfis do IAM, consulte [Criar perfis do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) no *Guia do usuário do IAM*. # Crie um destino de evento do Amazon Data Firehose em AWS End User Messaging SMS Antes de criar um destino de evento do Amazon Data Firehose, você deve primeiro criar um stream do Amazon Data Firehose. Para obter mais informações sobre a criação de grupos de logs, consulte [Criação de um stream de entrega do Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) no Guia do desenvolvedor do *Amazon Data Firehose*. Você precisa criar uma função do IAM que permita que a API AWS End User Messaging SMS and Voice v2 envie dados para o stream. A seção a seguir contém informações sobre os requisitos para isso. Você também já configurou um conjunto de configurações para associar os destinos do evento, consulte [Conjuntos de configurações no AWS End User Messaging SMS](configuration-sets.md). ------ #### [ Create Amazon Data Firehose event destination (Console) ] Para criar um destino de evento do Amazon Data Firehose usando o console SMS do AWS End User Messaging, siga estas etapas: 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**. 1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações ao qual adicionar um destino de evento. 1. Na página de **detalhes do conjunto de configurações**, escolha **Adicionar evento de destino**. 1. Na seção **Detalhes do evento**, insira um nome amigável para o nome do **destino do evento**. 1. No menu suspenso **Tipo de destino**, escolha Amazon Data Firehose. 1. Para a **função IAM arn**, insira o ARN da função IAM. Para obter mais informações sobre a função do IAM arn, consulte[Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md). 1. Em **Delivery stream arn**, insira o ARN do grupo de log do Amazon Data Firehose para o qual entregar os eventos. 1. Ative a **publicação de eventos**. 1. Em **Tipos de eventos**, escolha: + **Todos os eventos de SMS (recomendado)** — Escolha essa opção para enviar todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon Data Firehose. + **Eventos de SMS personalizados** — Escolha eventos de SMS específicos para enviar para o Amazon Data Firehose. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na **seleção Editar evento SMS**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**. + **Todos os eventos de voz (recomendado)** — Escolha essa opção para enviar todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon Data Firehose. + **Eventos de voz personalizados** — Escolha eventos de voz específicos para enviar para o Amazon Data Firehose. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na **seleção Editar evento de voz**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**. + **Todos os eventos MMS (recomendado)** — Escolha essa opção para enviar todos os eventos MMS listados para o [Tipos de eventos](configuration-sets-event-types.md) Amazon Data Firehose. + Eventos **MMS personalizados — Escolha dois eventos** MMS específicos para enviar para o Amazon Data Firehose. Para editar a lista de eventos, escolha **Editar seleção de eventos MMS**. Na **seleção de eventos Editar MMS**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**. 1. Escolha **Create event (Criar evento)**. ------ #### [ Create Amazon Data Firehose event destination (AWS CLI) ] Depois de criar a função do IAM e o stream de entrega do Amazon Data Firehose, você pode criar o destino do evento. Você pode usar o [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)comando para criar um destino de evento. ``` $ aws pinpoint-sms-voice-v2 create-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event-types eventTypes \ > --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream ``` No comando anterior, faça as seguintes alterações: + *eventDestinationName*Substitua por um nome que descreva o destino do evento. + *configurationSet*Substitua pelo nome do conjunto de configurações ao qual você deseja associar o destino do evento. + *eventTypes*Substitua por um ou mais dos tipos de eventos listados em[Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md). + Substitua o valor do `IamRoleArn` pelo nome do recurso da Amazon (ARN) de um perfil do IAM que tenha as políticas descritas em [Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md). + Substitua o valor `DeliveryStreamArn` de pelo ARN do stream do Amazon Data Firehose para o qual você deseja enviar eventos. ------ # Edite um destino de evento do Amazon Data Firehose em AWS End User Messaging SMS Use o console AWS End User Messaging SMS ou AWS CLI edite um destino de evento do Amazon Data Firehose. ------ #### [ Update Amazon Data Firehose event destination (Console) ] Para atualizar um destino de evento do Amazon Data Firehose usando o console SMS do AWS End User Messaging, siga estas etapas: 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**. 1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações ao qual adicionar um destino de evento. 1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações a ser editado. 1. **Na página de **detalhes do conjunto de configurações**, escolha um destino para o evento Amazon Data Firehose e, em seguida, Edite.** 1. Para a **função IAM arn**, insira o ARN da função IAM. Para obter mais informações sobre a função do IAM arn, consulte[Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md). 1. Em **Delivery stream arn**, insira o ARN do grupo de log do Amazon Data Firehose para o qual os eventos serão entregues. 1. Em **Tipos de eventos**, escolha: + **Todos os eventos de SMS (recomendado)** — Escolha essa opção para enviar todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon Data Firehose. + **Eventos de SMS personalizados** — Escolha esta opção e escolha eventos de SMS específicos para os quais enviar CloudWatch. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na **seleção Editar evento SMS**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**. + **Todos os eventos de voz (recomendado)** — Escolha essa opção para enviar todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon Data Firehose. + **Eventos de voz personalizados** — Escolha esta opção e escolha eventos de voz específicos para enviar para o Amazon Data Firehose. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na **seleção Editar evento de voz**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**. + **Todos os eventos MMS (recomendado)** — Escolha essa opção para enviar todos os eventos MMS listados para o [Tipos de eventos](configuration-sets-event-types.md) Amazon Data Firehose. + **Eventos MMS personalizados** — Escolha esta opção e escolha eventos MMS específicos para os quais enviar. CloudWatch Para editar a lista de eventos, escolha **Editar seleção de eventos MMS**. Na **seleção de eventos Editar MMS**, marque somente os eventos que você deseja enviar para o Amazon Data Firehose. Escolha **Salvar seleção**. 1. Escolha **Editar evento**. ------ #### [ Update Amazon Data Firehose event destination (AWS CLI) ] Você pode usar o [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)comando para atualizar o destino de um evento. O procedimento para atualizar um destino de evento do Amazon Data Firehose é semelhante ao processo de criação de um destino de evento. ``` $ aws pinpoint-sms-voice-v2 create-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event-types eventTypes \ > --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream ``` No comando anterior, faça as seguintes alterações: + *eventDestinationName*Substitua por um nome do destino do evento que você deseja modificar. + *configurationSet*Substitua pelo nome do conjunto de configurações ao qual você deseja associar o destino do evento. Você pode associar o destino do evento a um conjunto de configurações diferente. + *eventTypes*Substitua por um dos tipos de eventos listados em[Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md). + Substitua o valor do `IamRoleArn` pelo nome do recurso da Amazon (ARN) de um perfil do IAM que tenha as políticas descritas em [Política de IAM para o Amazon Data Firehose](configuration-sets-kinesis-creating-role.md). + Substitua o valor `DeliveryStreamArn` de pelo ARN do stream do Amazon Data Firehose para o qual você deseja enviar eventos. ------ # Excluir um destino de evento do Amazon Data Firehose em AWS End User Messaging SMS Use o console AWS End User Messaging SMS ou AWS CLI exclua um destino de evento do Amazon Data Firehose. ------ #### [ Delete an Amazon Data Firehose event destination (Console) ] O processo para excluir um destino de evento é o mesmo, independentemente do tipo de destino do evento que você deseja excluir. **Para excluir um destino de evento do Amazon Data Firehose no console** 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**. 1. Na página **Conjuntos de configuração**, escolha o conjunto de configurações do qual remover um destino de evento. 1. Na seção **Todos os destinos**, escolha um destino para o evento e escolha **Excluir**. ------ #### [ Delete an Amazon Data Firehose event destination (AWS CLI) ] Você pode usar o [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)comando para excluir o destino de um evento. O processo para excluir um destino de evento é o mesmo, independentemente do tipo de destino do evento que você deseja excluir. **Para excluir um destino de evento do Amazon Data Firehose no AWS CLI** + Na linha de comando, execute o seguinte comando: ``` $ aws pinpoint-sms-voice-v2 delete-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSetName ``` No comando anterior, faça as seguintes alterações: + *eventDestinationName*Substitua pelo nome ou Amazon Resource Name (ARN) do destino do evento que você deseja excluir. + *configurationSetName*Substitua pelo nome ou ARN do conjunto de configurações ao qual o destino do evento está associado. ------ # Configure um destino de evento do Amazon SNS em AWS End User Messaging SMS O Amazon Simple Notification Service (Amazon SNS) é um serviço da Web que permite que aplicativos, usuários finais e dispositivos enviem e recebam notificações instantaneamente. Para obter mais informações sobre o Amazon SNS, consulte o [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/). Alguns dos exemplos desta seção também pressupõem que você já instalou e configurou a AWS Command Line Interface. Para obter mais informações sobre como configurar o AWS CLI, consulte o [Guia AWS Command Line Interface do usuário](https://docs.aws.amazon.com/cli/latest/userguide/). **Topics** + [Política de acesso do Amazon SNS](configuration-sets-sns-creating-role.md) + [Crie um destino para eventos do Amazon SNS](configuration-sets-sns-add.md) + [Editar um destino de evento do Amazon SNS](configuration-sets-sns-edit.md) + [Excluir um destino de evento do Amazon SNS](configuration-sets-sns-delete.md) # Política de acesso do Amazon SNS O acesso a um tópico do Amazon SNS é controlado por uma *política de recursos* anexada ao tópico do Amazon SNS, também chamada de *política de acesso*. Para obter mais informações sobre as *políticas de acesso* do Amazon SNS, consulte [Gerenciamento de identidade e acesso](https://docs.aws.amazon.com/sns/latest/dg/security-iam.html) no *Guia do desenvolvedor do Amazon SNS*. **nota** Se o seu tópico do Amazon SNS tiver a criptografia do lado do servidor habilitada, AWS Key Management Service adicione também a política à chave gerenciada pelo cliente de criptografia [simétrica](#configuration-sets-sns-creating-role-encrypted) associada. Atualize a *política de acesso* com a seguinte declaração para permitir que o SMS de mensagens de usuário AWS final seja publicado no tópico do Amazon SNS. + *111122223333*Substitua pelo ID exclusivo da sua AWS conta. + *TopicName*Substitua pelo nome do tópico do Amazon SNS. + *Region*Substitua pelo Região da AWS que contém o tópico e o conjunto de configurações do Amazon SNS. + Substitua *ConfigSetName* pelo nome do conjunto de configurações. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "sms-voice.amazonaws.com" }, "Action": "sns:Publish", "Resource": "arn:aws:sns:us-east-1:111122223333:TopicName", "Condition": { "StringEquals": { "aws:SourceAccount": "accountId" }, "ArnLike": { "aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName" } } } ] } ``` ------ ## Política de acesso para tópicos criptografados do Amazon SNS Se o tópico do Amazon SNS tiver a criptografia do lado do servidor habilitada com AWS Key Management Service, adicione a seguinte política à chave gerenciada pelo cliente de criptografia simétrica associada. Você deve adicionar a política a uma chave gerenciada pelo cliente porque você não pode modificar a chave AWS gerenciada para o Amazon SNS. ------ #### [ JSON ] **** ``` { "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": "*" } ] } ``` ------ # Crie um destino de evento do Amazon SNS em AWS End User Messaging SMS Antes de criar um destino de evento do Amazon SNS, você deve criar um tópico do Amazon SNS. Para obter mais informações sobre a criação de tópicos do Amazon SNS, consulte [Criação de um tópico no Guia](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) do *desenvolvedor do Amazon Simple Notification Service*. Você também deve já ter definido um conjunto de configurações para associar os destinos do evento, consulte[Conjuntos de configurações no AWS End User Messaging SMS](configuration-sets.md). ------ #### [ Create an Amazon SNS event destination (Console) ] Para criar um destino de evento do Amazon SNS usando o console SMS do AWS End User Messaging, siga estas etapas: 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**. 1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações ao qual adicionar um destino de evento. 1. Na página de **detalhes do conjunto de configurações**, escolha **Adicionar evento de destino**. 1. Na seção **Detalhes do evento**, insira um nome. 1. No menu suspenso **Tipo de destino**, escolha Amazon SNS. 1. **Novo tópico do Amazon SNS** — Escolha esta opção para enviar mensagens SMS ao usuário AWS final para criar um tópico em sua conta. O tópico é criado automaticamente com todas as permissões necessárias. Para obter mais informações sobre os tópicos do Amazon SNS, consulte [Configuração do Amazon SNS no Guia do desenvolvedor do Amazon](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) [Simple](https://docs.aws.amazon.com/sns/latest/dg/) Notification Service. 1. **Tópico **existente do Amazon SNS — Escolha essa opção se você tiver um tópico** existente do Amazon SNS no menu suspenso Tópico.** 1. Em **Tipos de eventos**, escolha: + **Todos os eventos de SMS (recomendado)** — Escolha essa opção para enviar todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS. + **Eventos de SMS personalizados** — Escolha dois eventos de SMS específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na **seleção Editar evento SMS**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**. + **Todos os eventos de voz (recomendado)** — Escolha essa opção para enviar todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS. + **Eventos de voz personalizados** — Escolha eventos de voz específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na **seleção Editar evento de voz**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**. + **Todos os eventos MMS (recomendado)** — Escolha essa opção para enviar todos os eventos MMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS. + Eventos **MMS personalizados — Escolha eventos** MMS específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos MMS**. Na **seleção Editar evento MMS**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**. 1. Escolha **Create event (Criar evento)**. ------ #### [ Create an Amazon SNS event destination (AWS CLI) ] Você pode usar o [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)comando para criar um destino de evento. ``` $ aws pinpoint-sms-voice-v2 create-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event-types eventTypes \ > --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic ``` No comando anterior, faça as seguintes alterações: + *eventDestinationName*Substitua por um nome descritivo para o destino do evento. + *configurationSet*Substitua pelo nome do conjunto de configurações ao qual você deseja associar o destino do evento. + *eventTypes*Substitua por um dos tipos de eventos listados em[Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md). + Substitua o valor de `TopicArn` pelo nome do recurso da Amazon (ARN) do tópico do Amazon SNS para o qual você deseja enviar eventos. ------ # Edite um destino de evento do Amazon SNS em AWS End User Messaging SMS Use o console AWS End User Messaging SMS ou AWS CLI edite um destino de evento do Amazon SNS. ------ #### [ Update an Amazon SNS event destination (Console) ] Para atualizar o destino de um evento SMS do AWS End User Messaging usando o console AWS End User Messaging SMS, siga estas etapas: 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**. 1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações ao qual adicionar um destino de evento. 1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações a ser editado. 1. **Na página de **detalhes do conjunto de configurações**, escolha um destino de evento do Amazon SNS e depois Edite.** 1. No menu suspenso **Tipo de destino**, escolha Amazon SNS. 1. **Novo tópico do Amazon SNS** — Escolha esta opção. AWS End User Messaging SMS cria um tópico em sua conta. O tópico é criado automaticamente com todas as permissões necessárias. Para obter mais informações sobre os tópicos do Amazon SNS, consulte [Configuração do Amazon SNS no Guia do desenvolvedor do Amazon](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) [Simple](https://docs.aws.amazon.com/sns/latest/dg/) Notification Service. 1. **Tópico **existente do Amazon SNS — Escolha essa opção se você tiver um tópico** existente do Amazon SNS no menu suspenso Tópico.** 1. Em **Tipos de eventos**, escolha: + **Todos os eventos de SMS (recomendado)** — Escolha essa opção para enviar todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS. + **Eventos de SMS personalizados** — Escolha esta opção e escolha eventos de SMS específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na **seleção Editar evento SMS**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**. + **Todos os eventos de voz (recomendado)** — Escolha essa opção para enviar todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS. + **Eventos de voz personalizados** — Escolha esta opção e escolha eventos de voz específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na **seleção Editar evento de voz**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**. + **Todos os eventos MMS (recomendado)** — Escolha essa opção para enviar todos os eventos MMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS. + **Eventos MMS personalizados** — Escolha esta opção e escolha eventos MMS específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos MMS**. Na **seleção Editar evento MMS**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**. 1. Escolha **Editar evento**. ------ #### [ Update an Amazon SNS event destination (AWS CLI) ] Você pode usar o [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)comando para atualizar o destino de um evento. O procedimento para atualizar um destino de evento do Amazon SNS é semelhante ao processo de criação de um destino de evento. **Para atualizar um destino de evento do Amazon SNS no AWS CLI** + Na linha de comando, execute o seguinte comando: ``` $ aws pinpoint-sms-voice-v2 update-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event types eventTypes \ > --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic ``` No comando anterior, faça as seguintes alterações: + *eventDestinationName*Substitua por um nome do destino do evento que você deseja modificar. + *configurationSet*Substitua pelo nome do conjunto de configurações ao qual você deseja associar o destino do evento. Você pode associar o destino do evento a um conjunto de configurações diferente. + *eventTypes*Substitua por um ou mais dos tipos de eventos listados em[Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md). + Substitua o valor de `TopicArn` pelo nome do recurso da Amazon (ARN) do tópico do Amazon SNS para o qual você deseja enviar eventos. ------ # Excluir um destino de evento do Amazon SNS em AWS End User Messaging SMS Use o console AWS End User Messaging SMS ou AWS CLI exclua um tópico do Amazon SNS. ------ #### [ Delete an Amazon SNS event destination (Console) ] O processo para excluir um destino de evento é o mesmo, independentemente do tipo de destino do evento que você deseja excluir. **Para excluir um destino de evento do Amazon SNS no console** 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**. 1. Na página **Conjuntos de configuração**, escolha o conjunto de configurações do qual remover um destino de evento. 1. Na seção **Todos os destinos**, escolha um destino para o evento e escolha **Excluir**. ------ #### [ Delete an Amazon SNS event destination (AWS CLI) ] Você pode usar o [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)comando para excluir o destino de um evento. O processo para excluir um destino de evento é o mesmo, independentemente do tipo de destino do evento que você deseja excluir. **Para excluir um destino de evento do Amazon SNS no AWS CLI** + Na linha de comando, execute o seguinte comando: ``` $ aws pinpoint-sms-voice-v2 delete-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSetName ``` No comando anterior, faça as seguintes alterações: + *eventDestinationName*Substitua pelo nome ou Amazon Resource Name (ARN) do destino do evento que você deseja excluir. + *configurationSetName*Substitua pelo nome ou ARN do conjunto de configurações ao qual o destino do evento está associado. ------