Overview
This node integrates with the original.land AI agent platform, allowing users to send messages to a specified bot and receive responses. It is useful for automating conversations, querying AI agents, or embedding AI-driven chat capabilities within n8n workflows. For example, you can use it to ask questions, get AI-generated answers, or interact with custom AI bots hosted on original.land.
Properties
| Name | Meaning |
|---|---|
| Bot ID | The unique identifier of the original.land bot you want to communicate with. |
| API Key | The API key used to authenticate requests to the original.land service. |
| Message | The message text to send to the original.land AI agent. |
| Bot Endpoint | The base URL of the original.land API endpoint (default: https://api.original.land). |
| Streaming | Whether to receive the response as a streaming output (true/false). |
Output
The node outputs JSON data with the following structure inside each item:
originalAgent: An object containing:response: The AI agent's reply. If streaming is disabled, this is parsed content extracted from the raw response; if streaming is enabled, it contains the raw streaming response string.streaming: A boolean indicating if the response was streamed.conversationId: A conversation identifier returned by the API in the response headers.
Additionally, the output includes the original input fields:
botId: The bot ID used.message: The message sent (with capitalization normalized).
If streaming is enabled, the response is raw and marked accordingly; otherwise, the response is parsed to extract meaningful text or JSON from the API's reply.
Dependencies
- Requires an active internet connection to reach the original.land API endpoint.
- Needs a valid API key credential for authentication.
- No additional external libraries beyond standard n8n workflow helpers are required.
Troubleshooting
- Payment Required / Insufficient Credit: If the API returns a 402 status code with an "INSUFFICIENT_CREDIT" description, it means the account associated with the API key lacks sufficient credit. To resolve, top up your account or check billing status.
- API Errors (HTTP 4xx/5xx): Other HTTP errors indicate issues contacting the AI service. Verify the API key, bot ID, and endpoint URL are correct.
- Malformed Responses: If the response cannot be parsed, ensure the message format and parameters are valid.
- Streaming Issues: When enabling streaming, the response is raw and may require special handling downstream.
Links and References
- original.land API Documentation (assumed based on endpoint)
- n8n documentation on Creating Custom Nodes