The Hologram Dashboard and API provide ways to simulate messages coming from a device with any data and topics. Simulated messages will trigger routes just as any real message from a device. This effectively eliminates the need to use a physical device and connection to debug and control the effects of its communication, namely Routes.
From the dashboard
- From the SIMs page, find the SIM you’d like to simulate and click on it to view the SIM details page.
- Open the Manage SIM menu in the top right of the page, and select the Simulate message to API option.
- A modal will display, letting you enter route topics and a payload to send in your message.
Note: A simulated message will automatically include the REST_API
and DEVICE_<id>
topics.
After successfully submitting the form, open the Activity drawer at the bottom of your dashboard to see your message. If you want to see all the routes triggered by this message, make sure All activity is selected in the console filters.
You can easily run a previously logged device message by clicking the Simulate button shown in the above screenshot from the outbound message row in the console, which will take you back to the simulate form with the fields pre-filled for you.
Note: Simulating topics, such as _SIMPLESTRING_
or _SMS_
, is currently not allowed.
From the API
Under the hood, the dashboard is using Hologram’s REST API. The documentation for this endpoint is here.