The contact file and its requirements, the import report, upload history, file retention, do-not-call screening and the contacts table.
Campaign contacts
Contacts upload
The contact file is uploaded in the Contacts upload block — at the Contacts step when you create a campaign, and in the card of a campaign in the Draft status. The file can be replaced only in a draft as well:
every new upload replaces the contacts of the previous one — the cabinet asks you to confirm the replacement; the upload history is kept;
after a replacement you need a new decision on do-not-call matches (see the “Do-not-call screening” section below) and a new attestation signature — a signature made under the previous file version does not count.
Download the sample with the “Download the sample file” button. The sample is built from the published version of the campaign agent — it already contains the columns that agent uses in its prompts. Without a chosen agent the button is unavailable: “Pick an agent — the sample is built from its variables”. It is the fastest way to avoid empty variables during the conversation.
Contact file requirements
Format and limits
CSV and XLSX are accepted. The legacy XLS format is not supported — re-save the file.
CSV: UTF-8 encoding (with or without BOM) or Windows-1251; the separator ,, ; or tab is detected automatically.
XLSX:only the first sheet is read.
The first row holds the headers; data starts on the second row.
Limits: up to 50,000 rows and up to 10 MB; a file over the limit is rejected in full, not truncated.
Phone number
The phone number is the only column required on every market. Under the US market profile (us_tcpa) a contact_zip or contact_state column is required too — see US campaigns.
The platform finds the column by header: phone, contact_phone, phone_number, mobile, cell, tel, telephone, msisdn, телефон, номер, номер_телефона, and similar.
When no recognizable header exists, the column is detected by content: the one where at least 80% of the values look like phone numbers. If there is no such column, the file is rejected.
A number is readable when it has at least 10 digits. A row with an unreadable number is not dropped silently: it appears in the import report with its row number.
Numbers are compared by their last 10 digits: +7 701 123 45 67 and 8 701 123 45 67 are the same number.
Name
The contact name is taken from a name, full_name or фио column; without one it is assembled from a pair of columns: contact_first_name + contact_last_name, first_name + last_name, or имя + фамилия. The assembled name reaches the agent as the {{name}} variable.
Time zone
A timezone column (also tz, time_zone, contact_timezone, часовой_пояс) sets the contact’s zone in IANA format, for example Asia/Almaty. An unknown zone is a warning in the report, not a rejected row: the contact is called in the campaign time zone. An empty zone means the campaign time zone too.
Variables
Any other column becomes a call variable: amount owed, payment date, and so on.
The variable key comes from the header: case does not matter, spaces and hyphens become _ — “Amount Due” becomes amount_due.
When two headers give the same key, the first column wins and the report gets a “Column name collision” warning.
The phone, time zone, contract and role columns do not become variables.
Variables ticked In signature on the agent are checked against the file at launch: a missing column blocks the launch.
Contract groups
To tie several numbers to one contract (the borrower and third parties), add two columns:
contract_id (also contract, договор, номер_договора) — the contract id, up to 64 characters;
role (also роль) — borrower or third_party.
A row is rejected when the contract id is longer than 64 characters, when a contract id is set but the role is empty or unknown, or when a role is set without a contract id. Rows with neither are ordinary contacts outside any group.Members of one group are dialed in parallel. After a successful conversation with the borrower, the contacts of the same contract still waiting to be dialed in every launched campaign of the organization are suppressed with the reason “Contract group consent”. A conversation counts as successful when its goal is achieved if the agent has a success criterion, and any conversation that took place if it has none.
US campaigns
Under the us_tcpa market profile the file must have a contact_zip or contact_state column. A row whose location is not recognized or whose geography is not callable is rejected on its own; ZIP, state and city mismatches are warnings. Details are on the US campaigns page.
Duplicate numbers
The same person may appear in the file several times; the Duplicate numbers setting decides what happens:
Reject duplicates (to report) (the default) — the first occurrence stays, the rest go into the report as errors. Repeated rows usually mean the export from your system is misbehaving, and that is worth knowing.
Keep first occurrence — repeats are dropped and go into the report as warnings.
Keep last occurrence — the last row stays; for when corrected rows are appended to the end of the file.
Within one file a number enters the campaign at most once. A batch added to a running campaign with a number the campaign already has is accepted as a new contact, and the number is dialed again.
Why a file may be rejected in full: the phone column was not found or cannot be identified unambiguously; the file has no data rows or not a single usable row; the 50,000-row or 10 MB limit is exceeded; an unsupported format (XLS included) or a corrupted file; under the us_tcpa profile neither contact_zip nor contact_state is present. The reason and advice on what to fix are shown in the File refused block.
Import results
The Import results block shows the outcome of an upload:
the Accepted, With warnings, Rejected and Duplicates found counters;
a red Blocked (DNC): N badge when the file has numbers from the registry — the number of contacts that will not be dialed. Such rows are red in Row issues too: In the do-not-call registry;
Phone column — found “by header” or “detected automatically”, with the column name; for CSV, the Encoding;
Row issues — the issues grouped by kind, with row numbers;
the file version, the source file storage state and the Download source file button;
the Variables table: the file column, the variable key and the Fill rate as “N of M”;
the agent variables that have no column in the file: their values will be empty in the conversation.
When a file is rejected in full, a File refused block replaces the summary, with the reason, advice on what to fix, and “No contacts were created.”
Import report
For an accepted upload the Download report (CSV) and Download report (XLSX) buttons are always shown. A rejected file has no report, with two exceptions: every row was rejected by geography, or a batch of calls was refused.The report has one line per issue: row number, severity (error or warning), code, reason text, the values sent, and — for duplicates — the row the line repeats. In XLSX the lines and the summary are on the Rows and Summary sheets; in CSV the summary block follows the lines.
Upload history
With more than one upload, the Upload history block appears: file, upload time, version (the launched one is marked “launched”), the number of accepted rows or the “Refused” mark, and the Download source file button when the source is stored. Clicking a line opens the results of that upload.
Adding calls to a running campaign
A batch of numbers can be added to any campaign that has not ended, with the Add a batch of calls block in the campaign card. A batch is accepted or refused as a whole, and each batch carries its own attestation. Details are on the Adding calls page.
File retention
Only accepted uploads are kept: the attestation signature points at a specific document, and until the retention period expires the file is downloaded with the Download source file button. Rejected files are not kept.The full retention period is counted from the campaign launch and is configured per organization. The file of a campaign that was never launched is kept only briefly — two weeks by default. Retention can be switched off entirely: only the file’s metadata and checksum remain, but you lose the ability to produce the very file you attested the right to call under. When the period expires the file is deleted, and that is recorded too: its metadata and the deletion date are kept.
Do-not-call screening
The uploaded file is screened against the do-not-call registry, and the Matches against the do-not-call registry block shows the whole result of that screening:
readable rows checked — how many rows of the file had a readable phone and were screened;
rows not screened — the phone could not be read; these rows do not count as clean and are named separately;
a red N contacts blocked by DNC badge — how many contacts will not be dialed. When a number appears in the file more than once and there are more matched rows than contacts, the row count is shown beside it as a caption;
a table of matches with the columns Row, Number, Name, Reason and In registry since — quoted in full, not hinted at. When there are many matches the preview is truncated, and a Download exact list button appears beside it — it downloads CSV.
With a zero result the block does not stay silent — it states that there are no matches and how many rows were checked.A decision is required before launch: Block the launch — I will remove the matches from the file (the default) or Skip them and launch the campaign without them. The decision is made only in a draft and only for the current file. It is written to the campaign audit — who, when, how many contacts, and for which file; a new upload voids the previous decision. The decision is kept: when you come back to the contacts step, you see the same choice. If no callable contact remains, skipping is unavailable.At launch the file is screened against the current state of the registry. If the registry changed after a decision to skip the matches, the launch is blocked again: “The registry changed after the decision — review the match list again”.The file itself is not modified: the rows stay as they are. Matched contacts get the Suppressed state right at launch and do not wait for their turn. Numbers added to the registry later, and contacts added after launch, are excluded at dial time.After launch the screen is frozen and labelled “As of launch” — the grounds on which the campaign went dialing are not recomputed after the fact.The suppression phases themselves — at launch and during the campaign — are counted in the “Scheduler state” block on the campaign card, next to the “Suppressed by policy” line.The cabinet and the Web API run this screening through the same code, so the result and its evidence are identical no matter where the campaign was launched from. A member can decide on do-not-call matches as well, since they run the whole campaign lifecycle — see Roles.
Campaign contacts
The Campaign contacts table contains the contacts loaded into the campaign. Above it are Search by number, Search by contract and the total count.Table columns:
Phone — the number as it was in the file;
Name;
Contract and Role — for contacts of a contract group;
Time zone — an empty zone is shown as “campaign time zone”;
State — Waiting, Dialing, Awaiting evaluation, Done, Exhausted or Suppressed. Under the state of a waiting or suppressed contact the reason is shown — for example, “Outside working hours”, “Frequency cap reached”, “On the do-not-call list (DNC)”, “Contract group consent”, “Withdrawn at the client’s request” — and a waiting contact also shows “Retry no earlier than” with a date;
Attempts.
Clicking a row expands the Contact variables.
Withdrawing contacts from dialing
Contacts are withdrawn from dialing at the client’s request only through the Web API: POST /v1/campaigns/{id}/contacts/withdraw — in one campaign, by numbers or contact IDs; POST /v1/contacts/withdraw — in every launched campaign of the organization, by numbers. A withdrawn contact moves to the Suppressed state with the reason “Withdrawn at the client’s request”. Details are in Withdrawing a contact from dialing.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"HubTalk AI","colors":{"primary":"#440099","light":"#6B21D6","dark":"#7C3AED"},"logo":{"light":"https://mintcdn.com/hubtalk/beMwuzhyHkgYeb3A/logo/new_logo.svg?fit=max\u0026auto=format\u0026n=beMwuzhyHkgYeb3A\u0026q=85\u0026s=fee415d6d73d48c227d61d8b9a2325f2","dark":"https://mintcdn.com/hubtalk/beMwuzhyHkgYeb3A/logo/new_logo_dark.svg?fit=max\u0026auto=format\u0026n=beMwuzhyHkgYeb3A\u0026q=85\u0026s=931310649ba4c376934c0ee30b816431"},"favicon":"https://mintcdn.com/hubtalk/GMvtjWdqWk0BhtuQ/favicon.svg?fit=max\u0026auto=format\u0026n=GMvtjWdqWk0BhtuQ\u0026q=85\u0026s=d2b125518b01c87a79756009ec74a5aa","styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":"v4/introduction"},{"language":"ru","href":"ru/v4/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hubtalk","hasAudioNarration":false,"actualSubdomain":"hubtalk","customDomains":["docs.hubtalk.ai"],"gitSource":{"type":"github","owner":"cybernetkz","repo":"cybernet_mintify_pub_docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afefd0a5246eb87f3605827","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"ru","tag":"Conversation Platform v4","count":44},{"language":"en","tag":"Conversation Platform v4","count":44},{"language":"ru","tag":"Руководство по платформе","count":42},{"language":"en","tag":"Platform Guide","count":42},{"language":"ru","tag":"v4 Tutorial","count":29},{"language":"en","tag":"v4 Tutorial","count":26},{"language":"ru","tag":"v2 - v4 адаптер","count":19},{"language":"en","tag":"v2 - v4 adapter","count":19},{"language":"ru","tag":"API Reference","count":16},{"language":"en","tag":"API Reference","count":16},{"language":"ru","tag":"Технический справочник","count":12},{"language":"en","tag":"Technical reference","count":12},{"language":"ru","tag":"Настройки агента","count":9},{"language":"en","tag":"Agent settings","count":9},{"language":"ru","tag":"API для клиента V2","count":7},{"language":"ru","tag":"История и отчёты","count":7},{"language":"en","tag":"API for the V2 client","count":7},{"language":"en","tag":"History \u0026 reports","count":7},{"language":"ru","tag":"Кампании","count":6},{"language":"en","tag":"Campaigns","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"v4/platform/campaigns/contacts","slug":"/v4/platform/campaigns/contacts","pageMetadata":{"title":"Campaign contacts","description":"The contact file and its requirements, the import report, upload history, file retention, do-not-call screening and the contacts table.","href":"/v4/platform/campaigns/contacts"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The contact file and its requirements, the import report, upload history, file retention, do-not-call screening and the contacts table.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,OptimizedImage,Tip,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`campaign-contacts`,children:`Campaign contacts`}),`\n`,_jsx(Heading,{level:`2`,id:`contacts-upload`,children:`Contacts upload`}),`\n`,_jsxs(_components.p,{children:[`The contact file is uploaded in the `,_jsx(_components.strong,{children:`Contacts upload`}),` block — at the Contacts step when you create a campaign, and in the card of a campaign in the `,_jsx(_components.strong,{children:`Draft`}),` status. The file can be replaced only in a draft as well:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`every new upload `,_jsx(_components.strong,{children:`replaces the contacts`}),` of the previous one — the cabinet asks you to confirm the replacement; the upload history is kept;`]}),`\n`,_jsxs(_components.li,{children:[`after a replacement you need a new `,_jsx(_components.strong,{children:`decision on do-not-call matches`}),` (see the “Do-not-call screening” section below) and a new `,_jsx(_components.strong,{children:`attestation signature`}),` — a signature made under the previous file version does not count.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Numbers are added to a running campaign only as batches — with the `,_jsx(_components.strong,{children:`Add a batch of calls`}),` block, see `,_jsx(_components.a,{href:`#adding-calls-to-a-running-campaign`,children:`Adding calls to a running campaign`}),`.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Download the sample with the “Download the sample file” button.`}),` The sample is built from the `,_jsx(_components.strong,{children:`published version of the campaign agent`}),` — it already contains the columns that agent uses in its prompts. Without a chosen agent the button is unavailable: “Pick an agent — the sample is built from its variables”. It is the fastest way to avoid empty variables during the conversation.`]})}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_upload_en.png?fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=417109c5354dac12ca84a778be49a5eb`,alt:`Contacts upload and Import results blocks`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`900`,height:`900`,\"data-path\":`images/v4_campaign_contacts_upload_en.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_upload_en.png?w=280\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=677f02e1d0481e50ffa4c11042aa70f3 280w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_upload_en.png?w=560\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=60a369546cebd452d2baad89186d2bac 560w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_upload_en.png?w=840\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=12723d16c0357961d0579b22d5be6539 840w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_upload_en.png?w=1100\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=9464bea4b1c71aa3cf7980fb8142e2dc 1100w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_upload_en.png?w=1650\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=e03cd2dc00f3d25e20d7a35872f41fab 1650w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_upload_en.png?w=2500\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=846c5b558466ccad733a6de373decbe4 2500w`}),`\n`,_jsx(Heading,{level:`2`,id:`contact-file-requirements`,children:`Contact file requirements`}),`\n`,_jsx(Heading,{level:`3`,id:`format-and-limits`,children:`Format and limits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`CSV`}),` and `,_jsx(_components.strong,{children:`XLSX`}),` are accepted. The legacy `,_jsx(_components.strong,{children:`XLS format is not supported`}),` — re-save the file.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`CSV:`}),` UTF-8 encoding (with or without BOM) or Windows-1251; the separator `,_jsx(_components.code,{children:`,`}),`, `,_jsx(_components.code,{children:`;`}),` or tab is detected automatically.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`XLSX:`}),` `,_jsx(_components.strong,{children:`only the first sheet`}),` is read.`]}),`\n`,_jsx(_components.li,{children:`The first row holds the headers; data starts on the second row.`}),`\n`,_jsxs(_components.li,{children:[`Limits: up to `,_jsx(_components.strong,{children:`50,000 rows`}),` and up to `,_jsx(_components.strong,{children:`10 MB`}),`; a file over the limit is `,_jsx(_components.strong,{children:`rejected in full, not truncated`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`phone-number`,children:`Phone number`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`phone number`}),` is the only column required on every market. Under the US market profile (`,_jsx(_components.code,{children:`us_tcpa`}),`) a `,_jsx(_components.code,{children:`contact_zip`}),` or `,_jsx(_components.code,{children:`contact_state`}),` column is required too — see `,_jsx(_components.a,{href:`#us-campaigns`,children:`US campaigns`}),`.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The platform finds the column by header: `,_jsx(_components.code,{children:`phone`}),`, `,_jsx(_components.code,{children:`contact_phone`}),`, `,_jsx(_components.code,{children:`phone_number`}),`, `,_jsx(_components.code,{children:`mobile`}),`, `,_jsx(_components.code,{children:`cell`}),`, `,_jsx(_components.code,{children:`tel`}),`, `,_jsx(_components.code,{children:`telephone`}),`, `,_jsx(_components.code,{children:`msisdn`}),`, `,_jsx(_components.code,{children:`телефон`}),`, `,_jsx(_components.code,{children:`номер`}),`, `,_jsx(_components.code,{children:`номер_телефона`}),`, and similar.`]}),`\n`,_jsx(_components.li,{children:`When no recognizable header exists, the column is detected by content: the one where at least 80% of the values look like phone numbers. If there is no such column, the file is rejected.`}),`\n`,_jsxs(_components.li,{children:[`A number is readable when it has `,_jsx(_components.strong,{children:`at least 10 digits`}),`. A row with an unreadable number is not dropped silently: it appears in the import report with its row number.`]}),`\n`,_jsxs(_components.li,{children:[`Numbers are compared by their `,_jsx(_components.strong,{children:`last 10 digits`}),`: `,_jsx(_components.code,{children:`+7 701 123 45 67`}),` and `,_jsx(_components.code,{children:`8 701 123 45 67`}),` are the same number.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`name`,children:`Name`}),`\n`,_jsxs(_components.p,{children:[`The contact name is taken from a `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`full_name`}),` or `,_jsx(_components.code,{children:`фио`}),` column; without one it is assembled from a pair of columns: `,_jsx(_components.code,{children:`contact_first_name`}),` + `,_jsx(_components.code,{children:`contact_last_name`}),`, `,_jsx(_components.code,{children:`first_name`}),` + `,_jsx(_components.code,{children:`last_name`}),`, or `,_jsx(_components.code,{children:`имя`}),` + `,_jsx(_components.code,{children:`фамилия`}),`. The assembled name reaches the agent as the `,_jsx(_components.code,{children:`{{name}}`}),` variable.`]}),`\n`,_jsx(Heading,{level:`3`,id:`time-zone`,children:`Time zone`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`timezone`}),` column (also `,_jsx(_components.code,{children:`tz`}),`, `,_jsx(_components.code,{children:`time_zone`}),`, `,_jsx(_components.code,{children:`contact_timezone`}),`, `,_jsx(_components.code,{children:`часовой_пояс`}),`) sets the contact’s zone in IANA format, for example `,_jsx(_components.code,{children:`Asia/Almaty`}),`. An unknown zone is a warning in the report, not a rejected row: the contact is called in the campaign time zone. An empty zone means the campaign time zone too.`]}),`\n`,_jsx(Heading,{level:`3`,id:`variables`,children:`Variables`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Any other column`}),` becomes a call variable: amount owed, payment date, and so on.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The variable key comes from the header: case does not matter, spaces and hyphens become `,_jsx(_components.code,{children:`_`}),` — “Amount Due” becomes `,_jsx(_components.code,{children:`amount_due`}),`.`]}),`\n`,_jsx(_components.li,{children:`When two headers give the same key, the first column wins and the report gets a “Column name collision” warning.`}),`\n`,_jsx(_components.li,{children:`The phone, time zone, contract and role columns do not become variables.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Variables ticked `,_jsx(_components.strong,{children:`In signature`}),` on the agent are checked against the file at launch: a missing column blocks the launch.`]}),`\n`,_jsx(Heading,{level:`3`,id:`contract-groups`,children:`Contract groups`}),`\n`,_jsx(_components.p,{children:`To tie several numbers to one contract (the borrower and third parties), add two columns:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`contract_id`}),` (also `,_jsx(_components.code,{children:`contract`}),`, `,_jsx(_components.code,{children:`договор`}),`, `,_jsx(_components.code,{children:`номер_договора`}),`) — the contract id, up to 64 characters;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`role`}),` (also `,_jsx(_components.code,{children:`роль`}),`) — `,_jsx(_components.code,{children:`borrower`}),` or `,_jsx(_components.code,{children:`third_party`}),`.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`A row is rejected when the contract id is longer than 64 characters, when a contract id is set but the role is empty or unknown, or when a role is set without a contract id. Rows with neither are ordinary contacts outside any group.`}),`\n`,_jsxs(_components.p,{children:[`Members of one group are dialed in parallel. After a successful conversation with the borrower, the contacts of the same contract still waiting to be dialed `,_jsx(_components.strong,{children:`in every launched campaign of the organization`}),` are suppressed with the reason “Contract group consent”. A conversation counts as successful when its goal is achieved if the agent has a success criterion, and any conversation that took place if it has none.`]}),`\n`,_jsx(Heading,{level:`3`,id:`us-campaigns`,children:`US campaigns`}),`\n`,_jsxs(_components.p,{children:[`Under the `,_jsx(_components.code,{children:`us_tcpa`}),` market profile the file must have a `,_jsx(_components.code,{children:`contact_zip`}),` or `,_jsx(_components.code,{children:`contact_state`}),` column. A row whose location is not recognized or whose geography is not callable is rejected on its own; ZIP, state and city mismatches are warnings. Details are on the `,_jsx(_components.a,{href:`/v4/platform/campaigns/us-market`,children:`US campaigns`}),` page.`]}),`\n`,_jsx(Heading,{level:`3`,id:`duplicate-numbers`,children:`Duplicate numbers`}),`\n`,_jsxs(_components.p,{children:[`The same person may appear in the file several times; the `,_jsx(_components.strong,{children:`Duplicate numbers`}),` setting decides what happens:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Reject duplicates (to report)`}),` (the default) — the first occurrence stays, the rest go into the report as errors. Repeated rows usually mean the export from your system is misbehaving, and that is worth knowing.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Keep first occurrence`}),` — repeats are dropped and go into the report as warnings.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Keep last occurrence`}),` — the last row stays; for when corrected rows are appended to the end of the file.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Within one file`}),` a number enters the campaign at most once. A batch added to a running campaign with a number the campaign already has is accepted as a new contact, and the number is dialed again.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Why a file may be rejected in full:`}),` the phone column was not found or cannot be identified unambiguously; the file has no data rows or not a single usable row; the 50,000-row or 10 MB limit is exceeded; an unsupported format (XLS included) or a corrupted file; under the `,_jsx(_components.code,{children:`us_tcpa`}),` profile neither `,_jsx(_components.code,{children:`contact_zip`}),` nor `,_jsx(_components.code,{children:`contact_state`}),` is present. The reason and advice on what to fix are shown in the `,_jsx(_components.strong,{children:`File refused`}),` block.`]})}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_sample_file_en.png?fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=bb5212379c6e73a7bf0c7dae783cf960`,alt:`The contacts upload block: file limits and the per-agent sample file button`,\"data-og-width\":`850`,width:`850`,\"data-og-height\":`192`,height:`192`,\"data-path\":`images/v4_campaign_sample_file_en.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_sample_file_en.png?w=280\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=f3b4f9e1b435efaab8bbd1abfc56a4e3 280w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_sample_file_en.png?w=560\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=0a76232b5e4f6a9525c77fb518251609 560w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_sample_file_en.png?w=840\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=f1182ac3c05d8138eff100b558a1e4ac 840w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_sample_file_en.png?w=1100\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=17e55c2cd5044a054c298df0e8392a2b 1100w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_sample_file_en.png?w=1650\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=16e28419f860b3ecda58cd7a73889cab 1650w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_sample_file_en.png?w=2500\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=ad828fce964220f7ee6e265bb1f31a71 2500w`}),`\n`,_jsx(Heading,{level:`2`,id:`import-results`,children:`Import results`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Import results`}),` block shows the outcome of an upload:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`the `,_jsx(_components.strong,{children:`Accepted`}),`, `,_jsx(_components.strong,{children:`With warnings`}),`, `,_jsx(_components.strong,{children:`Rejected`}),` and `,_jsx(_components.strong,{children:`Duplicates found`}),` counters;`]}),`\n`,_jsxs(_components.li,{children:[`a red `,_jsx(_components.strong,{children:`Blocked (DNC): N`}),` badge when the file has numbers from the registry — the number of contacts that will not be dialed. Such rows are red in `,_jsx(_components.strong,{children:`Row issues`}),` too: `,_jsx(_components.strong,{children:`In the do-not-call registry`}),`;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Phone column`}),` — found “by header” or “detected automatically”, with the column name; for CSV, the `,_jsx(_components.strong,{children:`Encoding`}),`;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Row issues`}),` — the issues grouped by kind, with row numbers;`]}),`\n`,_jsxs(_components.li,{children:[`the file version, the source file storage state and the `,_jsx(_components.strong,{children:`Download source file`}),` button;`]}),`\n`,_jsxs(_components.li,{children:[`the `,_jsx(_components.strong,{children:`Variables`}),` table: the file column, the variable key and the `,_jsx(_components.strong,{children:`Fill rate`}),` as “N of M”;`]}),`\n`,_jsx(_components.li,{children:`the agent variables that have no column in the file: their values will be empty in the conversation.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`When a file is rejected in full, a `,_jsx(_components.strong,{children:`File refused`}),` block replaces the summary, with the reason, advice on what to fix, and “No contacts were created.”`]}),`\n`,_jsx(Heading,{level:`3`,id:`import-report`,children:`Import report`}),`\n`,_jsxs(_components.p,{children:[`For an accepted upload the `,_jsx(_components.strong,{children:`Download report (CSV)`}),` and `,_jsx(_components.strong,{children:`Download report (XLSX)`}),` buttons are always shown. A rejected file has no report, with two exceptions: every row was rejected by geography, or a batch of calls was refused.`]}),`\n`,_jsxs(_components.p,{children:[`The report has one line per issue: row number, severity (error or warning), code, reason text, the values sent, and — for duplicates — the row the line repeats. In XLSX the lines and the summary are on the `,_jsx(_components.strong,{children:`Rows`}),` and `,_jsx(_components.strong,{children:`Summary`}),` sheets; in CSV the summary block follows the lines.`]}),`\n`,_jsx(Heading,{level:`2`,id:`upload-history`,children:`Upload history`}),`\n`,_jsxs(_components.p,{children:[`With more than one upload, the `,_jsx(_components.strong,{children:`Upload history`}),` block appears: file, upload time, version (the launched one is marked “launched”), the number of accepted rows or the “Refused” mark, and the `,_jsx(_components.strong,{children:`Download source file`}),` button when the source is stored. Clicking a line opens the results of that upload.`]}),`\n`,_jsx(Heading,{level:`2`,id:`adding-calls-to-a-running-campaign`,children:`Adding calls to a running campaign`}),`\n`,_jsxs(_components.p,{children:[`A batch of numbers can be added to any campaign that has not ended, with the `,_jsx(_components.strong,{children:`Add a batch of calls`}),` block in the campaign card. A batch is accepted or refused as a whole, and each batch carries its own attestation. Details are on the `,_jsx(_components.a,{href:`/v4/platform/campaigns/call-additions`,children:`Adding calls`}),` page.`]}),`\n`,_jsx(Heading,{level:`2`,id:`file-retention`,children:`File retention`}),`\n`,_jsxs(_components.p,{children:[`Only `,_jsx(_components.strong,{children:`accepted`}),` uploads are kept: the attestation signature points at a specific document, and until the retention period expires the file is downloaded with the `,_jsx(_components.strong,{children:`Download source file`}),` button. Rejected files are not kept.`]}),`\n`,_jsxs(_components.p,{children:[`The full retention period is counted `,_jsx(_components.strong,{children:`from the campaign launch`}),` and is configured per organization. The file of a campaign that was never launched is kept only briefly — two weeks by default. Retention can be switched off entirely: only the file’s metadata and checksum remain, but you lose the ability to produce the very file you attested the right to call under. When the period expires the file is deleted, and that is recorded too: its metadata and the deletion date are kept.`]}),`\n`,_jsx(Heading,{level:`2`,id:`do-not-call-screening`,children:`Do-not-call screening`}),`\n`,_jsxs(_components.p,{children:[`The uploaded file is screened against the do-not-call registry, and the `,_jsx(_components.strong,{children:`Matches against the do-not-call registry`}),` block shows the whole result of that screening:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`readable rows checked`}),` — how many rows of the file had a readable phone and were screened;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`rows not screened`}),` — the phone could not be read; these rows do not count as clean and are named separately;`]}),`\n`,_jsxs(_components.li,{children:[`a red `,_jsx(_components.strong,{children:`N contacts blocked by DNC`}),` badge — how many contacts will not be dialed. When a number appears in the file more than once and there are more matched rows than contacts, the row count is shown beside it as a caption;`]}),`\n`,_jsxs(_components.li,{children:[`a table of matches with the columns `,_jsx(_components.strong,{children:`Row`}),`, `,_jsx(_components.strong,{children:`Number`}),`, `,_jsx(_components.strong,{children:`Name`}),`, `,_jsx(_components.strong,{children:`Reason`}),` and `,_jsx(_components.strong,{children:`In registry since`}),` — quoted in full, not hinted at. When there are many matches the preview is truncated, and a `,_jsx(_components.strong,{children:`Download exact list`}),` button appears beside it — it downloads CSV.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`With a zero result the block does not stay silent — it states that there are no matches and how many rows were checked.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/hubtalk/ZMcXy4W63yNhFG80/images/v4_campaign_dnc_screen_en.png?fit=max\u0026auto=format\u0026n=ZMcXy4W63yNhFG80\u0026q=85\u0026s=3fd988cf1d792757eef5c4d282cdec91`,alt:`Do-not-call screening before launch: two matches quoted in full and the decision to make`,\"data-og-width\":`850`,width:`850`,\"data-og-height\":`372`,height:`372`,\"data-path\":`images/v4_campaign_dnc_screen_en.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/hubtalk/ZMcXy4W63yNhFG80/images/v4_campaign_dnc_screen_en.png?w=280\u0026fit=max\u0026auto=format\u0026n=ZMcXy4W63yNhFG80\u0026q=85\u0026s=63735b40b826ef3098dca41a65cfe147 280w, https://mintcdn.com/hubtalk/ZMcXy4W63yNhFG80/images/v4_campaign_dnc_screen_en.png?w=560\u0026fit=max\u0026auto=format\u0026n=ZMcXy4W63yNhFG80\u0026q=85\u0026s=c92f84b5f6f91599e342c69023499004 560w, https://mintcdn.com/hubtalk/ZMcXy4W63yNhFG80/images/v4_campaign_dnc_screen_en.png?w=840\u0026fit=max\u0026auto=format\u0026n=ZMcXy4W63yNhFG80\u0026q=85\u0026s=388bf98e8523981ef3f87974fc6a1903 840w, https://mintcdn.com/hubtalk/ZMcXy4W63yNhFG80/images/v4_campaign_dnc_screen_en.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ZMcXy4W63yNhFG80\u0026q=85\u0026s=dadfe844e620198474877fa5711b4f54 1100w, https://mintcdn.com/hubtalk/ZMcXy4W63yNhFG80/images/v4_campaign_dnc_screen_en.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ZMcXy4W63yNhFG80\u0026q=85\u0026s=61adb7091e82975503bf8ba2478d753d 1650w, https://mintcdn.com/hubtalk/ZMcXy4W63yNhFG80/images/v4_campaign_dnc_screen_en.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ZMcXy4W63yNhFG80\u0026q=85\u0026s=6316cac8edadd1ea5f94d9298271569f 2500w`}),`\n`,_jsxs(_components.p,{children:[`A decision is required before launch: `,_jsx(_components.strong,{children:`Block the launch — I will remove the matches from the file`}),` (the default) or `,_jsx(_components.strong,{children:`Skip them and launch the campaign without them`}),`. The decision is made only in a draft and only for the current file. It is written to the campaign audit — who, when, how many contacts, and for which file; a new upload voids the previous decision. The decision is kept: when you come back to the contacts step, you see the same choice. If no callable contact remains, skipping is unavailable.`]}),`\n`,_jsxs(_components.p,{children:[`At launch the file is screened against the `,_jsx(_components.strong,{children:`current`}),` state of the registry. If the registry changed after a decision to skip the matches, the launch is blocked again: “The registry changed after the decision — review the match list again”.`]}),`\n`,_jsxs(_components.p,{children:[`The file itself is not modified: the rows stay as they are. Matched contacts get the `,_jsx(_components.strong,{children:`Suppressed`}),` state right at launch and do not wait for their turn. Numbers added to the registry later, and contacts added after launch, are excluded at dial time.`]}),`\n`,_jsxs(_components.p,{children:[`After launch the screen is `,_jsx(_components.strong,{children:`frozen`}),` and labelled “As of launch” — the grounds on which the campaign went dialing are not recomputed after the fact.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_dnc_frozen_en.png?fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=294fd2bf3f0283a2d7c491ecd76e99be`,alt:`The same block after launch: the \"As of launch\" label and the frozen list of matches`,\"data-og-width\":`2236`,width:`2236`,\"data-og-height\":`580`,height:`580`,\"data-path\":`images/v4_campaign_dnc_frozen_en.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_dnc_frozen_en.png?w=280\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=e87044acbeba8ddc240580a9ee322996 280w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_dnc_frozen_en.png?w=560\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=1d21b8ab2409bc0c97d471b1872b75e2 560w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_dnc_frozen_en.png?w=840\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=1a66923116c2270db3a6863420927696 840w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_dnc_frozen_en.png?w=1100\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=8dbbcc6777b315f17639a49cb52d589d 1100w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_dnc_frozen_en.png?w=1650\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=740f110ede69dc0eb107579277282bde 1650w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_dnc_frozen_en.png?w=2500\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=e29008eb9ce03a858909fe0f1a8c73fa 2500w`}),`\n`,_jsxs(_components.p,{children:[`The suppression phases themselves — `,_jsx(_components.strong,{children:`at launch`}),` and `,_jsx(_components.strong,{children:`during the campaign`}),` — are counted in the “Scheduler state” block on the campaign card, next to the “Suppressed by policy” line.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_scheduler_state_en.png?fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=82b3fd3a9576d84dbef6017aeb5b7af6`,alt:`Scheduler state: contacts by state, holds and the DNC suppression phases`,\"data-og-width\":`2236`,width:`2236`,\"data-og-height\":`484`,height:`484`,\"data-path\":`images/v4_campaign_scheduler_state_en.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_scheduler_state_en.png?w=280\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=4f0d8a9ebca82a1d9ca87f6686093508 280w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_scheduler_state_en.png?w=560\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=6d62938bc1e2e5a53767bfa0e332bbc4 560w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_scheduler_state_en.png?w=840\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=33fba3954abbdb4e1508d563fd2a3c15 840w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_scheduler_state_en.png?w=1100\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=72121c113f67f27897010514abc5d0c3 1100w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_scheduler_state_en.png?w=1650\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=bb97c52910864cf6be817df3fc59c250 1650w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_scheduler_state_en.png?w=2500\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=bdd9616fe723ef1e686c7a43589c54c8 2500w`}),`\n`,_jsxs(_components.p,{children:[`The cabinet and the `,_jsx(_components.a,{href:`/v4/web-api`,children:`Web API`}),` run this screening through the same code, so the result and its evidence are identical no matter where the campaign was launched from. A member can decide on do-not-call matches as well, since they run the whole campaign lifecycle — see `,_jsx(_components.a,{href:`/v4/platform/roles`,children:`Roles`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`campaign-contacts-2`,children:`Campaign contacts`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Campaign contacts`}),` table contains the contacts loaded into the campaign. Above it are `,_jsx(_components.strong,{children:`Search by number`}),`, `,_jsx(_components.strong,{children:`Search by contract`}),` and the total count.`]}),`\n`,_jsx(_components.p,{children:`Table columns:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Phone`}),` — the number as it was in the file;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name`}),`;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Contract`}),` and `,_jsx(_components.strong,{children:`Role`}),` — for contacts of a contract group;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Time zone`}),` — an empty zone is shown as “campaign time zone”;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`State`}),` — Waiting, Dialing, Awaiting evaluation, Done, Exhausted or Suppressed. Under the state of a waiting or suppressed contact the reason is shown — for example, “Outside working hours”, “Frequency cap reached”, “On the do-not-call list (DNC)”, “Contract group consent”, “Withdrawn at the client’s request” — and a waiting contact also shows “Retry no earlier than” with a date;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Attempts`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Clicking a row expands the `,_jsx(_components.strong,{children:`Contact variables`}),`.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_table_en.png?fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=2a6e892d36537e9366ac9f21df63a810`,alt:`Campaign contacts table`,\"data-og-width\":`2236`,width:`2236`,\"data-og-height\":`996`,height:`996`,\"data-path\":`images/v4_campaign_contacts_table_en.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_table_en.png?w=280\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=ff91b83768e901f53126a252f2311042 280w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_table_en.png?w=560\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=6066b630a3483105f298749bfa0642d1 560w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_table_en.png?w=840\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=0219de340c9514cd64dc357486fb9ed8 840w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_table_en.png?w=1100\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=f91fadf71a1b4aebfba8cb24de7d891b 1100w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_table_en.png?w=1650\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=f09b7adeca760ecd175207751aac3c30 1650w, https://mintcdn.com/hubtalk/IZGEohas4TbTpneh/images/v4_campaign_contacts_table_en.png?w=2500\u0026fit=max\u0026auto=format\u0026n=IZGEohas4TbTpneh\u0026q=85\u0026s=6b1b71620f94bf1f9d7b2af2551c1cd5 2500w`}),`\n`,_jsx(Heading,{level:`3`,id:`withdrawing-contacts-from-dialing`,children:`Withdrawing contacts from dialing`}),`\n`,_jsxs(_components.p,{children:[`Contacts are withdrawn from dialing at the client’s request only through the Web API: `,_jsx(_components.code,{children:`POST /v1/campaigns/{id}/contacts/withdraw`}),` — in one campaign, by numbers or contact IDs; `,_jsx(_components.code,{children:`POST /v1/contacts/withdraw`}),` — in every launched campaign of the organization, by numbers. A withdrawn contact moves to the Suppressed state with the reason “Withdrawn at the client’s request”. Details are in `,_jsx(_components.a,{href:`/v4/web-api/campaign-manage#withdrawing-a-contact-from-dialing`,children:`Withdrawing a contact from dialing`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Campaign contacts","description":"The contact file and its requirements, the import report, upload history, file retention, do-not-call screening and the contacts table.","href":"/v4/platform/campaigns/contacts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Campaign contacts","slug":"campaign-contacts","depth":1,"children":[]},{"title":"Contacts upload","slug":"contacts-upload","depth":2,"children":[]},{"title":"Contact file requirements","slug":"contact-file-requirements","depth":2,"children":[{"title":"Format and limits","slug":"format-and-limits","depth":3,"children":[]},{"title":"Phone number","slug":"phone-number","depth":3,"children":[]},{"title":"Name","slug":"name","depth":3,"children":[]},{"title":"Time zone","slug":"time-zone","depth":3,"children":[]},{"title":"Variables","slug":"variables","depth":3,"children":[]},{"title":"Contract groups","slug":"contract-groups","depth":3,"children":[]},{"title":"US campaigns","slug":"us-campaigns","depth":3,"children":[]},{"title":"Duplicate numbers","slug":"duplicate-numbers","depth":3,"children":[]}]},{"title":"Import results","slug":"import-results","depth":2,"children":[{"title":"Import report","slug":"import-report","depth":3,"children":[]}]},{"title":"Upload history","slug":"upload-history","depth":2,"children":[]},{"title":"Adding calls to a running campaign","slug":"adding-calls-to-a-running-campaign","depth":2,"children":[]},{"title":"File retention","slug":"file-retention","depth":2,"children":[]},{"title":"Do-not-call screening","slug":"do-not-call-screening","depth":2,"children":[]},{"title":"Campaign contacts","slug":"campaign-contacts-2","depth":2,"children":[{"title":"Withdrawing contacts from dialing","slug":"withdrawing-contacts-from-dialing","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"hubtalk","siteName":"HubTalk AI","title":"Campaign contacts - HubTalk AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/v4/platform/campaigns/contacts","matchLevel":0},"ru":{"href":"/ru/v4/platform/campaigns/contacts","matchLevel":1}}},"lastModified":"2026-11-05T08:02:51.631Z","originalFileLocation":"v4/platform/campaigns/contacts.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The contact file and its requirements, the import report, upload history, file retention, do-not-call screening and the contacts table.\">\u003cmeta data-mint-head name=\"application-name\" content=\"HubTalk AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hubtalk/wtXJq5k6uZ80We1W/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/hubtalk/wtXJq5k6uZ80We1W/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hubtalk/wtXJq5k6uZ80We1W/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/hubtalk/wtXJq5k6uZ80We1W/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/hubtalk/wtXJq5k6uZ80We1W/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hubtalk/wtXJq5k6uZ80We1W/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hubtalk/wtXJq5k6uZ80We1W/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/hubtalk/wtXJq5k6uZ80We1W/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/hubtalk/wtXJq5k6uZ80We1W/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Campaign contacts - HubTalk AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"The contact file and its requirements, the import report, upload history, file retention, do-not-call screening and the contacts table.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"HubTalk AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hubtalk.mintlify.site/_mintlify/api/og/v2?division=Campaigns\u0026amp;title=Campaign+contacts\u0026amp;description=The+contact+file+and+its+requirements%2C+the+import+report%2C+upload+history%2C+file+retention%2C+do-not-call+screening+and+the+contacts+table.\u0026amp;theme=d7501a5ae2e4574387448045\u0026amp;signature=e42db83adae9ba2a7c3daa5fab0134df1201a66a1f05a21209171ad508a4b4b9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Campaign contacts - HubTalk AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The contact file and its requirements, the import report, upload history, file retention, do-not-call screening and the contacts table.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hubtalk.mintlify.site/_mintlify/api/og/v2?division=Campaigns\u0026amp;title=Campaign+contacts\u0026amp;description=The+contact+file+and+its+requirements%2C+the+import+report%2C+upload+history%2C+file+retention%2C+do-not-call+screening+and+the+contacts+table.\u0026amp;theme=d7501a5ae2e4574387448045\u0026amp;signature=e42db83adae9ba2a7c3daa5fab0134df1201a66a1f05a21209171ad508a4b4b9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/hubtalk/wtXJq5k6uZ80We1W/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"HubTalk AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#440099\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v4/platform/campaigns/contacts.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.hubtalk.ai/ru/v4/platform/campaigns/contacts\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.hubtalk.ai/#organization\",\"name\":\"HubTalk AI\",\"url\":\"https://docs.hubtalk.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hubtalk/beMwuzhyHkgYeb3A/logo/new_logo.svg?fit=max\u0026auto=format\u0026n=beMwuzhyHkgYeb3A\u0026q=85\u0026s=fee415d6d73d48c227d61d8b9a2325f2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.hubtalk.ai#website\",\"name\":\"HubTalk AI\",\"url\":\"https://docs.hubtalk.ai\",\"publisher\":{\"@id\":\"https://docs.hubtalk.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts#webpage\",\"url\":\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts\",\"name\":\"Campaign contacts\",\"description\":\"The contact file and its requirements, the import report, upload history, file retention, do-not-call screening and the contacts table.\",\"dateModified\":\"2026-11-05T08:02:51.631Z\",\"isPartOf\":{\"@id\":\"https://docs.hubtalk.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Platform Guide\",\"item\":\"https://docs.hubtalk.ai/v4/platform/dashboard\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Campaigns\",\"item\":\"https://docs.hubtalk.ai/v4/platform/campaigns\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Campaign contacts\",\"item\":\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts#article\",\"headline\":\"Campaign contacts\",\"name\":\"Campaign contacts\",\"description\":\"The contact file and its requirements, the import report, upload history, file retention, do-not-call screening and the contacts table.\",\"url\":\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.hubtalk.ai/v4/platform/campaigns/contacts#webpage\"},\"dateModified\":\"2026-11-05T08:02:51.631Z\",\"publisher\":{\"@id\":\"https://docs.hubtalk.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.hubtalk.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"HubTalk AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"HubTalk AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/v4/platform/campaigns/contacts.md","siteName":"HubTalk AI","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Conversation Platform v4","icon":"book-open","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/v4/introduction"},{"title":"Getting Started","href":"/v4/getting-started"}]},{"group":"Platform Guide","pages":[{"title":"Dashboard","href":"/v4/platform/dashboard"},{"group":"Agents","root":{"title":"Agents","href":"/v4/platform/agents"},"pages":[{"title":"The agent list and access","href":"/v4/platform/agents/list"},{"group":"Flow nodes","root":{"title":"Flow nodes","href":"/v4/platform/agents/nodes"},"pages":[{"title":"Begin","href":"/v4/platform/agents/nodes/begin"},{"title":"Conversation","href":"/v4/platform/agents/nodes/conversation"},{"title":"Function","href":"/v4/platform/agents/nodes/function"},{"title":"Code","href":"/v4/platform/agents/nodes/code"},{"title":"Logic split","href":"/v4/platform/agents/nodes/logic-split"},{"title":"Extract variables","href":"/v4/platform/agents/nodes/extract-variables"},{"title":"Transfer","href":"/v4/platform/agents/nodes/transfer"},{"title":"Component","href":"/v4/platform/agents/nodes/component"},{"title":"Mcp tool","href":"/v4/platform/agents/nodes/mcp-tool"},{"title":"Override settings","href":"/v4/platform/agents/nodes/override-settings"},{"title":"End","href":"/v4/platform/agents/nodes/end"}]},{"title":"Working in the editor","href":"/v4/platform/agents/building"},{"title":"Testing an agent","href":"/v4/platform/agents/testing"}]},{"group":"Agent settings","root":{"title":"Agent settings","href":"/v4/platform/agent-settings"},"pages":[{"title":"Prompt, models and knowledge","href":"/v4/platform/agent-settings/prompt-and-models"},{"title":"Voice: STT, TTS and VAD","href":"/v4/platform/agent-settings/voice"},{"title":"Answering machine detection","href":"/v4/platform/agent-settings/voicemail-detection"},{"title":"Phrase corrections and pauses","href":"/v4/platform/agent-settings/speech-corrections"},{"title":"Recording and call control","href":"/v4/platform/agent-settings/call-control"},{"title":"Agent objectives","href":"/v4/platform/agent-settings/goals"},{"title":"Post-call analytics","href":"/v4/platform/agent-settings/analytics"},{"title":"Observers","href":"/v4/platform/agent-settings/observers"},{"title":"Webhooks","href":"/v4/platform/agent-settings/webhooks"}]},{"group":"Pre- and post-call functions","root":{"title":"Pre- and post-call functions","href":"/v4/platform/call-functions"},"pages":[{"title":"Pre-call functions","href":"/v4/platform/call-functions/before"},{"title":"Post-call functions","href":"/v4/platform/call-functions/after"},{"title":"Dial decisions in a campaign","href":"/v4/platform/call-functions/campaign-decision"},{"title":"The integration contract","href":"/v4/platform/call-functions/contract"},{"title":"History, limitations and troubleshooting","href":"/v4/platform/call-functions/diagnostics"}]},{"title":"Webhooks","href":"/v4/webhooks"},{"title":"Copilot","href":"/v4/platform/copilot"},{"title":"Telephony","href":"/v4/platform/telephony"},{"title":"Voicemail phrases","href":"/v4/platform/voicemail-phrases"},{"title":"Call screener phrases","href":"/v4/platform/screener-phrases"},{"group":"Campaigns","root":{"title":"Campaigns","description":"Manage outbound calling campaigns in HubTalk AI v4.","href":"/v4/platform/campaigns"},"pages":[{"title":"Campaign contacts","href":"/v4/platform/campaigns/contacts"},{"title":"Call frequency","description":"How often one number may be called: where the numbers come from, how to switch the limits off, and what the switch does not touch.","href":"/v4/platform/campaigns/frequency"},{"title":"US campaigns","href":"/v4/platform/campaigns/us-market"},{"title":"Campaign launch","href":"/v4/platform/campaign-launch"},{"title":"Adding calls","href":"/v4/platform/campaigns/call-additions"},{"title":"Do-not-call registry","href":"/v4/platform/campaigns/do-not-call"}]},{"group":"History \u0026 reports","root":{"title":"History \u0026 reports","href":"/v4/platform/campaign-history"},"pages":[{"group":"Call details","root":{"title":"Call details","href":"/v4/platform/campaign-history/call-details"},"pages":[{"title":"Transcript and events","href":"/v4/platform/campaign-history/call-details/transcript"},{"title":"Troubleshooting a call","href":"/v4/platform/campaign-history/call-details/troubleshooting"},{"title":"Call recording","href":"/v4/platform/campaign-history/call-details/recording"}]},{"title":"Reports: how to download","href":"/v4/platform/campaign-history/reports"},{"title":"A report for one campaign","href":"/v4/platform/campaign-history/campaign-report"},{"title":"Report columns","href":"/v4/platform/campaign-history/report-columns"},{"title":"Report template","href":"/v4/platform/campaign-history/report-templates"}]},{"title":"Incidents","href":"/v4/platform/incidents"},{"title":"Alerts","href":"/v4/platform/alerts"},{"title":"Demo links","href":"/v4/platform/demo-links"},{"title":"Organization","href":"/v4/platform/organization"},{"title":"Roles and access","href":"/v4/platform/roles"}]}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/v4/web-api"}]},{"tab":"v4 Tutorial","icon":"graduation-cap","pages":[{"title":"v4 Tutorial","href":"/v4/tutorial/overview"}]},{"tab":"v2 - v4 adapter","icon":"plug","pages":[{"title":"v2 - v4 adapter","href":"/v4/compat-adapter/overview"}]}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/v4/platform/campaigns/contacts"}]}]},"basePath":"","title":"Campaign contacts - HubTalk AI","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}