# Personal Connectors Billing

div
strong
🔨 In Development
 — This section is still being developed and may change.


Understand how personal connectors are billed and how to manage your usage and costs effectively.

## Overview

Personal connectors have associated costs based on usage. This guide explains the billing model, pricing tiers, and how to monitor and optimize your connector usage.

## Billing Model

### Usage-Based Pricing

Connectors are billed based on:

- **API Calls**: Each connector function call counts as usage
- **Data Transfer**: Amount of data processed through connectors
- **Compute Resources**: Processing power used for connector operations


### Billing Units

- **Connector Calls**: Each function invocation
- **Data Processing**: Measured in MB of data processed
- **Storage**: For connectors that cache or store data


## Pricing Tiers

### Free Tier

- **Included**: 100 connector calls per month
- **Data Limit**: 10 MB of data processing
- **Connectors**: Access to basic connectors (Notion, Google Workspace)
- **Support**: Community support


### Pro Tier ($19/month)

- **Included**: 1,000 connector calls per month
- **Data Limit**: 100 MB of data processing
- **Connectors**: All available connectors
- **Additional**: 500 calls for $5, 50 MB for $2
- **Support**: Email support


### Enterprise Tier (Custom Pricing)

- **Included**: Custom allocation based on needs
- **Connectors**: All connectors plus custom integrations
- **SLA**: 99.9% uptime guarantee
- **Support**: Dedicated support team


## Monitoring Usage

### Dashboard Monitoring

Monitor your connector usage through [Freddy Hub](https://freddy-hub.aitronos.com):

1. Navigate to **Usage & Billing**
2. Select **Personal Connectors** tab
3. View usage by connector type and time period


### API Usage Monitoring

Track usage programmatically:


```python
# Get usage statistics
usage = freddy.personal_connectors.get_usage(
    start_date="2024-01-01",
    end_date="2024-01-31",
    configuration_id="config_123"  # Optional: specific connector
)

print(f"Total calls: {usage.total_calls}")
print(f"Data processed: {usage.data_mb} MB")
print(f"Cost: ${usage.cost}")

# Usage by connector type
for connector_usage in usage.by_connector:
    print(f"{connector_usage.type}: {connector_usage.calls} calls")
```

### Real-Time Alerts

Set up alerts for usage thresholds:


```python
# Configure usage alerts
freddy.billing.set_alerts([
    {
        "metric": "connector_calls",
        "threshold": 800,
        "period": "monthly",
        "action": "email"
    },
    {
        "metric": "data_processing",
        "threshold": 80,
        "period": "monthly",
        "action": "email"
    }
])
```

## Cost Optimization

### Efficient Connector Usage

1. **Batch Operations**: Combine multiple calls into single requests when possible
2. **Caching**: Cache frequently accessed data to reduce API calls
3. **Selective Queries**: Use specific queries instead of broad searches
4. **Pagination**: Handle large datasets with pagination instead of single large requests


### Example Optimizations


```python
# Instead of multiple calls
for item in items:
    notion_connector.get_page(item.id)  # Multiple API calls

# Use batch operations
notion_connector.get_pages(item_ids)  # Single API call
```

### Data Processing Optimization


```python
# Instead of transferring large files
connector.download_file(file_id)  # Downloads entire file

# Use streaming for large data
for chunk in connector.stream_file(file_id):
    process_chunk(chunk)  # Process in chunks
```

## Billing Management

### Payment Methods

Add and manage payment methods in [Freddy Hub](https://freddy-hub.aitronos.com):

- Credit cards (Visa, MasterCard, American Express)
- PayPal
- Bank transfers (Enterprise only)
- Prepaid credits


### Billing History

View detailed billing history:


```python
# Get billing history
bills = freddy.billing.get_history(
    start_date="2024-01-01",
    end_date="2024-01-31"
)

for bill in bills:
    print(f"Date: {bill.date}")
    print(f"Amount: ${bill.amount}")
    print(f"Description: {bill.description}")
    print(f"Invoice: {bill.invoice_url}")
```

### Invoices and Receipts

- Automatic invoice generation for paid plans
- Download invoices in PDF format
- Email delivery of monthly statements
- Integration with accounting software


## Enterprise Features

### Advanced Billing

- **Custom Pricing**: Negotiated rates for high-volume usage
- **Consolidated Billing**: Single invoice for multiple accounts
- **Budget Management**: Set spending limits and alerts
- **Cost Centers**: Allocate costs to different departments


### Dedicated Support

- **Priority Support**: Fast-tracked support requests
- **Technical Account Manager**: Dedicated point of contact
- **Custom Integrations**: Build connectors for proprietary systems
- **SLA Guarantees**: Guaranteed uptime and response times


## Troubleshooting Billing Issues

### Common Issues

**Unexpected Charges**

- Review usage logs for unexpected connector activity
- Check for unused or misconfigured connectors
- Verify billing calculations in the dashboard


**Payment Failures**

- Update payment method information
- Check for insufficient funds or expired cards
- Contact support if payment method issues persist


**Usage Disputes**

- Provide detailed usage logs showing the discrepancy
- Include timestamps and descriptions of disputed activity
- Contact billing support with supporting evidence


### Getting Help

**Billing Support**

- Email: billing@aitronos.com
- Live chat: Available in [Freddy Hub](https://freddy-hub.aitronos.com)
- Phone: Enterprise customers only


**Technical Issues**

- Check [status.aitronos.com](https://status.aitronos.com) for service outages
- Review connector documentation for known issues
- Contact technical support for integration problems


## Cost Calculator

Estimate your connector costs before implementation:


```python
def estimate_connector_costs(config):
    """Estimate monthly costs for connector usage."""

    # Base costs by connector type
    base_costs = {
        "notion": 0.001,      # per call
        "google_workspace": 0.002,
        "slack": 0.001,
        "github": 0.001,
        "database": 0.005,
        "custom_api": 0.01
    }

    total_calls = config.get("estimated_calls", 1000)
    connector_type = config.get("connector_type", "notion")

    base_cost = base_costs.get(connector_type, 0.001) * total_calls

    # Data processing costs
    data_mb = config.get("estimated_data_mb", 50)
    data_cost = data_mb * 0.02  # $0.02 per MB

    return {
        "base_cost": base_cost,
        "data_cost": data_cost,
        "total_monthly": base_cost + data_cost,
        "assumptions": {
            "calls_per_month": total_calls,
            "data_mb_per_month": data_mb
        }
    }

# Example usage
config = {
    "connector_type": "notion",
    "estimated_calls": 2000,
    "estimated_data_mb": 100
}

costs = estimate_connector_costs(config)
print(f"Estimated monthly cost: ${costs['total_monthly']:.2f}")
```

## Next Steps

- [Connectors Overview](/docs/documentation/personal-connectors/overview) - Learn about available connectors
- [Usage Guide](/docs/documentation/personal-connectors/usage) - How to use connectors effectively
- [Authentication](/docs/documentation/personal-connectors/authentication) - Set up your connectors
- [API Reference](/docs/api-reference/personal-connectors/list) - Technical details


For billing questions, contact [billing@aitronos.com](mailto:billing@aitronos.com).