DialNexa Workflow Statuses

Understand DialNexa workflow statuses, workflow lead execution statuses, activation, pause, resume, cancellation, and Voice Call node routing.

DialNexa workflow statuses show whether a workflow is still being built, can process leads, is temporarily paused, or has reached a final state. Workflow lead statuses are separate. They show where one lead sits inside that workflow.

Do not use the workflow container status to explain an individual call or lead. Open lead history for the exact lead state.

When To Use Workflow Statuses

Use this page when you need to:

• Decide whether a workflow can process leads.
• Explain why the dashboard button says activate or deactivate.
• Understand why one lead is pending, active, completed, or dropped.
• Map Voice Call node outcomes to COMPLETED, DNP, and FAILED branches.

Workflow Statuses

These statuses apply to the workflow container.

Status	Final?	What it means	Safe next action
draft	No	The workflow is still being built. It should not process leads yet.	Add nodes, connect edges, upload leads if needed, then activate when the graph is valid.
active	No	The workflow can process leads. Existing leads without execution records can start when the workflow is activated.	Monitor lead history, node counts, and linked call logs.
paused	No	The workflow is temporarily stopped. Leads already inside an active call step can finish, but new movement is paused.	Resume after investigation or cancel if the workflow should not continue.
completed	Yes	The workflow has finished and should not process more leads.	Review results or duplicate the workflow for another run.
cancelled	Yes	The workflow was permanently stopped.	Create or duplicate a workflow if you need a new run.
running	Legacy active equivalent	Some older records or UI checks can treat running like active. New workflow requests should use active.	Treat it as active when deciding whether pause controls apply.

Workflow Lead Execution Statuses

These statuses apply to one lead moving through the workflow.

Status	Final?	What it means	What to check
pending	No	The lead exists, but no execution record has started yet.	Confirm the workflow is active and the graph has a valid entry node.
active	No	The lead is currently at a workflow node.	Open lead history to see current node id, entry time, planned release time, and linked call id if present.
completed	Yes	The lead reached a converted terminal node.	Review the completed path and any linked call evidence.
dropped	Yes	The lead reached a dropped terminal node.	Review the branch that dropped the lead and decide whether follow-up is needed.

Workflow Control Actions

User action	API action	Status change	Important behavior
Activate workflow	POST /v1/workflows/{id}/activate	draft or paused to active	Validates the workflow structure and can start execution for leads that do not already have execution records.
Deactivate workflow	POST /v1/workflows/{id}/pause	active to paused	Pauses future lead movement. Active call steps can still finish.
Resume workflow	POST /v1/workflows/{id}/resume	paused to active	Continues lead processing from the current node.
Cancel workflow	POST /v1/workflows/{id}/cancel	non-final to cancelled	Stops the workflow permanently. Completed and cancelled workflows cannot be cancelled again.
Duplicate workflow	POST /v1/workflows/{id}/duplicate	new workflow starts as draft	Creates a copy that can be edited without changing the original workflow.

Voice Call Node Status Routing

Voice Call nodes wait for a final call status before moving the lead to the next node. The call status belongs to the linked call log, not to the workflow itself.

Call status	Workflow branch	What it means
created, initiated, received, connected, waiting	No branch yet	The call is still in progress or waiting for a final update.
completed	COMPLETED	The call connected and ended.
did_not_pick, busy	DNP	The recipient did not complete a live conversation.
failed, no_answer	FAILED	The call failed or the provider returned no answer.
cancelled, retry_expired	Review required	These are final call statuses, but they are not default Voice Call node outputs. Inspect lead history if a lead remains at the call node.

Verify The Result

After changing workflow status, verify behavior from the lead view:

1. Open the workflow

   Confirm the workflow badge shows the expected container status.

2. Open the Leads tab

   Check each lead’s execution status and current node.

3. Open lead history

   Read the latest transition reason and metadata.

4. Open linked call logs

   For Voice Call nodes, inspect status, end_reason, transcript, recording, and post-call fields.

Troubleshooting Workflow Statuses

Workflow is active but leads are still pending

Confirm the graph has a valid entry node, the workflow was activated after leads were added, and the lead file uploaded successfully.

Workflow is paused but a call still completed

Pausing stops new movement. A call that already started can still finish and write its final call status.

Lead is active but not moving

Check the current node. Time nodes may be waiting for a release time, Voice Call nodes may be waiting for a final call status, and application nodes may need integration review.

Voice Call node did not route

Confirm the node has a configured output for the final call group. Missing outputs can leave the lead at the Voice Call node.

Related Reading

Workflow Overview

Understand workflow objects and lifecycle.

Lead History

Inspect execution state for one lead.

Call Nodes

Configure Voice Call node outputs.

Statuses Reference

Compare workflow, batch, and call statuses.