Overview
TelemanAI uses environment variables in the .env file for all configuration. This guide covers all available configuration options extracted from your .env.example file.
Never commit your .env file to version control. It contains sensitive credentials and API keys.
Application Configuration
Basic Application Settings
APP_NAME="TelemanAI - Telemarketing Conversational AI Application"
APP_ENV=production
APP_KEY=base64:your_generated_key_here
APP_DEBUG=false
APP_URL=https://your-domain.com
- APP_NAME: Application name shown in emails, UI, and notifications
- APP_ENV: Environment (
local, staging, production)
- APP_KEY: Encryption key (generate with
php artisan key:generate)
- APP_DEBUG: Debug mode - MUST be
false in production
- APP_URL: Full URL of your application (with https://)
The APP_KEY is critical for security. Never share it or commit it to version control.
AUTHOR="The Code Studio"
VERSION="6.0.0"
DEMO="NO"
- AUTHOR: Platform author/owner name
- VERSION: Current version number
- DEMO: Set to
YES to enable demo mode (restricts certain actions)
Installation & Developer Settings
APP_INSTALL="YES"
TIMEZONE="Asia/Dhaka"
DEBUGBAR_ENABLED="false"
IGNITION_EDITOR="vscode"
- APP_INSTALL: Set to
YES to show installation wizard, NO after installation
- TIMEZONE: Default timezone (use PHP timezone identifiers)
- DEBUGBAR_ENABLED: Enable Laravel Debugbar (development only)
- IGNITION_EDITOR: Editor for error page links (
vscode, phpstorm, etc.)
Logging Configuration
LOG_CHANNEL=stack
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=error
- LOG_CHANNEL: Logging channel (
stack, single, daily, syslog)
- LOG_LEVEL: Minimum level to log (
debug, info, notice, warning, error, critical)
Use LOG_LEVEL=error in production to reduce log file size. Use debug only when troubleshooting.
Database Configuration
Primary Database
DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=teleman_ai
DB_USERNAME=your_db_user
DB_PASSWORD=your_secure_password
DB_PREFIX=""
- DB_CONNECTION: Database driver (
mysql, pgsql, sqlite)
- DB_HOST: Database server hostname
- DB_PORT: Database port (3306 for MySQL)
- DB_DATABASE: Main database name
- DB_USERNAME: Database user
- DB_PASSWORD: Database password
- DB_PREFIX: Table prefix (optional)
Multi-Tenant Database Configuration
TENANT_DATABASE="${DB_USERNAME}"
TENANT_USERNAME="${DB_USERNAME}"
TENANT_PASSWORD="${DB_PASSWORD}"
For multi-tenant SaaS deployment, tenant databases are created automatically. Ensure the database user has CREATE database privileges.
Cache & Session Configuration
BROADCAST_DRIVER=log
CACHE_DRIVER=file
FILESYSTEM_DRIVER=local
QUEUE_CONNECTION=database
SESSION_DRIVER=file
SESSION_LIFETIME=120
- CACHE_DRIVER:
file, redis, memcached, database
- QUEUE_CONNECTION:
sync, database, redis, sqs
- SESSION_DRIVER:
file, cookie, database, redis
- SESSION_LIFETIME: Session timeout in minutes
For production with multiple servers, use redis for cache and sessions to ensure consistency.
Redis Configuration
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
Memcached Configuration
Email Configuration
SMTP Settings
MAIL_MAILER="smtp"
MAIL_HOST="smtp.gmail.com"
MAIL_PORT="587"
MAIL_USERNAME="[email protected]"
MAIL_PASSWORD="your_app_password"
MAIL_ENCRYPTION="tls"
MAIL_FROM_ADDRESS="[email protected]"
MAIL_FROM_NAME="TelemanAI"
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_ENCRYPTION=tls
MAIL_HOST=smtp.sendgrid.net
MAIL_PORT=587
MAIL_USERNAME=apikey
MAIL_PASSWORD=your_sendgrid_api_key
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
MAIL_HOST=email-smtp.us-east-1.amazonaws.com
MAIL_PORT=587
For Gmail, you must create an App Password, not use your regular password. Enable 2FA and generate an app password in your Google Account settings.
Subscription Expiry Alerts
EXPRITY_ALERT_MAIL_DAY="3"
TRIAL_PERIOD_DAYS="7"
- EXPRITY_ALERT_MAIL_DAY: Days before expiry to send alert emails
- TRIAL_PERIOD_DAYS: Default trial period for new subscriptions
Twilio Configuration (Voice & SMS)
Basic Twilio Settings
TWILIO_ACCOUNT_SID="AC085429e8d240706a0826fff4674535d3"
TWILIO_AUTH_TOKEN="your_twilio_auth_token"
TWILIO_NUMBER="+1234567890"
Get Twilio Credentials
- Sign up at twilio.com
- Navigate to Console Dashboard
- Copy Account SID and Auth Token
- Purchase a phone number with Voice capability
Configure TelemanAI
Add credentials to .env file
Set Webhook URLs
Configure Twilio webhooks to point to your application:
- Voice URL:
https://your-domain.com/api/twilio/voice
- Status Callback:
https://your-domain.com/api/twilio/status
SIP Trunk Configuration
SIP_TRUNK="YES"
TWILIO_APP_SID="APxxxxxxxxxxxxx"
TWILIO_SIP_ENABLED=true
TWILIO_SIP_DEFAULT_DOMAIN="your-domain.sip.twilio.com"
TWILIO_SIP_SECURE=true
TWILIO_SIP_DEFAULT_AUTH_TYPE="IP_ACL"
TWILIO_SIP_VOICE_URL="https://your-domain.com/api/sip/voice"
TWILIO_SIP_LOGGING=true
Create Twilio Elastic SIP Trunk
- Go to Twilio Console > Elastic SIP Trunking
- Create new trunk
- Note the SIP domain
Configure Origination
Set origination URI to your PBX or SIP server
Configure Termination
Add your server IP to termination ACL
Update Configuration
Add trunk details to .env
SIP trunks allow you to connect existing phone systems and PBX infrastructure to TelemanAI.
AI & Voice Configuration
VAPI Integration
VAPI_API_KEY="7cda2427-44a8-4c6d-9f43-06a8f831cced"
VAPI_PUBLIC_KEY="613631a3-326c-43fa-8b6a-383e07327b02"
- Sign up at vapi.ai
- Create an account and get API keys
- Configure AI assistants in VAPI dashboard
- Add keys to
.env
VAPI provides the conversational AI engine that powers intelligent voice interactions in campaigns.
OpenAI Integration
OPENAI_API_KEY="sk-proj-xxxxxxxxxxxxx"
Phone Verification Services
Telesign
TELESIGN_CUSTOMER_ID="your_customer_id"
TELESIGN_API_KEY="your_api_key"
TELESIGN_ACTIVE="YES"
MessageBird
MESSAGEBIRD_ACCESS_KEY="your_access_key"
MESSAGEBIRD_ACTIVE="YES"
Phone verification services help validate phone numbers before running campaigns, reducing bounce rates.
Payment Gateway Configuration
Stripe
STRIPE_ENVIRONMENT="live"
STRIPE_KEY="pk_live_xxxxxxxxxxxxx"
STRIPE_SECRET="sk_live_xxxxxxxxxxxxx"
STRIPE="YES"
- Create account at stripe.com
- Get API keys from Dashboard > Developers > API keys
- For testing, use
sandbox environment with pk_test_ and sk_test_ keys
PayPal
PAYPAL_SANDBOX=false
PAYPAL_CLIENT_ID="your_client_id"
PAYPAL_CLIENT_SECRET="your_client_secret"
PAYPAL_API_USERNAME="your_api_username"
PAYPAL_API_PASSWORD="your_api_password"
PAYPAL_CURRENCY="USD"
PAYPAL="YES"
Razorpay (India)
RAZORPAY_KEY="rzp_live_xxxxxxxxxxxxx"
RAZORPAY_SECRET="your_secret_key"
RAZORPAY="YES"
Flutterwave (Africa)
FLW_PUBLIC_KEY="FLWPUBK-xxxxxxxxxxxxx"
FLW_SECRET_KEY="FLWSECK-xxxxxxxxxxxxx"
FLW_SECRET_HASH="your_secret_hash"
FLW_CURRENCY="NGN"
FLUTTERWAVE="YES"
Paystack (Africa)
PAYSTACK_PUBLIC_KEY="pk_live_xxxxxxxxxxxxx"
PAYSTACK_SECRET_KEY="sk_live_xxxxxxxxxxxxx"
PAYSTACK_PAYMENT_URL="https://api.paystack.co"
MERCHANT_EMAIL="[email protected]"
MERCHANT_CURRENCY="ZAR"
PAYSTACK="YES"
Instamojo (India)
IM_API_KEY="your_api_key"
IM_AUTH_TOKEN="your_auth_token"
IM_URL="https://www.instamojo.com/api/1.1/"
INSTAMOJO="YES"
https://test.instamojo.com/api/1.1/
SSLCommerz (Bangladesh)
API_DOMAIN_URL="https://securepay.sslcommerz.com"
STORE_ID="your_store_id"
STORE_PASSWORD="your_store_password"
SSL_COMMERZ="YES"
https://sandbox.sslcommerz.com
Braintree
BT_ENVIRONMENT="production"
BT_MERCHANT_ID="your_merchant_id"
BT_PUBLIC_KEY="your_public_key"
BT_PRIVATE_KEY="your_private_key"
BRAINTREE="YES"
BT_ENVIRONMENT="sandbox"
Mollie (Europe)
MOLLIE_KEY="live_xxxxxxxxxxxxx"
MOLLIE_CURRENCY="EUR"
MOLLIE="YES"
Square
SQUARE_ACCESS_TOKEN="your_access_token"
SQUARE_APPLICATION_ID="your_application_id"
SQUARE_LOCATION_ID="your_location_id"
SQUARE_CURRENCY="USD"
SQUARE_REDIRECT_URL="${APP_URL}/square/callback"
SQUARE="YES"
Squad (Nigeria)
SQUAD_PUBLIC_KEY="your_public_key"
SQUAD_SECRET_KEY="your_secret_key"
SQUAD_CURRENCY="NGN"
SQUAD_API_URL="https://api-d.squadco.com"
SQUAD="YES"
https://sandbox-api-d.squadco.com
Always use test/sandbox credentials during development. Never test with real payment credentials.
Feature Toggles
SMS_MARKETING="YES"
SHOP="YES"
KYC="NO"
PERFEX="NO"
- SMS_MARKETING: Enable/disable SMS campaign features
- SHOP: Enable e-commerce features
- KYC: Enable Know Your Customer verification
- PERFEX: Enable Perfex CRM integration
UI & Frontend Configuration
DASHBOARD_UI="EXTENDED"
FRONTEND_THEME="ACTIVE"
DEFAULT_LANGUAGE="en"
- DASHBOARD_UI:
EXTENDED (full width) or CONTAINER (boxed)
- FRONTEND_THEME:
ACTIVE (show frontend) or DEACTIVE (admin only)
- DEFAULT_LANGUAGE: Default language code (
en, es, fr, etc.)
React Configuration
REACT_BASE_URL="${APP_URL}"
Third-Party Services
Google OAuth
GOOGLE_CLIENT_ID="your_client_id.apps.googleusercontent.com"
GOOGLE_CLIENT_SECRET="your_client_secret"
GOOGLE_REDIRECT_URI="${APP_URL}/google/callback"
- Go to console.cloud.google.com
- Create OAuth 2.0 credentials
- Add authorized redirect URI
Google reCAPTCHA
GOOGLE_RECAPTCHA_KEY="your_site_key"
GOOGLE_RECAPTCHA_SECRET="your_secret_key"
GOOGLE_RECAPTCHA="YES"
Pusher (Real-time)
PUSHER_APP_ID="your_app_id"
PUSHER_APP_KEY="your_app_key"
PUSHER_APP_SECRET="your_app_secret"
PUSHER_APP_CLUSTER="mt1"
MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
AWS Services
AWS_ACCESS_KEY_ID="your_access_key"
AWS_SECRET_ACCESS_KEY="your_secret_key"
AWS_DEFAULT_REGION="us-east-1"
AWS_BUCKET="your_bucket_name"
AWS_USE_PATH_STYLE_ENDPOINT=false
Sentry (Error Tracking)
Monitor and track application errors in production.
cPanel Configuration
CPANEL="YES"
CPANEL_USERNAME="your_cpanel_username"
CPANEL_PASSWORD="your_cpanel_password"
CPANEL_PRIVILEGED_USER="root"
YOUR_DOMAIN="your-domain.com"
Enable cPanel integration for automatic subdomain creation and SSL management for multi-tenant deployments.
Security Configuration
SaaS License Key
SAAS_KEY="$2a$12$pkLmD5jZdxd6bSNcTg9YT.g2mXz5gS8JTArdIg68c8RK/d7w2y2Gu"
Development Mode
DEVELOPMENT_MODE="NO"
DEV_MODE="NO"
Always set to “NO” in production to prevent security vulnerabilities.
Configuration Best Practices
Security Checklist
Environment File Security
# Protect .env file
chmod 600 .env
chown www-data:www-data .env
# Ensure .env is in .gitignore
echo ".env" >> .gitignore
Production Settings
Verify these settings for production:APP_ENV=production
APP_DEBUG=false
DEBUGBAR_ENABLED=false
DEVELOPMENT_MODE="NO"
DEV_MODE="NO"
Use Strong Credentials
- Generate strong database passwords (20+ characters)
- Use different passwords for each service
- Store backup credentials securely
- Rotate API keys regularly
Enable HTTPS
APP_URL=https://your-domain.com
# All payment gateways require HTTPS
Configure Logging
LOG_LEVEL=error
LOG_CHANNEL=daily
tail -f storage/logs/laravel.log
# Use Redis for better performance
CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
# Cache configuration
php artisan config:cache
php artisan route:cache
php artisan view:cache
Environment-Specific Configurations
Development:
APP_ENV=local
APP_DEBUG=true
DEBUGBAR_ENABLED=true
LOG_LEVEL=debug
APP_ENV=staging
APP_DEBUG=true
LOG_LEVEL=info
# Use test payment credentials
APP_ENV=production
APP_DEBUG=false
DEBUGBAR_ENABLED=false
LOG_LEVEL=error
# Use live payment credentials
Verifying Configuration
Test Database Connection
php artisan tinker
>>> DB::connection()->getPdo();
Test Email Configuration
php artisan tinker
>>> Mail::raw('Test email', function($msg) { $msg->to('[email protected]')->subject('Test'); });
Test Queue Workers
php artisan queue:work --once
View Current Configuration
# View all config
php artisan config:show
# View specific config
php artisan tinker
>>> config('database.connections.mysql')
>>> config('services.twilio')
Troubleshooting Configuration Issues
Clear Configuration Cache
# Clear all caches
php artisan config:clear
php artisan cache:clear
php artisan view:clear
php artisan route:clear
Common Configuration Errors
“Base table or view not found”
- Run migrations:
php artisan migrate
- Check database credentials in
.env
“No application encryption key”
- Generate key:
php artisan key:generate
Payment gateway not working
- Verify credentials are correct
- Check if gateway is enabled:
STRIPE="YES"
- Ensure APP_URL uses HTTPS
- Check webhook URLs are configured
Emails not sending
- Test SMTP connection
- Check firewall allows outbound port 587/465
- Verify MAIL_FROM_ADDRESS is valid
- Check spam folder
Next Steps
After configuration:
- Test all integrations: Verify payment gateways, Twilio, VAPI
- Set up monitoring: Configure Sentry for error tracking
- Create first campaign: Test the full workflow
- Configure backups: Set up automated database backups
- Review security: Run security audit checklist
For operational guidance and campaign creation, refer to the User Guide sections.
