Skip to main content

Participants

Participants are the records that move through a campaign's flows — the campaign's central object. They usually come from CSV uploads or the API, and each one is then processed independently by the campaign's flows. The Participants tab is where you review them: verify an import, inspect a participant's field values, and follow their communications into sessions.

Participants tab

The Participants tab lists everyone added to the campaign.

ColumnMeaning
Name, Email, Phone, External IDKey identity fields. Sortable.
CommunicationsNumber of communications for this participant. Click the number to open the list.
Created at / Updated atWhen the participant was added and last changed. Sortable.
  • Click the arrow at the start of a row to expand it: Details shows the participant's fields — key identity fields first, then the rest in the order set on the Data tab, and Results shows the Result and Result Date & Time of the latest communication.
  • Click the delete icon and confirm Delete participant? to remove a participant. This removes the participant record and its communication records; any linked sessions and their conversation history are kept.
  • Open the Filter panel to filter by participant fields. Applied filters appear as chips above the table; remove a chip to drop that filter, or use Clear all. If you arrive from View participants from this upload, an Upload ID chip is already applied.
  • Click column headers to sort; sorting applies across all pages.

Participant lifecycle

A participant is Active from the moment it's imported, and moves to another state as flows process it:

  • Active — being processed by the campaign's flows.
  • Paused — processing is temporarily suspended.
  • Completed — finished the campaign.
  • Error — could not be processed; check the participant's details.

Review a participant's communications

Click the count in the Communications column to open the Communications dialog:

ColumnMeaning
NameThe communication name from the flow action.
StatusCurrent status. Hover to see the status message.
ChannelThe channel used.
Agent IDThe agent that handled it.
Scheduled at / Created atTiming of the attempt.
Go to sessionOpens the linked session in Sessions in a new tab once a conversation exists.

Communication statuses fall into three groups:

  • In progress: Planned, Started, Delivered, Read.
  • Successful: Replied, Completed.
  • Ended without success: NoResponse, Canceled, Skipped, Failed.

These statuses drive two flow triggers: Completed, NoResponse, and Failed trigger the Communication Ended event; Delivered, Read, and Replied trigger Communication Updated.

Best practices

  • Upload a small test file before importing a large audience, and check the imported rows on this tab.
  • Keep External ID values stable across uploads — they're the first thing an upload matches on, so a changed External ID creates a duplicate instead of an update.
  • Filter by Upload ID to verify what a specific import added.
  • Review and fix failed rows before re-uploading — see Uploads.
  • Uploads — add participants from a file or the API
  • Data — define the fields participants hold
  • Workflow — the flows that act on participants
  • Analytics — track participant and communication outcomes
  • Sessions — read the conversations that communications start

Was this article helpful?