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

  1. 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.
  2. 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.
  3. Send exactly one result: completed, or failed with the reason. The task’s page shows that reason.
  4. 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.
  5. Send a ping at least every 30 seconds, so the task’s page can show the robot is connected.