DialNexa Batch Call Recipient Files

Prepare DialNexa batch call recipient CSV files with phone number columns, dynamic variable columns, agent-specific templates, and validation checks.

DialNexa batch call recipient files provide the phone numbers and dynamic variable values for outbound campaigns. The create page can download a CSV template based on the selected agent version default variables, then parse uploaded recipients into a review table.

CSV files are simple right up until one header has an invisible extra space. Then they become a personality test.

Expected CSV Shape

Keep recipient files boring and predictable.

Column	Purpose
phone number	Recipient number in a format the selected outbound route can validate. Use full international format when possible.
Dynamic variable columns	Values for placeholders used by the selected published agent version.
Additional columns	Can be shown in the recipient table when parsed, but should not replace required variables.
One recipient per row	Each row represents one outbound call target.

Template Behavior

The download template changes with the selected number and agent version.

Agent defaults first

The template uses default dynamic variable keys from the selected agent version when available.

Fallback placeholders

If no agent variables are available, the template includes generic placeholder variable columns.

Recipient preview

Parsed recipients are displayed in a table before launch.

File upload checks

The page validates CSV type and rejects large or invalid uploads.

Prepare A Clean File

1. Select the outbound number first

   This lets the page know which agent version variables to use.

2. Download the template

   Start with headers that match the selected agent.

3. Fill realistic values

   Use production-ready names, dates, amounts, and transfer destinations.

4. Upload and inspect rows

   Check the preview table before saving or starting.

5. Fix errors before launch

   Do not launch a file whose preview already looks wrong.

Destination Validation Errors

The upload parser checks recipient phone numbers against the same route rules used by single outbound calls.

Error type	What to fix
Invalid phone number	Add the country code, remove extra characters, or correct the digit count.
Unsupported destination country	Enable the destination country in Workspace Settings > Telephony Config, or use a route that supports it.
Unsupported prefix	Check whether the number starts with a prefix listed under an enabled network group.
No enabled countries configured	Enable at least one network group for the selected provider before uploading the file.

If several rows fail for the same reason, the dashboard groups them into one message with the affected row numbers. Fix the grouped rows, upload the file again, and confirm the preview before saving or starting the campaign.

When more than three rows fail validation, the upload page can show Download errors CSV. Download it to review each failed row with:

Column	Meaning
position	Row position in the uploaded CSV.
phone_number	Recipient number that failed validation, when available.
failed_parsing_reason	The grouped validation reason for that row.

The error CSV button is single-use. After downloading the report, fix the original CSV and upload it again.

Related Reading

Dynamic Variables

Map variables to CSV columns.

Common Upload Errors

Fix file issues.

Recipient Results

Review row outcomes.