Getting Started
Configuration
Configure Trunx with your provider credentials and environment settings.
Environment Variables
Trunx uses environment variables for configuration. If you are self-hosting, set these in your .env file or deployment environment.
Required
| Variable | Description |
|---|---|
DATABASE_URL | PostgreSQL connection string |
REDIS_URL | Redis connection string |
TWILIO_ACCOUNT_SID | Your Twilio account SID |
TWILIO_AUTH_TOKEN | Your Twilio auth token |
Voice AI
| Variable | Description |
|---|---|
ULTRAVOX_API_KEY | API key for Ultravox voice AI |
ELEVENLABS_API_KEY | API key for ElevenLabs TTS |
Billing
| Variable | Description |
|---|---|
STRIPE_SECRET_KEY | Stripe secret key for billing |
STRIPE_WEBHOOK_SECRET | Stripe webhook signing secret |
Provider Selection
Trunx supports multiple providers for each service. Configure which provider to use:
ACTIVE_SMS_PROVIDER=twilio
ACTIVE_VOICE_PROVIDER=twilio
ACTIVE_AMD_PROVIDER=twilio
ACTIVE_DID_MANAGEMENT_PROVIDER=commioReputation Monitoring
| Variable | Description |
|---|---|
REPUTATION_AUDIT_CRON | Cron schedule for daily reputation audits (default: 0 6 * * *) |
Phone Number Format
All phone numbers must be in E.164 format: +1XXXXXXXXXX. Requests with incorrectly formatted numbers will be rejected.
Rate Limits
API rate limits are enforced per API key. The default limits are:
- SMS: 100 requests per second
- Voice: 50 requests per second
- Campaign operations: 10 requests per second
Contact sales for higher limits.