Overview
This node integrates with the gotoHuman service to request human reviews based on predefined review templates. Specifically, the "Send and Wait for Response" operation sends a review request using a selected template, waits for the human review to be completed, and then returns the response data via a webhook.
Common scenarios where this node is beneficial include:
- Automating quality assurance by sending content or data for human verification.
- Collecting expert feedback on documents, images, or other assets.
- Integrating human-in-the-loop review processes into automated workflows.
For example, you might use this node to send a product description to a team of reviewers and wait until they provide feedback before proceeding with publishing.
Properties
| Name | Meaning |
|---|---|
| Review Template | Choose a review template from the list or specify its ID. This template defines the structure and fields of the review request. |
| Fields | Map the input data fields to the fields defined in the selected review template. These are the values sent for review. |
| Meta Data | Optionally add metadata to receive back in the response webhook. Options: No Meta Data, Add as JSON, Add as Key-Value Pairs. |
| Meta Data JSON | If "Add as JSON" is selected, enter a JSON object representing metadata key-value pairs. |
| Meta Data Values | If "Add as Key-Value Pairs" is selected, add one or more metadata key-value pairs individually. |
| Assigned Users | Select who to assign the review to: either all users in your account or only selected users by email. |
| Selected Users | If assigning to selected users, list their email addresses here. Only registered users' emails are accepted. |
| Additional Fields | Extra optional fields such as "Update for Review ID" to update an existing review instead of creating a new one. |
Output
The node outputs a JSON object containing the response from the gotoHuman API after sending the review request. The output includes details such as:
- Status code and message from the API.
- Timeout duration (in milliseconds) indicating how long the node will wait for the review response.
- Any identifiers or URLs related to the created review request.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the gotoHuman API.
- Needs network access to
https://api.gotohuman.com. - The node uses a webhook URL generated dynamically to receive the review response asynchronously.
- The workflow must allow waiting execution since the node pauses until the review response arrives or times out.
Troubleshooting
- No review templates found: Ensure you have created at least one review template in the gotoHuman web app before using the node.
- No fields found for review template: The selected review template must have defined fields; add them in the web editor.
- Invalid JSON in Meta Data JSON or field values: Check that any JSON entered is valid and properly formatted.
- Emails not accepted when assigning users: Only emails of registered users in your gotoHuman account are valid.
- API errors (4xx or 5xx status codes): Verify your API credentials, network connectivity, and that the request payload conforms to the API requirements.
- Timeout issues: The node respects a timeout value returned by the API; if the review takes longer, consider adjusting retry logic or handling timeouts in your workflow.