Beyond Presence

Deploy video agents with Beyond Presence

Actions2

Agent Actions
- Create
Webhook Actions
- Handle Event

Overview

This node integrates with Beyond Presence, a platform for deploying video agents. Specifically, the Agent - Create operation allows users to deploy a new virtual agent configured with customizable properties such as avatar, language, greeting message, and capabilities.

Typical use cases include:

Creating personalized AI assistants or customer support agents with specific avatars and languages.
Deploying agents that can interact via video with users, optionally enhanced with webcam vision capabilities.
Setting session limits and custom system prompts to tailor agent behavior.

For example, a user could create an English-speaking agent named "Support Bot" with a friendly greeting and webcam vision enabled to assist customers on a website.

Properties

Name	Meaning
Avatar ID	The unique identifier of the avatar image/model used to represent the agent visually.
System Prompt	The initial instruction or context given to the agent to guide its responses.
Name	The display name assigned to the agent.
Language	The language in which the agent will communicate. Options: Arabic, Chinese, English, French, German, Italian, Japanese, Korean, Portuguese, Russian, Spanish.
Greeting	The opening message the agent uses to greet users when a session starts.
Max Session Length (Minutes)	The maximum duration (in minutes) allowed for a single interaction session with the agent.
Capabilities	Additional features enabled for the agent. Currently supports "Webcam Vision" to allow visual input from a webcam.

Output

The node outputs JSON data representing the created agent's details as returned by the Beyond Presence API. This includes at least:

Agent ID and metadata.
A direct link to the agent’s call interface (call_link).
Other response fields as provided by the API.

No binary data output is produced by this operation.

Example output snippet (simplified):

{
  "id": "agent_12345",
  "name": "My Agent",
  "call_link": "https://bey.chat/agent_12345",
  ...
}

Dependencies

Requires an API key credential for Beyond Presence to authenticate requests.
Makes HTTP POST requests to https://api.bey.dev/v1/agent endpoint.
The node expects the API key to be configured in n8n credentials for Beyond Presence.

Troubleshooting

Missing or invalid API key: The node will fail if the API key credential is not set or invalid. Ensure the API key is correctly configured.
Invalid property values: For example, providing an empty string for required fields like Avatar ID or Name may cause API errors.
Network issues: Connectivity problems to https://api.bey.dev will prevent agent creation.
API errors: If the Beyond Presence API returns an error, it will be surfaced in the node output. Check the error message for details.
Continue On Fail: If enabled, the node will continue processing other items even if one fails, returning error details per item.

Links and References

Beyond Presence API Documentation (assumed based on base URL)
n8n HTTP Request Node Documentation (for understanding HTTP request usage)

This summary is based solely on static analysis of the provided source code and property definitions.

Beyond PresenceInstall