Task created
When a task is assigned to a bot, Automa initiates the process by sending a webhook notification.1
Send task created event
Automa sends a
task.created event to the bot’s webhook URL.2
Request access to code
Since the access to source code is managed by Automa, the bot must request temporary access to download and view the code necessary to implement the task.
3
Send code access details
Automa verifies the bot’s authorization and provides a short-lived, permission-scoped URL. This allows the bot to securely download the code required for the task.
4
Download code
The bot uses the provided URL to download the code and prepare for implementation.For the above 3 steps, you can use the
code.download method from the Bot SDK.Task implemented
Once the bot has the code, it can begin its work. After completing the task, it proposes the changes back to Automa.1
Propose code changes
The bot sends the completed work back to Automa as a diff, along with a title and description for the pull request.You can use the
code.propose method from the Bot SDK for this step.2
Create pull request
Automa creates a pull request in the source code repository, making the changes available for review.
Pull request merged
Once the pull request is merged, the task is considered complete.1
Pull request merged event
The source code host sends a pull request merged event to Automa.
2
Mark task completed
Automa updates the task’s status to “completed” in its system.
3
Send proposal accepted event
Automa sends a
proposal.accepted event to
the bot’s webhook URL, confirming that the proposed changes have been
successfully merged.