How to Find Your Workspace ID in Edesy Voice Agent Platform

If you're integrating Edesy Voice Agents with your existing systems, you've probably encountered the need for a workspace ID. This unique identifier is essential for API calls, webhook configurations, and even support requests.

In this guide, we'll show you exactly where to find your workspace ID and how to use it effectively.

What is a Workspace ID?

A workspace ID is a unique identifier assigned to your workspace in Edesy. Think of it as your workspace's fingerprint - no two workspaces share the same ID.

Example workspace ID: clx1abc2def3ghi4jkl5mno6pqr

Every API request, webhook payload, and integration needs this ID to know which workspace to interact with.

Why Do You Need Your Workspace ID?

Here are the most common scenarios where you'll need your workspace ID:

1. Webhook Configuration

When setting up webhooks to receive call events, your workspace ID is part of the URL:

https://voice-agent.edesy.in/api/webhook/twilio/{YOUR_WORKSPACE_ID}

2. API Integration

Making programmatic calls to the Edesy API requires your workspace ID:

const response = await fetch('https://voice-agent.edesy.in/api/v1/calls', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    workspace_id: 'YOUR_WORKSPACE_ID',
    agent_id: 'agent_123',
    to: '+919876543210'
  })
});

3. BYOP (Bring Your Own Provider) Setup

Configuring your own Twilio, Exotel, or Plivo account requires workspace ID in the webhook URLs.

4. Support Requests

Including your workspace ID helps our support team quickly locate your account and resolve issues faster.

Where to Find Your Workspace ID

We've made it easy to find your workspace ID in two convenient locations.

Method 1: Settings Page (Recommended)

The Settings page provides the most comprehensive view with a dedicated copy button.

Steps:

1. Log in to your Edesy dashboard
2. Click Settings in the sidebar
3. In the General tab, find the "Workspace Information" section
4. Look for the Workspace ID field
5. Click the Copy button to copy it to your clipboard

The Settings page shows your workspace ID in a clear, read-only field with a one-click copy button. You'll see a confirmation message: "Workspace ID copied to clipboard."

Method 2: Workspace Overview Page

For quick access, the workspace ID is also displayed on the Workspace Overview page.

Steps:

1. Click Workspace in the sidebar
2. Look at the overview card at the top
3. Your workspace ID is displayed below the plan badge
4. Click the small copy icon next to the ID

This method is faster if you're already on the Workspace page, though the ID is displayed in a more compact format.

Best Practices for Using Your Workspace ID

Keep It Secure

While workspace IDs aren't secret (they appear in webhook URLs), you should still follow security best practices:

• Don't share workspace IDs in public repositories
• Use environment variables in your code
• Combine with API key authentication for secure access

Store It in Environment Variables

# .env file
EDESY_WORKSPACE_ID=clx1abc2def3ghi4jkl5mno6pqr
EDESY_API_KEY=your_api_key_here

// In your code
const workspaceId = process.env.EDESY_WORKSPACE_ID;

Verify Before Using

Always double-check you've copied the correct workspace ID, especially if you have multiple workspaces. The ID is case-sensitive.

Common Use Cases

Setting Up Twilio Webhooks

When configuring Twilio for inbound calls:

1. Go to your Twilio Console
2. Navigate to Phone Numbers > Manage > Active Numbers
3. Set the webhook URL to:

   https://voice-agent.edesy.in/api/webhook/twilio/YOUR_WORKSPACE_ID

Receiving Call Events

Configure your server to receive webhook events:

app.post('/webhooks/edesy', (req, res) => {
  const { workspace_id, call_id, event } = req.body;
 
  // Verify the workspace ID matches yours
  if (workspace_id !== process.env.EDESY_WORKSPACE_ID) {
    return res.status(403).json({ error: 'Invalid workspace' });
  }
 
  // Process the event
  console.log(`Call ${call_id}: ${event}`);
  res.status(200).json({ received: true });
});

Multi-Workspace Management

If you manage multiple workspaces (e.g., for different clients):

1. Use the workspace switcher in the sidebar to select each workspace
2. Copy each workspace ID
3. Store them with descriptive names:

WORKSPACE_ID_CLIENT_A=clx1abc...
WORKSPACE_ID_CLIENT_B=cly2def...
WORKSPACE_ID_DEVELOPMENT=clz3ghi...

Troubleshooting

Can't See the Workspace ID?

• Not logged in: Ensure you're authenticated
• No workspace selected: Use the workspace switcher to select a workspace
• New account: Create a workspace first if you haven't already

Copy Button Not Working?

• Grant clipboard permissions to your browser
• Try selecting the text manually and using Ctrl+C / Cmd+C
• Use a modern browser (Chrome, Firefox, Safari, Edge)

Wrong Workspace ID Copied?

If API calls are failing, verify:

1. The workspace ID matches your current workspace
2. You haven't accidentally copied extra whitespace
3. The ID is being passed correctly in your code

Summary

Finding your workspace ID in Edesy is straightforward:

Your workspace ID is essential for:

• API integrations
• Webhook configurations
• BYOP telephony setup
• Support requests

Now that you know where to find it, you're ready to integrate Edesy Voice Agents with your systems!

Next Steps

• Complete Workspace Documentation - Learn more about workspace management
• API Reference - Full API documentation
• Webhook Configuration - Set up event webhooks
• BYOP Setup Guide - Configure your own telephony

Need help? Our support team is ready to assist. Include your workspace ID when reaching out for faster resolution.

Get Started with Edesy | View Documentation