Settings

Manage your workspace configuration, API access, and team members.

Limits

Configure resource limits for your workspace:

Concurrent Calls

Control how many simultaneous calls your agents can handle:

• Current Limit - Your allocated concurrent call capacity
• Adjust - Increase or decrease the limit
• Cost - $8/additional call/month

Provider Limits

Set Calls Per Second (CPS) limits by provider:

Note: Changes may take up to 5 minutes to propagate.

API Keys

Generate and manage API keys for programmatic access:

Creating an API Key

1. Go to Settings → API Keys
2. Click Generate API Key
3. Copy and securely store the key

Important: API keys are only shown once. Store them securely.

Managing Keys

API Authentication

Include your API key in requests:

curl -X GET https://api.call2fly.ai/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY"

Webhooks

Configure webhook endpoints to receive real-time events:

Configuration

1. Go to Settings → Webhooks
2. Enter your webhook URL
3. Set timeout (1-30 seconds)
4. Save configuration

Testing

Click Test Webhook to send a test payload to your endpoint.

Events

Webhooks can notify you of:

• Call started/ended
• Chat message received
• Agent function called
• Error occurred

Example Payload

{
  "event": "call.ended",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "call_id": "abc123",
    "agent_id": "agent_456",
    "duration": 180,
    "status": "completed"
  }
}

Workspace Settings

General

Deleting a Workspace

Warning: This action is irreversible.

1. Go to Settings → Workspace → General
2. Scroll to Delete Workspace
3. Confirm deletion

Only workspace owners can delete workspaces.

User Management

Manage team members and their access levels.

Roles

Inviting Users

1. Go to Settings → Workspace → Users
2. Click Invite Member
3. Enter email address
4. Select role
5. Send invitation

Managing Members

Leaving a Workspace

Members can leave workspaces they don't own:

1. Go to Settings → Workspace → Users
2. Click Leave Workspace
3. Confirm

Billing

View and manage your billing information:

Billing History

• View past invoices
• See invoice amounts and status (Paid, Pending)
• Download invoice PDFs

Usage

Track your current usage:

Cost Breakdown

View costs by:

• Time Period - Daily/weekly charts
• Provider - Twilio, Telnyx breakdown
• Category - Voice, SMS, etc.

Payment Management

• Update PO Number - Set purchase order for invoices
• Payment Methods - Update credit card or billing info
• Stop Service - Cancel your subscription

Security Best Practices

API Keys

1. Rotate regularly - Generate new keys periodically
2. Limit scope - Use minimal required permissions
3. Never commit - Don't store keys in code repositories
4. Monitor usage - Check for unauthorized access

Webhooks

1. Use HTTPS - Always use secure endpoints
2. Validate signatures - Verify webhook authenticity
3. Handle timeouts - Respond within the timeout period

Access Control

1. Principle of least privilege - Give minimum required access
2. Regular audits - Review member permissions periodically
3. Remove inactive users - Clean up departed team members

Next Steps

• Create your first agent
• Set up phone numbers
• View analytics