Skip to main content
Klariqo connects to your VICIdial as a remote SIP agent. It does not replace your dialer. The setup is the same as adding a new remote SIP phone and agent.

What Klariqo sends you

Keep these open while you work through the setup.
FieldValue
SIP extension nameklariqo-ai
SIP passwordSent to you securely
Klariqo server IP35.232.23.234
Number of lines10
These are the standard values. You can use your own extension name, dial plan number, and agent IDs. Just share your chosen values with Klariqo so we match our configuration.

Step 1: Create a phone extension

In your VICIdial admin panel, go to Admin > Phones > Add a New Phone, and fill in:
FieldWhat to enter
Phone Extensionklariqo-ai, or the exact value Klariqo gave you.
Dial Plan NumberAny unused number, like 800 or 8400. Write it down.
Server IPSelect your VICIdial server from the dropdown.
ProtocolSIP
Registration PasswordThe password Klariqo gave you. Use it exactly, with no extra characters.
ActiveY
VoicemailLeave empty or set to N.
Click Submit.

Step 2: Allow Klariqo’s server to connect

Klariqo connects from a single IP, 35.232.23.234. The easiest way to allow it is VICIdial’s built-in IP Lists.
1

Enable IP Lists

Go to Admin > System Settings, set Allow IP Lists to 1, and save.
2

Allow your user to modify IP Lists

Go to Admin > Users, open your admin user, set Modify IP Lists to 1, and save.
3

Add the Klariqo IP

Go to Admin > IP Lists > Add An IP List. Create a list (for example, named ViciWhite) and add 35.232.23.234 to it. Submit.
4

Wait for it to activate

Give it about 60 seconds to sync, then Klariqo can register.
If your VICIdial runs at a cloud provider (AWS, GCP, Hetzner, DigitalOcean, Linode, and others), the provider runs its own firewall above the server’s. Even with the server firewall open, the cloud firewall can drop our packets first. This is the single most common reason a setup stalls. Add an inbound rule allowing UDP and TCP on port 5060 (or your custom SIP port) from 35.232.23.234. To check it is open, run tcpdump -ni any port 5060 on your VICIdial machine while Klariqo tries to connect. If you see packets from 35.232.23.234, the cloud firewall is open. If you see none, it is still blocking.
If you do not manage the server yourself, send the IP 35.232.23.234 to whoever does and ask them to whitelist it and reload SIP, including the cloud-provider firewall.

Step 3: Create a remote agent

This tells VICIdial to send calls to the extension you created. Go to Admin > Remote Agents > Add a New Remote Agent, and fill in:
FieldWhat to enter
Remote Agent IDAny number, like 1001.
User (Agent)A name for this agent, like klariqo.
External ExtensionThe dial plan number from Step 1.
Number of Lines10, or whatever Klariqo told you.
CampaignThe campaign you want Klariqo to handle.
StatusACTIVE
Click Submit.
If you add a second remote agent later for another campaign, give it a User ID range that does not overlap the first. VICIdial reserves a block of consecutive User IDs per agent, and an overlap makes registration fail silently after a couple of minutes.

Step 4: Submit your configuration

Submit your SIP details from your Klariqo dashboard, under Settings, Dialer Setup. This is where every live client manages their VICIdial connection. You will enter:
  • Your VICIdial server IP and SIP port. The default is 5060, but many installs use a custom port. Confirm yours with asterisk -rx "sip show settings" | grep -i bindport.
  • The phone extension name (klariqo-ai) and registration password from Step 1.
  • An optional transfer phone number or VICIdial extension.
  • Confirmation that 35.232.23.234 is whitelisted on your server.
Registration happens automatically once you save. Keep 35.232.23.234 whitelisted.

Step 5: Set up transfers

Optional for inbound-only use, required for outbound campaigns where Klariqo transfers qualified leads to a human closer. VICIdial’s Carriers section is the canonical place to add transfer dialplan entries. It writes to your Asterisk config and reloads automatically, with no SSH or server restart.
1

Open Carriers

Go to Admin > Carriers, and edit an existing carrier or add a new one for the transfer destination.
2

Add the dialplan entry

In the Dialplan Entry field, paste the transfer dialplan, using an unused extension number (for example, 9999):
exten => 9999,1,Dial(SIP/YOUR_CARRIER_TRUNK/+1TRANSFER_PHONE_NUMBER,120,To)
exten => 9999,n,Hangup()
Replace 9999 with any unused extension, YOUR_CARRIER_TRUNK with your outbound trunk name, and +1TRANSFER_PHONE_NUMBER with the destination number.
3

Save and share

Save. VICIdial reloads the dialplan automatically. Share the extension number with Klariqo so we configure the AI to use it.

Test it

Once Klariqo confirms your extension is registered, load a test lead using your own phone number and let the dialer call it. When you pick up, you should hear the Klariqo AI agent greet you, hold a conversation with clear audio both ways, and transfer you to your closer when you qualify.

Security

Klariqo registers with SIP digest authentication. Call audio to the Klariqo pipeline travels over an encrypted WebSocket, and recordings are stored in encrypted storage.