RetellAI icon

RetellAI

Interact with RetellAI API

Actions21

Overview

This node integrates with the RetellAI API, enabling users to interact programmatically with various RetellAI resources such as Agents, Calls, Concurrency settings, Knowledge Bases, LLMs, Phone Numbers, and Voices. Specifically, for the Agent - Get operation, it retrieves detailed information about a particular agent by its unique identifier.

Common scenarios include:

  • Fetching configuration or status details of an AI agent within RetellAI.
  • Integrating agent data retrieval into automated workflows for monitoring or reporting.
  • Using agent information to dynamically adjust subsequent workflow steps based on agent properties.

Example: A user wants to get the current settings or metadata of a specific agent to verify its setup before triggering further actions like updates or calls.

Properties

Name Meaning
Agent ID The unique identifier of the agent to retrieve. This is required to specify which agent's details should be fetched.

Output

The node outputs JSON data representing the retrieved agent's details from the RetellAI API. This typically includes all relevant fields describing the agent's configuration, status, and metadata as returned by the API.

If the node supports binary data output (not indicated here), it would represent any associated files or media related to the agent, but this is not applicable for the "Get Agent" operation.

Dependencies

  • Requires an active connection to the RetellAI API.
  • Needs an API authentication token configured in the node credentials to authorize requests.
  • The base URL for API requests is https://api.retellai.com.
  • The node depends on internal helper functions to handle API operations and credential validation.

Troubleshooting

  • Common issues:

    • Invalid or missing Agent ID: The node requires a valid agent identifier; ensure the ID is correct and exists in your RetellAI account.
    • Authentication errors: Verify that the API key or token is correctly set up and has sufficient permissions.
    • Network or connectivity problems: Ensure the n8n instance can reach https://api.retellai.com.

  • Error messages:

    • "error": "Agent not found": Indicates the specified Agent ID does not exist. Double-check the ID.
    • Authentication failures will typically return HTTP 401 or 403 errors; reconfigure credentials accordingly.
    • Timeout or network errors suggest connectivity issues; retry or check network settings.

Links and References

Discussion