SMS Number Management
Professional tier. Assign phone numbers for SMS/MMS from QuestBlue. Assign to users or shared, enable/disable, view webhook configuration.
SMS Number Management
SMS number management lets you assign and configure phone numbers for SMS and MMS messaging in CrystalQore. Numbers are sourced from QuestBlue and can be assigned to individual users or shared across multiple users for team inboxes.
Overview
The SMS module requires phone numbers configured in QuestBlue. From the Superadmin panel you can:
- Assign numbers — Link QuestBlue numbers to CrystalQore
- Assign to users — Give a number to one user or multiple users (shared)
- Enable/disable — Turn numbers on or off without removing the assignment
- View webhook configuration — See the webhook URL for QuestBlue inbound message delivery
Prerequisites
- Professional or Enterprise tier — SMS is not available on Community
- QuestBlue account — Numbers must be provisioned in QuestBlue
- QuestBlue API credentials — Configured in System Settings
QuestBlue API credentials are set in Admin → Settings. Without valid credentials, number assignment and SMS will not work.
Assigning Numbers
Navigate to Admin → SMS Numbers — Open the SMS number management page.
Add number — Enter or select the phone number from your QuestBlue inventory.
Configure assignment — Assign to a single user or multiple users (shared number).
Enable — Ensure the number is enabled for sending and receiving.
Save — The number is ready for use.
Number Assignment Types
| Assignment | Description | Use Case |
|---|---|---|
| Single user | One user owns the number | Personal business line |
| Multiple users (shared) | Several users share the number | Team inbox, department line |
Shared Numbers
Shared numbers allow multiple users to send and receive SMS from the same number. Useful for:
- Team inboxes — Sales, support, or department lines
- Round-robin — Multiple agents handle incoming messages
- Backup — Coverage when one user is unavailable
Enabling and Disabling Numbers
You can disable a number without removing the assignment:
- Disabled — Number does not send or receive; assignment is preserved
- Enabled — Number is active for SMS/MMS
Use disable when:
- Temporarily pausing a campaign
- Reassigning the number to different users
- Complying with regulatory changes
Webhook Configuration
QuestBlue delivers inbound SMS to CrystalQore via a webhook. The webhook URL is displayed in the SMS number configuration or system settings.
- URL — e.g.,
https://your-crystalqore.com/api/sms/webhook - Method — Typically POST
- Authentication — As configured in QuestBlue (API key, signature, etc.)
Ensure your CrystalQore instance is reachable from the internet (or QuestBlue's network) for webhook delivery. Firewall and reverse proxy must allow inbound requests to the webhook endpoint.
Tenant Scoping
SMS numbers are typically scoped to tenants. Users in a tenant can only use numbers assigned to that tenant. Admins assign numbers within the context of the tenant structure.
Best Practices
- Document number assignments — Track who uses which number for compliance
- Use shared numbers for teams — Reduces number sprawl and cost
- Verify webhook delivery — Test inbound messages after configuration
- Monitor usage — Stay within QuestBlue and carrier limits
Related Documentation
| Page | Description |
|---|---|
| SMS Campaigns | 10DLC campaign registration |
| System Settings | QuestBlue API configuration |
| SMS Module | End-user SMS usage |