BookedInInstall

Overview

This node integrates with the BookedIn AI platform to manage and interact with various resources such as agents, leads, lists, strategies, campaigns, and human messages. Specifically, for the Agent - Get operation, it retrieves detailed information about a single AI agent by its unique ID.

Use cases include:

• Fetching configuration and status of a specific AI agent.
• Retrieving an agent’s objective, prompt, model, and webhook settings.
• Integrating agent data into workflows for monitoring or further processing.

Example: You have an AI agent that books meetings for your sales team. Using this node, you can get the current setup and details of that agent to verify or log its configuration.

Properties

Output

The node outputs a JSON object representing the agent's full details as returned by the BookedIn API. This typically includes fields such as:

• id: The agent's unique ID.
• name: Human-readable name of the agent.
• agent_config: Configuration object containing:
  • objective: The main goal or purpose of the agent.
  • prompt: Core instructions and personality for the AI.
  • model: The AI model used (e.g., GPT-4o).
  • update_lead_fields: Boolean indicating if the agent updates lead fields.
  • webhook_url (optional): URL for receiving agent events.

No binary data output is produced by this operation.

Dependencies

• Requires an API key credential for authenticating requests to the BookedIn API.
• The node makes HTTP requests to https://api.bookedin.ai/api/v1/agents/{agentId} endpoint.
• Proper network access to the BookedIn API service is necessary.
• No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

• Common issues:

  • Invalid or missing Agent ID will cause the request to fail.
  • Network connectivity problems may prevent reaching the BookedIn API.
  • Authentication errors if the API key credential is invalid or expired.

• Error messages:

  • "404 Not Found": The specified Agent ID does not exist. Verify the ID is correct.
  • "401 Unauthorized": Authentication failed. Check the API key credential.
  • "Invalid JSON format": Not applicable for this operation but relevant in other operations where JSON input is required.

• Resolution tips:

  • Double-check the Agent ID format and value.
  • Ensure the API key credential is correctly configured and has proper permissions.
  • Test network connectivity to the BookedIn API endpoint.
  • Use the node’s "Continue On Fail" option to handle errors gracefully in workflows.

Links and References

• BookedIn API Documentation (general reference for API endpoints and usage)
• n8n Documentation on HTTP Request Node (for understanding underlying HTTP calls)
• OpenAI Models (context on AI models like GPT-4o used by agents)