How a robot receives tasks
What your robot’s software must do to receive tasks from Robsy, answer them and report how they went.
Steps
- Connect the robot to its command socket with its device token in the X-Device-Token header, and answer the safety policy Robsy sends first.
- Answer every task within 10 seconds of receiving it, and send started when the work begins. A robot that says nothing about a task for 60 seconds loses it to another robot.
- Send exactly one result: completed, or failed with the reason. The task’s page shows that reason.
- When Robsy sends a cancel, stop and report the task cancelled. A rejected answer means the task is no longer the robot’s: stop it.
- Send a ping at least every 30 seconds, so the task’s page can show the robot is connected.