AMD, Fallback Caller ID and DNC

Campaigns have three safeguards you can switch on. Answering-machine detection (AMD) records whether a human or a machine picked up. A backup caller ID on a different carrier keeps the campaign dialing when the main number's carrier refuses calls. DNC suppression removes numbers on your do-not-call list before they are ever dialed. Campaigns also only dial inside their calling window.

Answering-machine detection#

Set amd_enabled: true when you create the campaign. Each answered call is classified, and the verdict is stored on the contact:

The verdict appears in the contacts list, in the results CSV (answered_by column) and, for agent-dialer campaigns, in call.completed webhook events. Use it to decide whom to call again. AMD records who answered; it does not change what the call plays.

Fallback caller ID#

curl -X PUT https://voice-api.edesy.in/v1/campaigns/{id}/fallback-number \
  -H "Authorization: Bearer $EDESY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "fallback_from_number": "+9180YYYYYYYY" }'

• The backup number should be a number in your workspace on a different carrier from the main caller ID.
• While the main number's carrier is refusing calls, Edesy dials from the backup automatically, so the campaign keeps running.
• Send "" to clear it.
• Set a workspace default with PUT/v1/campaign-settings; new campaigns use it unless you pass fallback_from_number.

DNC suppression#

Numbers on your do-not-call list are suppressed when contacts or leads are added. The upload response counts them as suppressed_dnc, and they show with status suppressed and a suppression_reason in results.

Manage the list with /v1/dnc. See Blocklist and DNC.

curl -X POST https://voice-api.edesy.in/v1/dnc \
  -H "Authorization: Bearer $EDESY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone_numbers": ["+9198XXXXXXXX"], "reason": "opt_out", "source": "ivr_press_9" }'

Add numbers the moment someone opts out, for example from a "press 9 to stop" option or an agent disposition.

Calling hours#

Campaigns dial only inside their window: window_start_minute to window_end_minute in the campaign's timezone. If you do not set a window, the default is 09:00 to 21:00. Contacts not reached when the window closes wait for the next day's window. Removing the window entirely ("clear_window": true on the schedule endpoint) is possible but should be reserved for calls your customers asked for.

Consent records#

Send consent_source and consent_timestamp with each contact or lead. They are stored and included in the results CSV so you can show when and where consent was given.