“Time to give your Vicidial server a passport—Bitcall edition!”
Let’s plug Bitcall into your Vicidial dialer with confidence.
🔸 Step 1: Login & Add a Carrier
Log into Vicidial Admin → go to ADMIN → Carriers.
Click “Add New Carrier”
🔧 Step 2: Carrier Setup (Choose Your Auth Mode)
⚙️ Option A:
SIP Credentials (Username + Password)
Carrier ID: bitcall
Carrier Name: Bitcall SIP
Registration String: (leave blank)
Protocol: SIP
Account Entry:
[bitcall]
disallow=all
allow=ulaw,alaw
type=friend
username=YOUR_BITCALL_USER
secret=YOUR_BITCALL_PASS
host=gateway.bitcall.io
dtmfmode=rfc2833
context=from-trunk
qualify=yes
insecure=port,invite
nat=yes
Dialplan Entry:
exten => _0[0-9].,1,AGI(agi://127.0.0.1:4577/call_log)
same => n,Set(CALLERID(num)=+33XXXXXXXXX)
same => n,Dial(SIP/${EXTEN}@bitcall,,To)
same => n,Hangup()
(Replace +33XXXXXXXXX with your France CLI, or +33612345678 example).
⚙️ Option B:
IP Authentication (Trusted IP)
Same fields, except no username/secret — just add your trusted IP in Bitcall dashboard instead.
Account Entry:
[bitcall-ip]
disallow=all
allow=ulaw,alaw
type=peer
host=gateway.bitcall.io
dtmfmode=rfc2833
context=from-trunk
insecure=invite
nat=no
qualify=yes
Same dialplan entry as above.
🎲 Step 3: Random CLI Assignment for France
Want each call to use a random French CLI from your DID list? Here’s how:
In Dialplan Entry, insert the following before Set(CALLERID...):
exten => _0[0-9].,1,AGI(agi://127.0.0.1:4577/call_log)
same => n,AGI(agi-set_variables.agi)
same => n,Set(CALLERID(num)=${alt_phone})
same => n,NoOp(Using CLI ${CALLERID(num)} for this call)
same => n,Dial(SIP/${EXTEN}@bitcall,,To)
same => n,Hangup()
This uses Vicidial’s built-in AGI to pick a DID from the lead’s alt_phone field each call . Just upload leads with their list of DIDs in that field.
🚨 Step 4: Save and Test
Click Submit twice to save.
Wait a moment, then check from the top of the Carrier list (should say Active: Y).
☎️ Step 5: Make a Test Call
Head to the Campaigns or Agent GUI.
Dial a French number like 0612345678.
Check Vicidial’s asterisk console or logs to confirm the call used your trunk and CLI.
🛠️ Troubleshooting Table
Issue | Quick Fix |
Calls rejected or failed | Verify credentials or trusted IP in Bitcall panel |
Carrier not active | Did you click Submit twice? Ensure Active = Y |
No audio or one-way voice | Try adding nat=yes or use STUN/NAT options |
CLI not changing randomly | Check that alt_phone column is correctly filled in lead imports |
Random CLI script not found | Upload Vicidial’s agi-set_variables.agi file to the server directory |
🧠 TL;DR Recap
✅ Admin → Carriers → Add New Carrier
✅ Use either SIP-credentials or IP-auth methods
✅ Set France CLI or random alt_phone option
✅ Save (remember Submit twice!)
✅ Dial to test, watch logs for CLI and trunk usage
🎉 You’re all set! Bitcall is now powering your Vicidial calls with flexible CLI options—fully newbie-friendly and easy to copy-paste.