Skip to main content

Account Management

Manage multiple client accounts and organizations within your SquawkVoice platform. Create, configure, and administer accounts for different clients, departments, or business units with comprehensive control and oversight.

Overview

Account management enables you to organize and administer multiple client accounts within a single SquawkVoice platform instance. This is essential for agencies, managed service providers, and organizations that serve multiple clients or have distinct business units.

Account Management Benefits

  • Multi-Client Support: Manage multiple clients in a single platform
  • Isolated Environments: Separate data and configurations for each account
  • Centralized Administration: Oversee all accounts from one interface
  • Scalable Operations: Add new accounts as your business grows
  • Role-Based Access: Control permissions and access levels per account

Account Structure

Understanding Account Hierarchy

SquawkVoice uses a hierarchical structure to organize accounts and manage access:

Partner Level

Top-level organization that can manage multiple client accounts.

Account Level

Individual client accounts with isolated data and configurations.

Workspace Level

Projects or departments within each account.

User Level

Individual users with specific permissions and access.

Account Types

Different types of accounts serve various business needs:
  • Separate accounts for different clients or customers
  • Isolated data, configurations, and billing
  • Custom branding and settings per client
  • Independent user management and permissions
  • Separate accounts for different departments or teams
  • Specialized configurations for specific business units
  • Controlled data sharing and collaboration
  • Department-specific workflows and processes
  • Isolated environments for testing and development
  • Safe space for experimenting with configurations
  • Separate from production data and settings
  • Temporary accounts for specific projects
  • Accounts for business partners and affiliates
  • Shared resources and collaborative features
  • Joint project management and oversight
  • Partnership-specific configurations and permissions

Creating and Managing Accounts

Creating New Accounts

  1. Navigate to Manage > Accounts in the SquawkVoice Studio
  2. Click Create Account to start the account creation process
  3. Fill in the essential account information:
Account Name
string
required
Choose a descriptive name that clearly identifies the account purpose. Examples: “Acme Corporation”, “Marketing Department”, “Client XYZ”
Description
string
Provide a brief description of the account’s purpose and scope.
Account Type
select
Select the type of account (Client, Department, Test, Partner).
Billing Information
object
Configure billing details and payment methods for the account.

Account Configuration

Configure account-specific settings and preferences:

Branding Settings

  • Custom logos and branding elements
  • Color schemes and visual identity
  • Custom domain and subdomain settings
  • Brand-specific voice and personality

Security Settings

  • Authentication requirements
  • Password policies and complexity rules
  • Multi-factor authentication settings
  • Session timeout and security policies

Integration Settings

  • CRM and third-party integrations
  • API access and webhook configurations
  • Custom field mappings and data sync
  • External system connections

Notification Settings

  • Email and SMS notification preferences
  • Alert thresholds and escalation rules
  • Custom notification templates
  • Communication preferences

User Management

Adding Users to Accounts

Manage user access and permissions for each account:
User Email
email
required
Email address of the user to be added to the account.
User Role
select
required
Select the appropriate role for the user:
  • Admin: Full access to account settings and management
  • Manager: Can manage agents and view analytics
  • Agent: Can create and configure AI agents
  • Viewer: Read-only access to account data
  • Custom: Custom role with specific permissions
Permissions
multi-select
Configure specific permissions for the user:
  • Agent creation and management
  • Analytics and reporting access
  • User management capabilities
  • Billing and account settings
  • API access and integrations
Workspace Access
multi-select
Specify which workspaces the user can access within the account.

User Roles and Permissions

Define clear roles and responsibilities within each account:
  • Full access to account settings and configuration
  • User management and role assignment
  • Billing and subscription management
  • Security and compliance settings
  • API access and integration management
  • Create and configure AI voice agents
  • Manage knowledge bases and training data
  • Monitor agent performance and analytics
  • Configure voice settings and personalities
  • Access to call history and transcripts
  • View analytics dashboards and reports
  • Access call history and conversation data
  • Export data and generate reports
  • Monitor performance metrics
  • Read-only access to agent configurations
  • Limited access for customer support purposes
  • View call history and customer interactions
  • Access to basic agent information
  • No configuration or management capabilities

Account Administration

Account Settings

Configure comprehensive settings for each account:
Account Status
select
Manage account status (Active, Suspended, Pending, Deactivated).
Subscription Plan
select
Configure billing plan and feature access for the account.
Usage Limits
object
Set limits for calls, agents, storage, and other resources.
Data Retention
policy
Configure data retention policies and compliance settings.

Billing and Subscription Management

Manage billing and subscription details for each account:

Billing Information

  • Payment methods and billing addresses
  • Invoice history and payment status
  • Tax information and compliance
  • Billing contact and preferences

Subscription Plans

  • Current plan and feature access
  • Plan upgrades and downgrades
  • Usage-based billing options
  • Custom pricing and enterprise plans

Usage Tracking

  • Call volume and usage metrics
  • Resource consumption monitoring
  • Cost allocation and reporting
  • Usage alerts and notifications

Invoice Management

  • Invoice generation and delivery
  • Payment processing and tracking
  • Dispute resolution and support
  • Financial reporting and analytics

Security and Compliance

Account Security

Ensure secure access and data protection for each account:

Authentication

  • Multi-factor authentication requirements
  • Password policies and complexity rules
  • Session management and timeout settings
  • Single sign-on (SSO) integration

Access Control

  • Role-based access control (RBAC)
  • Permission management and assignment
  • IP restrictions and geolocation controls
  • Audit logging and monitoring

Data Protection

  • Data encryption in transit and at rest
  • Backup and disaster recovery procedures
  • Data residency and compliance requirements
  • Privacy and data handling policies

Compliance

  • Industry-specific compliance standards
  • Regulatory requirements and certifications
  • Audit trails and reporting capabilities
  • Compliance monitoring and alerts

Compliance Features

Meet regulatory and industry requirements:
  • Data protection and privacy controls
  • Right to erasure and data portability
  • Consent management and transparency
  • Data processing agreements
  • Protected health information safeguards
  • Business associate agreement compliance
  • Audit trails and access controls
  • Breach notification procedures
  • Security, availability, and confidentiality controls
  • Regular security assessments and audits
  • Incident response and monitoring
  • Risk management and mitigation
  • PCI DSS for payment processing
  • ISO 27001 for information security
  • FedRAMP for government compliance
  • Industry-specific certifications

Analytics and Reporting

Account-Level Analytics

Monitor performance and usage across all accounts:
Account Overview
dashboard
High-level metrics and performance indicators for each account.
Usage Analytics
chart
Track resource usage, call volume, and feature adoption.
Performance Metrics
metric
Monitor agent performance, customer satisfaction, and resolution rates.
Financial Reporting
report
Billing, revenue, and cost analysis for each account.

Cross-Account Reporting

Generate reports across multiple accounts:

Comparative Analysis

Compare performance metrics across different accounts.

Trend Analysis

Track performance trends and patterns across accounts.

Resource Allocation

Analyze resource usage and allocation across accounts.

Revenue Analysis

Monitor revenue, profitability, and growth across accounts.

Integration and API Access

Account-Specific Integrations

Configure integrations for each account:
CRM Integration
integration
Connect with Salesforce, HubSpot, and other CRM systems.
Payment Processing
integration
Integrate with Stripe, PayPal, and other payment processors.
Communication Platforms
integration
Connect with Slack, Microsoft Teams, and other communication tools.
Custom APIs
api
Configure custom API integrations and webhooks.

API Management

Manage API access and usage for each account:

API Keys

  • Generate and manage API keys per account
  • Set usage limits and rate limiting
  • Monitor API usage and performance
  • Secure key management and rotation

Webhook Configuration

  • Configure webhook endpoints and events
  • Set up notification and alert systems
  • Monitor webhook delivery and reliability
  • Custom webhook payloads and formats

SDK Access

  • Provide SDK access for custom integrations
  • Documentation and developer resources
  • Sandbox environments for testing
  • Technical support and assistance

Custom Integrations

  • Build custom integrations and workflows
  • Third-party system connections
  • Data synchronization and mapping
  • Integration monitoring and maintenance

Best Practices

Account Organization

  1. Clear Naming: Use descriptive names for accounts and users
  2. Logical Structure: Organize accounts by client, department, or purpose
  3. Consistent Configuration: Standardize settings across similar accounts
  4. Documentation: Maintain clear documentation for each account

User Management

  1. Role-Based Access: Assign appropriate roles and permissions
  2. Regular Reviews: Periodically review user access and permissions
  3. Onboarding Process: Establish clear processes for adding new users
  4. Offboarding: Ensure proper cleanup when users leave

Security and Compliance

  1. Access Monitoring: Regularly review and audit access logs
  2. Security Updates: Keep security settings current and compliant
  3. Data Protection: Implement appropriate data protection measures
  4. Compliance Monitoring: Regularly assess compliance status

Performance Optimization

  1. Resource Monitoring: Track usage and optimize resource allocation
  2. Performance Metrics: Monitor key performance indicators
  3. Capacity Planning: Plan for growth and scaling needs
  4. Cost Optimization: Monitor and optimize costs across accounts

Troubleshooting

  • Verify required information and permissions
  • Check for duplicate account names or conflicts
  • Ensure proper billing information is provided
  • Contact support for account setup assistance
  • Verify user email and invitation status
  • Check role assignments and permissions
  • Review account status and access controls
  • Contact support for user access assistance
  • Verify payment method and billing information
  • Check subscription status and plan limits
  • Review usage and billing history
  • Contact billing support for assistance
  • Verify API credentials and endpoints
  • Check webhook configurations and delivery
  • Review integration logs and error messages
  • Contact technical support for integration assistance

Next Steps

Now that you understand account management, explore these related topics: