# Notificações de eventos para AWS IoT Wireless
<a name="iot-wireless-events"></a>

AWS IoT Wireless pode publicar mensagens para notificar você sobre eventos nos dispositivos LoRaWAN e Sidewalk que você integra ao AWS IoT Core. Por exemplo, você pode receber notificações de eventos, como quando os dispositivos do Sidewalk em sua conta foram provisionados ou registrados.

## Como seus recursos podem ser notificados sobre eventos
<a name="iot-wireless-events-mqtt"></a>

As notificações de eventos são publicadas quando determinados eventos ocorrem. Por exemplo, os eventos são gerados quando seu dispositivo Sidewalk é provisionado. Cada evento faz com que uma única notificação de evento seja enviada. As notificações de eventos são publicadas por meio do MQTT com uma carga JSON. O conteúdo da carga depende do tipo do evento.

**nota**  
As notificações de eventos são publicadas pelo menos uma vez. É possível que elas sejam publicadas mais de uma vez. A ordenação das mensagens de eventos não é garantida.

### Tipos de eventos e recursos
<a name="iot-wireless-events-types"></a>

A tabela a seguir exibe os diferentes tipos de eventos para os quais você receberá notificações. Os tipos de eventos também dependem do tipo de recurso ser um dispositivo sem fio, um gateway sem fio ou uma conta do Sidewalk. Você também pode ativar eventos para seus recursos no nível do recurso, o que se aplica a todos os recursos de um tipo específico, ou para recursos selecionados, conforme descrito na seção a seguir. Para obter mais informações sobre os diferentes tipos de eventos, consulte [Notificações de eventos para recursos LoRaWAN](iot-lorawan-events.md) e [Notificações de eventos para recursos do Sidewalk](iot-sidewalk-events.md).


**Tipos de eventos com base nos recursos**  


- **Dispositivo sem fio**
  - **Tipo de recurso:** LoRaWAN / **Tipo de evento:** Ingressar
  - **Tipo de recurso:** Sidewalk / **Tipo de evento:**  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/iot-wireless-events.html) 

- **Gateway sem fio**
  - **Tipo de recurso:** LoRaWAN
  - **Tipo de evento:** Status de conexão

- **Conta Sidewalk**
  - **Tipo de recurso:** Sidewalk
  - **Tipo de evento:**  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/iot-wireless-events.html) 



### Política para receber notificações de eventos sem fio
<a name="iot-wireless-events-policy"></a>

Para receber notificações de eventos, o dispositivo deve utilizar uma política adequada que permita que ele se conecte ao gateway de dispositivos do AWS IoT e assine os tópicos de evento do MQTT. Você também deve assinar os filtros apropriados dos tópicos.

Veja a seguir um exemplo da política necessária para receber notificações para os vários eventos sem fio.

```
{
    "Version":"2012-10-17",
    "Statement":[{
        "Effect":"Allow",
        "Action":[
            "iot:Subscribe",
            "iot:Receive"
        ],
        "Resource":[
            "arn:aws:iotwireless:{{region}}:{{account}}:/$aws/iotwireless/events/join/*",
            "arn:aws:iotwireless:{{region}}:{{account}}:/$aws/iotwireless/events/connection_status/*"
            "arn:aws:iotwireless:{{region}}:{{account}}:/$aws/iotwireless/events/device_registration_state/*", 
            "arn:aws:iotwireless:{{region}}:{{account}}:/$aws/iotwireless/events/proximity/*"
        ]
    }]
}
```

### Formato dos tópicos do MQTT para eventos sem fio
<a name="iot-wireless-message-format"></a>

Para enviar notificações de eventos para seus recursos sem fio, o AWS IoT usa tópicos reservados do MQTT que começam com um cifrão ($). Você pode se inscrever e publicar nesses tópicos reservados. Entretanto, não é possível criar tópicos que comecem com um cifrão.

**nota**  
Os tópicos do MQTT são específicos para sua Conta da AWS e usam o formato`arn:aws:iotwireless:{{aws-region:AWS-account-ID}}:topic/Topic`. Para obter mais informações, consulte [MQTT topics](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) no *Guia do desenvolvedor do AWS IoT*.

Os tópicos reservados do MQTT para dispositivos sem fio usam o seguinte formato:
+ 

**Tópicos em nível de recurso**  
Esses tópicos se aplicam a todos os recursos de um tipo específico em sua Conta da AWS que você integrou à AWS IoT Wireless.

  `$aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/resources`
+ 

**Tópicos em nível de identificador**  
Esses tópicos se aplicam a recursos selecionados de um tipo específico em sua Conta da AWS que você integrou à AWS IoT Wireless, especificados pelo identificador de recursos.

  `$aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/{resourceIdentifierType}/{resourceID}/{id}`

Para obter mais informações sobre tópicos a nível de recurso e identificador, consulte [Configurações do evento](iot-wireless-control-events.md#iot-wireless-control-events-config).

A tabela a seguir mostra exemplos de tópicos do MQTT para os vários eventos:


**Eventos e tópicos do MQTT**  

| Evento | Tópico do MQTT | Observações | 
| --- | --- | --- | 
| Estado de registro do dispositivo Sidewalk |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/iot-wireless-events.html)  | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/iot-wireless-events.html) | 
| Proximidade do Sidewalk |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/iot-wireless-events.html)  | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/iot-wireless-events.html) | 
| Junção LoRaWAN |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/iot-wireless-events.html)  | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/iot-wireless-events.html) | 
| Status de conexão do gateway LoRaWAN |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/iot-wireless-events.html)  | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/iot-wireless-events.html) | 

Para obter mais informações sobre diferentes eventos, consulte [Notificações de eventos para recursos LoRaWAN](iot-lorawan-events.md) e [Notificações de eventos para recursos do Sidewalk](iot-sidewalk-events.md).

Se você se inscreveu nesses tópicos, receberá uma notificação quando uma mensagem for publicada em um dos tópicos de notificação do evento. Para obter mais informações, consulte [MQTT reserved topics](https://docs.aws.amazon.com/iot/latest/developerguide/reserved-topics.html) no *Guia do desenvolvedor do AWS IoT*.

## Preços para eventos sem fio
<a name="iot-wireless-events-pricing"></a>

Para obter informações sobre preços para se inscrever em eventos e receber notificações, consulte [preços do AWS IoT Core](https://aws.amazon.com/iot-core/pricing/).