ElevenLabs Get Signed URL

Generate a signed WebSocket URL for an ElevenLabs Conversational AI agent. Accepts an agent ID as input, requests a signed URL from ElevenLabs, and returns the signed URL in a JSON response for use in establishing real-time conversations.

Report this template

Select the reason for reporting

Describe the issue in detail

Share template

Link to template

https://templates.buildship.com/template/JPWdXp2a1xb5/

By FlutterFlow

Inputs

Agent ID

1234abcd-5678-efgh-9012-ijklmnopqrst

This is a static example using sample inputs. Remix the template to run it with your own values.

Output

Read me

📖 ElevenLabs Conversational AI - Secure WebSocket URL Workflow

Overview

This BuildShip workflow provides a secure backend solution for integrating ElevenLabs Conversational AI into your FlutterFlow applications. It acts as a proxy that keeps your ElevenLabs API key secure on the server-side while providing signed WebSocket URLs to your Flutter app for real-time voice conversations.

Purpose

When implementing ElevenLabs Conversational AI in a client-side application, exposing your API key directly in the app code poses a significant security risk. This workflow solves that problem by:

Storing your ElevenLabs API key securely in BuildShip's backend
Providing a public endpoint that your FlutterFlow app can call
Returning signed WebSocket URLs that allow direct communication with ElevenLabs agents
Eliminating the need to embed API keys in your mobile/web application

Workflow Components

1. REST API Trigger

Method: GET
Path: /GetSignedUrl
Input Parameter: agentId (query parameter)
Content Type: application/json

2. Get Signed WebSocket URL Node

Fetches a signed WebSocket URL from ElevenLabs API
Uses the securely stored API key from BuildShip integrations
Returns the signed URL for establishing WebSocket connections

Setup Instructions

Step 1: Import the Workflow

Copy the provided workflow JSON
In BuildShip, create a new workflow or import the JSON
The workflow will automatically create the necessary nodes

Step 2: Configure ElevenLabs API Key

In the BuildShip workflow, click on the "Get Signed WebSocket URL" node
Click on the integration key dropdown
Select "Add New Integration Key" or choose an existing ElevenLabs key
Enter your ElevenLabs API key (found in your ElevenLabs dashboard under Profile Settings)
Save the integration

Step 3: Deploy the Workflow

Click the "Deploy" button in BuildShip
Copy the generated endpoint URL (it will look like: https://your-project.buildship.run/GetSignedUrl)

Step 4: Configure Your ElevenLabs Agent

Log into your ElevenLabs account
Create or select a Conversational AI agent
Note down the Agent ID (format: agent_01jzmvwhxhf6kaya6n6zbtd0s1)

Usage in FlutterFlow

API Call Setup

In FlutterFlow, create an API call with these settings:
- Method: GET
- URL: https://your-project.buildship.run/GetSignedUrl
- Query Parameters:
  - Name: agentId
  - Value: Your ElevenLabs agent ID

Example API Call

GET https://your-project.buildship.run/GetSignedUrl?agentId=agent_01jzmvwhxhf6kaya6n6zbtd0s1

Response Format

{ "signedUrl": "wss://api.elevenlabs.io/v1/convai/conversation?agent_id=your-agent-id&conversation_signature=your-token" }

Implementing in FlutterFlow

Create a function to call your BuildShip endpoint
Extract the signedUrl from the response
Use this URL to establish a WebSocket connection for voice conversations
The signed URL is temporary and should be fetched when needed

Security Considerations

API Key Protection: Your ElevenLabs API key is never exposed to the client
Signed URLs: The returned WebSocket URLs are signed and time-limited
Agent ID Validation: Only valid agent IDs associated with your account will work
HTTPS Only: All communication happens over secure HTTPS/WSS protocols

Troubleshooting

Common Issues

"ElevenLabs API key is required" Error
- Ensure you've configured the API key in the BuildShip integration settings
- Verify the key is valid and active in your ElevenLabs account
"Agent ID is required" Error
- Make sure you're passing the agentId as a query parameter
- Check that the parameter name is exactly agentId (case-sensitive)
Invalid Agent ID
- Verify the agent ID matches one created in your ElevenLabs account
- Ensure the agent is active and properly configured
Connection Issues
- Check that your BuildShip workflow is deployed
- Verify the endpoint URL is correct
- Ensure your ElevenLabs account has sufficient credits

Best Practices

Error Handling: Implement proper error handling in your FlutterFlow app for API failures
Caching: Don't cache signed URLs for extended periods as they may expire
Rate Limiting: Be mindful of API rate limits on both BuildShip and ElevenLabs
Monitoring: Use BuildShip's logs to monitor usage and troubleshoot issues

Support

BuildShip Documentation: https://docs.buildship.com
ElevenLabs Documentation: https://docs.elevenlabs.io
FlutterFlow Documentation: https://docs.flutterflow.io

License

This workflow is provided as-is for use with the ElevenLabs Conversational AI Library in FlutterFlow. Ensure you comply with both ElevenLabs' and BuildShip's terms of service.