A population in Pristo CX is the list of contacts of a program, with their attributes and activities, that distributions send questionnaires to. Each program has one population, and you open it from the Population tab at the top of the app.
Who can see the population
Section titled “Who can see the population”The Population tab appears in every package. In an account without a package, the tab is hidden and the population pages cannot be opened. See Packages, prices and limits.
Only account admins and program admins can open the population and its contacts and import history. They use the Actions menu to add and import contacts, import activities and define attributes. Program users do not see the population tab and cannot open its pages. See roles and permissions.
Contacts
Section titled “Contacts”A contact is a person who can receive questionnaires by email, SMS or WhatsApp. The Contacts tab lists them with their ID, Name, Phone, Email, Preferred language and whether they unsubscribed. The search box finds contacts by the start of their name, or by their exact last name, email, phone or identifier.
- The identifier (ID) is unique in the population. Imports and the API use it to recognize the same person, so a row or an event with an existing identifier refers to that contact instead of adding a duplicate.
- A contact needs an Israeli mobile number (+972 5…) to receive SMS, an email address to receive email and a phone number to receive WhatsApp. Other phone numbers are stored but get no SMS; see import contacts.
- A contact who unsubscribes stops receiving questionnaires on that channel only. The list and contact page show separate email and SMS unsubscribe badges. See Unsubscribing from SMS and email.
- Each contact has its own page with its details, its Additional attributes, the Sends it received and its Events. An admin can switch a contact to Inactive, and inactive contacts receive no questionnaires.
You add contacts in three ways: one at a time with Add contact, from a file with Import contacts, or through the API, where each event you send creates or updates its contact.
Edit a contact
Section titled “Edit a contact”Account admins and program admins can edit a contact in Pristo CX without importing a file.
-
Open the contact from the Population tab.
-
Select Edit contact next to Delete contact.
-
Change the Email, Phone or declared contact attributes, then select Save.
The contact page reloads with the updated values. Name, last name, language and the external identifier remain read-only. A contact that already has an email or phone must keep at least one. Text attributes allow up to 50 characters; numbers must be whole numbers with at most 18 digits. Date and time fields include seconds. Clear an attribute to remove its value. Invalid fields show an error; a refused edit leaves the contact unchanged.
The contact page shows a recognized phone number in its local format, without the country code. A number that cannot be recognized stays as entered, with a warning. The phone field in the edit dialog reads left to right, including in the Hebrew interface.
Changing an address does not lift an unsubscribe or complaint on that channel. Correcting an email that bounced can make it reachable again, but any unsubscribe still applies. Only an account admin can lift unsubscribes after checking consent.
Contact history
Section titled “Contact history”The History card below the sends shows the latest changes first, with the date, time and who made each change. Edits show the previous and new field values; an empty value appears as a dash. It includes activation, deactivation, edits, deletion, restoration and changes to email and SMS subscriptions, including unsubscribes lifted by an admin.
History shows a member’s name, Pristo for changes by the Pristo team, or a system or unknown actor label when appropriate. It shows up to 200 recent entries and tells you when older entries are omitted. Older actions may not have a history entry.
Subscription entries may currently appear as contact.unsubscribed (stopped questionnaires on a channel) or contact.resubscribed (subscribed again), rather than a translated sentence.
Contact attributes
Section titled “Contact attributes”Contact attributes are extra fields on every contact, such as city or customer tier. An admin defines them in Actions > Contact attributes. It helps to define them before the first import, so the import can fill them.
| Field | What it is |
|---|---|
| Unique Identifier | The key used in imports and the API. English letters and underscores only, and it cannot start or end with an underscore |
| Attribute Name | The name people see in the app, for example Age |
| Attribute Type | Text, Number, Date, Time, Date & Time or Boolean |
A population can have up to 10 text attributes and up to 2 attributes of each other type, separately for contacts and events. Distributions use contact attributes to choose a segment of contacts, and messages can insert them as variables. An attribute can be deleted only while the population has no contacts. See Contact attributes.
Activities and event types
Section titled “Activities and event types”An activity is an event recorded for a contact, such as a purchase or a closed support call. In the app, activities appear as Events on the contact’s page.
An admin defines event types and their attributes in Actions > Events attributes, which has two tabs:
- Event types: the kinds of activity you report, for example Purchase made. Each has an identifier and a name.
- Attributes: details that come with an activity, for example branch and transaction amount. They take the same types and limits as contact attributes.
Activities reach Pristo CX from a file with Import activities, as described in Import activities, or from your own systems through the API’s send an event endpoint. An event-based distribution sends a questionnaire when an activity of a chosen event type arrives, and can filter on event attributes.
Imports history
Section titled “Imports history”The Imports tab lists every contacts and activities import in the population, with its file name, status and counts of rows, imported and updated contacts, errors and warnings. Expand a row to see each error and warning by row number. An activities import can stay in progress for a few minutes after the file is accepted. The list refreshes itself while an import is still running.
Delete and restore a contact
Section titled “Delete and restore a contact”On a contact’s page, an account admin or program admin can select Delete contact and confirm. The contact and their events are hidden, but existing responses are not deleted. Messages waiting to be sent to that contact are cancelled.
To restore a contact before the restoration deadline, return to the contacts list, check Deleted only and select Restore on their row. Deleted contacts are listed by deletion date, newest first. Restoring a contact does not resend cancelled messages or restore responses deleted separately. Unsubscribes remain in force after deletion, restoration or re-import.
Only account admins can lift unsubscribes on the contact’s page with Lift unsubscribe. Confirm only after checking that the person has consented to receive questionnaires again. This lifts both email and SMS unsubscribes for that contact’s current addresses in the population.