How to set up a Safe Harbor message for dropped calls

Setting up a Safe Harbor message is not one switch, it is three fields that have to agree with each other. People often set one and wonder why nothing plays. Walk through them in order and the message will fire on every dropped call exactly when you expect it. Everything here lives on the campaign detail screen.

Step 1: set the Drop Call Action to AUDIO

Find Drop Call Action and choose AUDIO. This is the one value that tells VICIdial to play your recorded file when a call is dropped. If this is set to HANGUP, the call just ends and your audio is never touched. If it is set to IN_GROUP, VOICEMAIL, or CALLMENU, the call goes somewhere else and the audio is skipped. AUDIO is non-negotiable for this feature.

Step 2: point at your audio file

The Safe Harbor Audio field names the prompt file that plays. By default it is set to buzz, which is a placeholder you do not want a real customer to hear. Upload your own recording, then enter its filename here. The recording should identify your business and give the person a way to follow up or opt out.

There is a related field, Safe Harbor Audio Field, that lets each Lead carry its own audio filename in one of its data columns. That is handy for multi-brand campaigns. If you want one message for everyone, leave it DISABLED and the single Safe Harbor Audio file is used for every call.

There is also a Safe Harbor Exten field, which is the dialplan extension where the audio lives on your server. On a managed box this is wired up for you, so most operators only touch the filename.

Step 3: set the timing

Drop Call Seconds decides how long after pickup a call becomes a drop, which is the instant your message plays. For consumer calling, most operators keep this at 5 seconds at most so the person is not left in silence for long. Set it too high and your caller waits awkwardly; set it too low and you risk marking calls as drops before an agent has a fair shot. This timing also feeds your Drop rate, so it is worth getting right.

Test it before you go live

Force a drop on a test number and confirm you hear your recording, not the default buzz tone and not silence. If you get silence, the action is probably not on AUDIO. If you hear buzz, the audio filename was never changed. This is practical setup guidance, not legal advice; the abandonment rules where you call still apply, and the message is just one piece of staying within them. The bigger lever is your Abandonment rate.

For background on why this message exists at all, read what a Safe Harbor message is. To make these moments rare, see how to lower your VICIdial drop rate, and the full picture in the VICIdial dialing strategies guide. Want it pre-configured? See our pricing.