Skip to content

Contact search and details

From the contact search you find a contact by name, phone or another field, and open its details: contact information, campaigns it is enrolled in and how it went in each one. From the details you can correct the data, unblock a contact blocked by a "Not authorized" outcome, delete it or anonymize it (right to be forgotten). If you arrived from a campaign's search you can also edit or remove the contact's outcome in that campaign.

Work groups

If your account has work groups and you do not have the All work groups permission, the search does not show the contacts of the databases of a group you do not belong to. If there is nothing else to show, you find "No contact found."

How to open it

The search has no menu item of its own: you open it from other pages, and the scope, shown under the Contact search title, changes depending on where you start:

From where Scope Under the title
Databases → Search all databases All databases "Search across all tenant databases"
Databases → magnifying glass icon on a database row One database "Search within the selected database"
Databases → click on a database row One database, in preview (see below) "Search within the selected database"
A campaign (see Campaign contacts) Only the contacts enrolled in the campaign "Search among the contacts enrolled in this campaign"
Campaigns report → click on a contact in the list No search: the details open directly, read-only (see Contact details)

The Back button takes you back to the page you started from.

Database preview

Clicking a database on the Databases page shows all its contacts, with no filters, with the text "Preview of the database contacts, no filters applied." and the total (e.g. "12,000 total contacts"). Contacts are shown 50 per page: scroll with Previous and Next.

The preview is a table with all the columns of the database, to be scrolled horizontally: Id, all the standard fields (Company name, First name, Last name, address, phones, Email, Website, Reference ID…; in an RPO database only Phone 1) and one column for each dynamic field of the schema. Cells without a value show "—". With the Filter results… box you narrow down the rows of the page you are looking at; with a click on a row you open the details. Email and Website are clickable links (the email opens the mail program, the website opens in a new tab); the email is shown as a link (green).

To search for a specific contact press Search: you switch to the search with filters.

Searching

You have three filters:

Filter How it works
Name / Surname / Company name Finds the contacts in which the text appears in the first name, or in the last name, or in the company name. A part is enough (e.g. "ross" finds "Rossi" and "Rossetti")
Phone Finds the contacts in which the number appears in any of the nine phone fields. A part of the number is enough
Other field + Search text Choose any field (e.g. ZIP code, City, Address or a dynamic field) and the text to search for within it

You can fill in just one: if you fill in more than one, the contact must meet all of them. Press Search (or Enter in one of the boxes). The results meet both filters when, for example, Phone and Other field (here the City field) are filled in together, and the Filter results… box narrows them further.

Search phones using digits only

Thelgo saves numbers without spaces, points or dashes, and with "00" in place of "+". So search "0212345678", not "02 1234 5678"; for an international prefix write "0039…", not "+39…".

Notes on Other field:

  • it only offers the fields that have at least one value in the contacts;
  • in the search on all databases it only offers the standard fields, not the dynamic ones (which depend on each database's schema).

The results

Above the table you see how many contacts were found (e.g. "37 results found"). A search shows at most 500 results: if you get that many, narrow the filters.

Column Notes
Company name, First name, Last name
Phone The contact's first number
Email, City
Database Only in the search on all databases

An anonymized contact shows the Anonymized label next to the company name. The Email in the results is a link that opens the mail program. Click a column header to sort. With the Filter results… box you narrow the list already found on the fly, without repeating the search. If nothing is found, "No contact found." appears.

Click a result to open its details.

Contact details

At the top you see the contact's name (company name, or first and last name) and the database it belongs to, with the buttons:

Button When it appears
Unblock "Not authorized" Only if the contact is blocked by a "Not authorized" outcome and is not anonymized (see The "Not authorized" block)
Delete Only if you opened the details from the search on all databases or from the one on a database (or from the preview). It does not appear if you arrive from a campaign's search or from the Campaigns report. Disabled if the contact is enrolled in a campaign
Anonymize With the same conditions as Delete, if you have the "Anonymization" permission and the contact is not already anonymized (see Anonymizing a contact)
Back Always

The Edit button is inside the Contact information card (see Contact information).

When the details are opened from a database search, the top shows Delete (off, because the contact is in a campaign), Anonymize and Back; the Contact information card has Edit; the Campaigns section shows the current outcome, calls made, attempts, date added, Outcome set by (for example "Sistema Appuntamento Agente · Agent (from appointment)") and Appointment ("31/10/2026 10:00 — (Mario Rossi)": the appointment has no outcome, so nothing appears after the dash).

Contact information

It shows the filled-in data, in this order: Company name, First name, Last name, Address, City (with province and ZIP code), Email, Website, Reference ID 1, Reference ID 2 and all the Phone numbers. Email and Website are clickable links: the email opens the mail program, the website opens in a new tab (if the data has no "http", Thelgo adds "https://"). Below a line you find the filled-in dynamic fields. At the top right of the card is the Edit button (see Editing the data): it does not appear if you arrived from the Campaigns report or if the contact is anonymized.

If the contact is anonymized, the page title at the top is Anonymized contact, the red box "Contact anonymized on …. The personal data can no longer be recovered." appears and the contact information is "-" (see Anonymizing a contact).

If the contact is registered with the Public Opposition Register, a red box appears at the top: "This contact is registered with the Public Opposition Registry (RPO) since …: whether it can be called in a given campaign depends on the rules chosen at the last RPO list import." (see Public Opposition Register (RPO)).

Campaigns

For each campaign the contact is enrolled in:

Data Meaning
Current outcome The last outcome recorded in that campaign (e.g. Positive, Call back, Not authorized), or "—" if it has not been called yet. If it is "Not authorized", see The "Not authorized" block
Calls made How many calls were recorded in that campaign
Attempts How many attempts the contact has in that campaign
Added on When it was added to the campaign
Outcome set by Who gave the current outcome and how: the user's name followed by the origin of the outcome, if it is not a normal call (see the table below). It only appears if there is an outcome
Appointment Date and time of the most recent appointment, if there is one, with its outcome and, in brackets, the agent it is assigned to

If it is not enrolled in any campaign, "This contact is not enrolled in any campaign." appears.

Origin of the outcome. After the name of who set the outcome (Outcome set by), an indication of how the outcome was entered may appear:

Indication Meaning
(none) Outcome given by an operator with a normal call
Administrator Outcome set by an administrator from the details (see Edit or remove the outcome)
Public API Outcome entered by an external system through the API (see External API)
Agent (from appointment) Outcome given by the agent on the appointment
Campaign engine Outcome written automatically by the campaign engine (Predictive/Voice AI), without an operator: in this case only this wording appears
VoiceAI (bot) Outcome recorded by the bot of a VoiceAI campaign: it appears under the operator "VoiceAI (system)"

The appointment outcome is the outcome of the appointment itself (e.g. Positive, Negative, Suspended, Postponed) or Cancelled if the Quality Check cancelled the contact. If the appointment does not have an outcome yet, after the date the dash remains with no text.

If you arrive from a campaign's search

When you open the details from the search of one campaign, in the Campaigns section you see the details (outcome, calls, attempts, Outcome set by, appointment) of that campaign only; for the other campaigns only the name appears.

Survey

Requires the "Campaigns" permission.

On campaigns that have a survey, below the campaign data the Survey row appears with the status (Not started, In progress, Completed), the Total score, the score band with its colour, "Last modified: …" and the list of answers, each with its points. The button opens the fill-in popup: Start survey, Resume survey or, once the survey is completed, Correct the answers. From the Survey report the card is read-only and the button becomes Review survey. The section appears only for the campaign from which you opened the card and not for an anonymized contact.

A correction made after completion is recorded in the Audit log as Survey answers changed after completion; if the correction opens new questions, the survey goes back to In progress. If you change an answer that changes the branch, the answers of the abandoned branch are lost after you confirm.

Edit or remove the outcome

Requires the "Campaigns" permission.

If you open the details from the contact search of a campaign (see Campaign contacts), the Edit outcome button appears on the row of that campaign. It does not appear if you arrive from the search on a database or on all databases. The Edit outcome — popup opens:

  1. Choose the level: First level or Quality Check. The Quality Check is only available if the first-level outcome is already Positive.
  2. Read the Current outcome and choose the New outcome.
  3. If the campaign has an outcome profile that provides details for the chosen outcome, the Outcome detail drop-downs appear and, if the detail has second details, Second detail: for you they are always optional. When you change outcome the choice is reset.
  4. Choose the Operator to whom to attribute the outcome (required) and, if needed, the Notes.
  5. For the outcomes that require it, fill in the Callback date and time (it cannot be in the past) and, where provided, the Callback type (Private or Public). For the Positive outcome you can Schedule appointment (Title, Start, End, Agent, Notes; not in the past); if the campaign requires it for Positives, the appointment is required. If the campaign requires the survey for Positives and it is not completed, "The survey of this campaign is required for the Positive outcome and is not completed yet: fill it in before saving." appears with the button to open it, and Save stays off.
  6. Press Save: "Outcome saved successfully." appears.

The popup also has the Remove outcome, Cancel and Save buttons.

With Remove outcome you delete the last outcome recorded for the chosen level, after the confirmation "Remove the last outcome recorded for this level? This rolls back the outcome and the attempts, but not the other statistics, and cannot be undone." The two actions are recorded in the Audit log as Outcome set by administrator and Outcome removed by administrator.

The details do not list the single calls. To see date, operator, outcome, outcome details and notes of each call use the Calls report.

The "Not authorized" block

When an operator records the Not authorized outcome (the contact asks not to be called any more), the contact is blocked: it is no longer offered in any campaign, neither in Preview nor in Predictive, nor in the Quality Check queue (see Outcomes and callbacks in the operator manual). In the details you recognize it by the red box "This contact is blocked by a "Not authorized" outcome from … and is no longer called in any campaign, until manually unblocked." and by the Current outcome "Not authorized" in the campaign where it was recorded. Before Edit there is the Unblock "Not authorized" button; Delete stays disabled because the contact is enrolled in a campaign.

A "Not authorized" contact cannot even be opened by the operator, neither from the search nor from Callbacks nor from the Quality Check: the operator sees "This contact is not authorized to be contacted." (see Contact search). It does not appear either in the Callbacks list.

The block, however, concerns the contact of that database: if the same number is in another database, or you re-import it after deleting the database, it does not appear as blocked there. Keep this in mind when you prepare new lists.

Unblocking a "Not authorized" contact

Unblock a contact only if you are certain that the person has given consent to be called again (for example the outcome had been recorded by mistake).

  1. Open the contact details (see How to open it).
  2. Press Unblock "Not authorized" at the top right.

The block is removed immediately, without a confirmation request: the red box disappears and the operation is recorded in the Audit log with the action Contact unblocked from 'do not authorize', in your name.

Unblocking does not delete the outcome

Unblocking only removes the general block on the contact. The Not authorized outcome already recorded in a campaign stays as the Current outcome of that campaign and is a final outcome: in that campaign the contact will not be called again. It can be called again in the other campaigns where it does not already have a final outcome (for example a new campaign). Editing the contact's data, by itself, does not remove the block.

When the button does not appear

The button is only there if the contact is blocked and is not anonymized (an anonymized contact is always "Not authorized" and cannot be unblocked: "Il nominativo è stato anonimizzato: non può essere sbloccato." (The contact has been anonymized: it cannot be unblocked.)). If for some reason the unblocking fails, a red warning appears at the bottom; if the contact was not blocked, the message is "The contact is not blocked by "Not authorized"."

Editing the data

  1. Press Edit in the Contact information card: Edit contact details opens. The button is not there if you arrived from the Campaigns report or if the contact is anonymized (the save would be rejected with "The contact has been anonymized: its data cannot be changed.").
  2. Correct the fields: Company name, First name, Last name, Email, Address, Street number, City, Province, ZIP code, Website, Reference ID 1, Reference ID 2.
  3. In the Phone numbers section you have nine boxes (from "Phone 1" to "Phone 9"): At least one phone number is required. If the database is an RPO database you have a single box, with the warning "RPO database: only Phone1 is allowed."
  4. In the Custom fields section you find all the fields of the database's schema, even those still empty.
  5. Press Save: the window closes and the green warning "Changes saved successfully." appears at the bottom. If the save fails, the window stays open and a red warning appears with the reason.

Good to know:

  • numbers are cleaned (digits only, "+" becomes "00") and compacted: if you leave a box empty in the middle, the following numbers move up a position;
  • none of the numbers may already be present in another contact of the same database, otherwise the red warning "Number already in the database: …." appears;
  • the number 9999999999 is reserved for anonymized contacts and cannot be used: "The number … is reserved and cannot be used." appears;
  • the changes apply to the contact in all the campaigns it is enrolled in: the operator sees them the next time the card is opened;
  • dynamic fields are checked according to their type (Number, Date…): an inconsistent value is rejected with a message like "Value "…" is not valid for the field "…" (type …).", with the same rules as the import. A dynamic field left empty is always fine, whatever its type: dynamic fields are never required.

Every change is recorded in the Audit log.

Deleting a contact

The Delete button only appears if you opened the details from the search on all databases or from the one on a database (not from a campaign's search or from the Campaigns report). You can only delete a contact that is not enrolled in any campaign: otherwise the button is disabled and, hovering over it, "A contact already added to a campaign cannot be deleted" appears. This way the call history is not lost.

  1. Press Delete.
  2. At the question "Are you sure you want to permanently delete this contact? This cannot be undone." press Delete permanently.

You go back to the previous page (if the deletion fails, a red warning with the reason appears at the bottom). The deletion is also recorded in the Audit log.

Deleting many contacts at once

There is no multiple deletion of contacts. To get rid of a whole list, delete the database from the Databases page (beware: it also deletes its campaigns).

Anonymizing a contact

Requires the "Anonymization" permission.

Anonymization answers a request to delete personal data (right to be forgotten) and is irreversible. The Anonymize button appears with the same conditions as Delete (search on all databases or on a database), but it is always active, even if the contact is in one or more campaigns.

  1. Open the contact details and press Anonymize.
  2. In the Anonymize contact popup read: "You are about to anonymize this contact (right to be forgotten). The following will be done:"
    • personal details (name, address, email and others) are masked and phone numbers are replaced;
    • personal data in calls, emails, SMS, appointments and transcriptions is cleared;
    • the contact is blocked in all campaigns and will no longer be called;
    • campaign outcomes and reports remain unchanged.
  3. Read the red warning "This operation is irreversible: the personal data can no longer be recovered."
  4. Under "Type ANONYMIZE to confirm:" write the word ANONYMIZE (upper and lower case do not matter).
  5. Press Anonymize (Cancel closes without doing anything). The button stays disabled until the word is exact.

The message "Contact anonymized." appears and the details reload with the masked data. If it fails, "Unable to anonymize the contact." appears or the reason, for example "Il nominativo è già stato anonimizzato." (The contact has already been anonymized.)

The popup shows the list of effects, the red irreversibility warning, the box with the ANONYMIZE placeholder and the Cancel and Anonymize buttons (off until the word is written).

After anonymization, the details show: title Anonymized contact, the box "Contact anonymized on … The personal data can no longer be recovered." and, below it, the box of the "Not authorized" block (the contact is blocked in all campaigns, but there is no Unblock "Not authorized": it cannot be unblocked), contact information "-", phone 9999999999, Current outcome unchanged (for example "—"), no Edit or Anonymize, and Delete off.

What gets masked, how to anonymize many contacts at once from a list of numbers and where a trace of the operation remains is in the Contact anonymization page.