The documentation covers the Sinric Pro WebSocket messaging protocol. All messages sent over the WebSocket protocol is in JSON format and they are signed using HMAC key to guarante the authenticity of the request. Sample message definitions are available here
We recommend using one of the SDKs we have built since they properly handle authentication, connection, reconnection and many more feature for messaging layer. We have libraries written for Arduino, ESP8266, ESP32, RaspberryPI, and PC
replyToken in the request is being used to identify the message. It must be used when you create a “response” type message
createdAt timestamp is the Unix time in seconds
If you are using the SDK, the responses will be handled by the SDK internally
Upon receiving this message in the server, the server will update the interested parties about the status of the request .
Let’s imagine you want to turn on the device by pushing a button or change the brightness level using a nob. Now you are interacting with the device physically and making changes to it. To notify the server about the changes you make, you can send an event message to the server. Eg: Amazon Alexa cloud
The user change the device state physically. Eg: push a button to turn on the switch.
Your IOT module creates an event message and send it to Sinric Pro IOT Platform. (In this case your IOT module sends setPowerState event)
The Sinric Pro IOT platform update the device status and update Alexa service
Sinric Pro IOT platform will report any changes you do via events, app or API to Alexa as well.
The Amazon Alexa sends a message to the Sinric Pro IOT Platform. eg: Turn on [device name]
The Sinric Pro IoT platform creates a request type message with appropriate action (in this case setPowerState) and send it to your IoT hardware module.
Your IoT hardware module responds back to the Sinric Pro IOT Platform with success or failed status.
If you fail to respond with in 8 seconds / or device is offline, then the request will timeout and Alexa will say “Device is unresponsive”.
The Sinric Pro IoT platform updates the device status according to your response and updates Alexa service.
This document is open source. See a typo? Please create an issue