{"id":66014,"date":"2026-04-28T09:34:30","date_gmt":"2026-04-28T09:34:30","guid":{"rendered":"https:\/\/www.sogolytics.com\/help\/?page_id=66014"},"modified":"2026-04-28T12:18:52","modified_gmt":"2026-04-28T12:18:52","slug":"build-activity-using-external-sources","status":"publish","type":"page","link":"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/","title":{"rendered":"Build Activity Using External Sources"},"content":{"rendered":"<p>Want to track important interactions related to your contacts? <strong>Activities<\/strong> allow you to store and manage transactional or event-based records associated with contacts in a Directory. Using Activities, you can track information such as purchases, service visits, support cases, or any other events connected to your contacts.<\/p>\n<div class=\"example-block-container blue-shade\">\n        <span class=\"example-block-content\"><span class=\"example-block-header\">For example:<\/span><br \/>\nA retail company maintains a <strong>Customer Directory<\/strong> containing customer contact details such as Name, Email Address, and Phone Number. The company wants to track customer purchases so they can later collect feedback about recent purchases.<\/p>\n<p>To achieve this, they create an Activity called <strong>Purchase History<\/strong> and import purchase records from an Excel file. Each record contains information such as Customer Email, Product Purchased, Purchase Date, Store Location, and Amount.<br \/>\n<\/span>\n  <\/div>\n<p class=\"sogo-help-sub-head\">Navigate to<\/p>\r\n<ul class=\"sogo-help-sub-list\">\r\n    <li><a href=\"#section-1\">Build Activity using Salesforce<\/a><\/li>\r\n    <li><a href=\"#section-2\">Build Activity using SFTP<\/a><\/li>\r\n<\/ul>\n<h2 id=\"section-1\">Build Activity Using Salesforce<\/h2>\n<p>To build an Activity using Salesforce as an external source, follow the steps below:<\/p>\n<ol>\n<li>Open the <strong>Directory<\/strong> where you want to create the Activity, and navigate to the <strong>Activities<\/strong> tab next to the <strong>All Contacts<\/strong> tab.<\/li>\n<li>Click <strong>+ Add Activities<\/strong>, enter a name for the Activity, and use <strong>+ Add Activity<\/strong> if you want to create additional Activities.<\/li>\n<div class=\"sogo-help-info-box\">\n<i class=\"fal fa-info-circle\"><\/i><\/p>\n<p class=\"sogo-info-text\">A maximum of 50 activities can be added per Directory.<\/p>\n<\/div>\n<li>Once you have added the required Activity name(s), click <strong>Save<\/strong>. The newly created Activities will appear under the <strong>Activities<\/strong> tab.<\/li>\n<p><img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/03\/Add-Activity.gif\" \/><\/p>\n<div class=\"example-block-container blue-shade\">\n        <span class=\"example-block-content\"><span class=\"example-block-header\">For example:<\/span><br \/>\nBased on the example above, you may name the Activity <strong>Purchase History<\/strong>.<br \/>\n<\/span>\n  <\/div>\n<li>Next, hover over the Activity into which you want to import records and select <strong>Import Records<\/strong>.<\/li>\n<p><img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/03\/Import_Records.png\" \/><\/p>\n<li>Select <strong>From External Sources<\/strong> and choose <strong>Salesforce<\/strong>. Then, select the appropriate <strong>Salesforce Account<\/strong> and choose the <strong>Salesforce Object<\/strong> you want to use as the data source.<\/li>\n<p><img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/04\/salesforce_source.png\" \/><\/p>\n<li>After selecting the source, use the <strong>Import just this one time<\/strong> toggle to define how the data should be imported:\n<ul>\n<li>Enable this option to perform a one-time import.<\/li>\n<li>Disable this option to establish a continuous connection with Salesforce, allowing data to be imported automatically based on a defined schedule.<\/li>\n<\/ul>\n<\/li>\n<li>If required, you can further refine the data by enabling <strong>Do you want to apply a filter on selected contacts?<\/strong> and defining the criteria in the side panel.<\/li>\n<li>Once the source and filters are configured, proceed to the <strong>Define Directory Lookup<\/strong> step to create a mapping rule that connects Activity records with contacts in the parent Directory.<\/li>\n<div class=\"example-block-container blue-shade\">\n        <span class=\"example-block-content\"><span class=\"example-block-header\">For example:<\/span><br \/>\nIn the Purchase History example, the <strong>Email Address<\/strong> from the Customer Directory can be mapped to the <strong>Customer Email<\/strong> field in the Activity to link each purchase record to the correct customer.<br \/>\n<\/span>\n  <\/div>\n<p>There are two types of Activity mapping:<\/p>\n<ol style=\"list-style: lower-alpha;\">\n<li><strong>Respondent Mapping:<\/strong> This is used when the survey respondents are contacts in the same Directory where the Activity exists. To configure Respondent Mapping, follow the steps below:\n<ul>\n<li>Select the <strong>Directory Field<\/strong> you want to use for the lookup.<\/li>\n<li>Map it to the corresponding <strong>Activity Field<\/strong>.<\/li>\n<\/ul>\n<li><strong>Feedback Recipient Mapping:<\/strong> This is used when the feedback recipient belongs to a different Directory, such as employees, vendors, or service providers. To configure Feedback Recipient Mapping, follow the steps below:\n<ul>\n<li>Toggle <strong>Create Feedback Recipient Mapping<\/strong>.<\/li>\n<li>Select the <strong>Directory<\/strong> from which the feedback recipients will be pulled.<\/li>\n<li>Choose the appropriate <strong>Directory Field<\/strong>.<\/li>\n<li>Ensure it matches the corresponding <strong>Activity Field<\/strong>.<\/li>\n<\/ul>\n<\/ol>\n<div class=\"example-block-container blue-shade\">\n        <span class=\"example-block-content\"><span class=\"example-block-header\">For example:<\/span><br \/>\nContinuing with the retail company example, the company may want to collect feedback about the <strong>salesperson<\/strong> who assisted the customer.<\/p>\n<p>In this case, the customer remains the respondent from the <strong>Customer Directory<\/strong>, while the salesperson belongs to a separate <strong>Salesperson Employee Directory<\/strong> (Feedback Recipient Directory).<\/p>\n<p>The Activity file may include a field such as <strong>Salesperson Email<\/strong> or <strong>Salesperson ID<\/strong>, which can be mapped to the corresponding field in the Salesperson Directory. This ensures feedback is sent to the correct salesperson.<br \/>\n<img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/03\/Create_Respondent.png\" \/><br \/>\n<\/span>\n  <\/div>\n<div class=\"sogo-help-info-box\">\n<i class=\"fal fa-info-circle\"><\/i><\/p>\n<div class=\"sogo-info-text\">\n<ul>\n<li>The Directory field used for respondent mapping must exactly match a field in the Activity.<\/li>\n<li>The Feedback Recipient Directory must be different from the Respondent Directory.<\/li>\n<li>Once mapping is created, it cannot be edited. To make changes, delete and recreate the Activity.<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<ol start=\"10\">\n<li>Click <strong>Continue<\/strong> to proceed to field mapping.<\/li>\n<li><strong>Map Fields:<\/strong> Define the field type for each imported field.<\/li>\n<\/ol>\n<div class=\"example-block-container blue-shade\">\n        <span class=\"example-block-content\"><span class=\"example-block-header\">For example:<\/span> In the Purchase History scenario, fields may include:<\/p>\n<ul>\n<li>Customer Email (Email)<\/li>\n<li>Product Purchased (String)<\/li>\n<li>Purchase Date (Date)<\/li>\n<li>Store Location (String)<\/li>\n<li>Amount (Number)<\/li>\n<\/ul>\n<p><\/span>\n  <\/div>\n<p>Available field types include:<\/p>\n<ul>\n<li><strong>String<\/strong> \u2013 Used for text-based information.<\/li>\n<li><strong>Email<\/strong> \u2013 Used for storing email addresses.<\/li>\n<li><strong>Number<\/strong> \u2013 Used for storing integer values.<\/li>\n<li><strong>Date<\/strong> \u2013 Used for saving dates in the following formats: MM\/DD\/YYYY, DD\/MM\/YYYY, YYYY-MM-DD.<\/li>\n<li><strong>Time<\/strong> \u2013 Used for saving time as hh:mm or hh:mm:ss.<\/li>\n<li><strong>Date-Time<\/strong> \u2013 Used for saving date and time in the following formats: MM\/DD\/YYYY hh:mm, DD\/MM\/YYYY hh:mm, YYYY\/MM\/DD hh:mm, MM\/DD\/YYYY hh:mm:ss, DD\/MM\/YYYY hh:mm:ss, YYYY\/MM\/DD hh:mm:ss <\/li>\n<li><strong>Boolean<\/strong> \u2013 Used for saving Boolean values such as 1|0, Yes|No, Y|N, True|False. These values are normalized to True and False after importing.<\/li>\n<li><strong>Phone<\/strong> \u2013 Used for saving phone numbers. You can specify the country code by clicking the <strong>gear icon<\/strong> next to the Field Type column.<\/li>\n<li><strong>URL<\/strong> \u2013 Used for saving URLs.<\/li>\n<\/ul>\n<\/ul>\n<p><img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/04\/Mapfields_SF.png\"><\/p>\n<div class=\"sogo-help-info-box\">\n<i class=\"fal fa-info-circle\"><\/i><\/p>\n<div class=\"sogo-info-text\">\nThe system may automatically detect some field types. Unrecognized fields can be imported as <strong>Custom Fields<\/strong> and assigned the appropriate field type.\n<\/div>\n<\/div>\n<ol start=\"12\">\n<li>Click <strong>Continue<\/strong> after completing field mapping.<\/li>\n<li>If <strong>Import just this one time<\/strong> is enabled, valid records will be processed immediately and the activity will be created. Otherwise, you will be redirected to the <strong>Automation Rules<\/strong> wizard.<\/li>\n<li>In the <strong>Automation Rules<\/strong> wizard, define when and how records should be imported by selecting a schedule: <strong>Daily<\/strong>, <strong>Weekly<\/strong>, <strong>Monthly<\/strong>, <strong>Custom<\/strong>, or <strong>System Defined (Hourly)<\/strong>.<\/li>\n<\/ol>\n<p>If the rule is set on <strong>Thursday, 1 January 2026<\/strong>, the schedule will run as follows:<\/p>\n<ol style=\"list-style: lower-alpha;\">\n<li><strong>Daily:<\/strong> Runs every day at 10:00 AM starting from 1 January 2026.<\/li>\n<li><strong>Weekly:<\/strong> Runs on the selected day of the week (e.g., Monday) at 10:00 AM. The first run will occur on the next matching day:\n<ul>\n<li>5 Jan 2026 (Monday) \u2013 10:00 AM<\/li>\n<li>12 Jan 2026 (Monday) \u2013 10:00 AM<\/li>\n<\/ul>\n<\/li>\n<li><strong>Monthly:<\/strong> If the rule is configured to run on the <strong>1st of every month<\/strong> at 10:00 AM, it will execute as follows:\n<ul>\n<li>1 Jan 2026 \u2013 10:00 AM<\/li>\n<li>1 Feb 2026 \u2013 10:00 AM<\/li>\n<\/ul>\n<\/li>\n<li><strong>Custom:<\/strong>\n<ul>\n<li><strong>Every 2 days:<\/strong> 1 Jan, 3 Jan, 5 Jan\u2026<\/li>\n<li><strong>Every 2 weeks:<\/strong> 1 Jan, 15 Jan, 29 Jan\u2026<\/li>\n<li><strong>Every 3 months:<\/strong> 1 Jan, 1 Apr, 1 Jul\u2026<\/li>\n<\/ul>\n<\/li>\n<li><strong>System Defined:<\/strong> Runs every hour automatically.<\/li>\n<\/ol>\n<ol start=\"15\">\n<li>Define the <strong>Start Date<\/strong> and <strong>End Date<\/strong> for the automation rule.<\/li>\n<\/ol>\n<div class=\"sogo-help-info-box\">\n<i class=\"fal fa-info-circle\"><\/i><\/p>\n<p class=\"sogo-info-text\">\nDuring initial Directory creation, Upsert and Update options are unavailable. These can be enabled later once Contacts are added.\n<\/p>\n<\/div>\n<ol start=\"16\">\n<li>Enable <strong>Email Alerts<\/strong> to receive notifications for success, failure, or exceptions.<\/li>\n<li>Finally, click <strong>Save Automation Rule<\/strong>, provide a name, and click <strong>Done<\/strong>.<\/li>\n<li>Your automation rule is now set up and your Activity will be created within a few minutes.<\/li>\n<\/ol>\n<p>&nbsp;<\/p>\n<h2 id=\"section-2\">Build Activity Using SFTP<\/h2>\n<p>To build an Activity using SFTP as an external source, follow the steps below:<\/p>\n<div class=\"sogo-help-info-box\">\n  <i class=\"fal fa-info-circle\"><\/i><\/p>\n<p class=\"sogo-info-text\">\n    Before using SFTP as an external source, ensure that it is set up in your account. To learn more, refer to <a href=\"https:\/\/www.sogolytics.com\/help\/how-to-connect-to-sftp-server\/\" target=\"_blank\" rel=\"noopener\">Sogolytics SFTP Server Setup<\/a>.\n  <\/p>\n<\/div>\n<ol>\n<li>Open the <strong>Directory<\/strong> where you want to create the Activity, and navigate to the <strong>Activities<\/strong> tab.<\/li>\n<li>Click <strong>+ Add Activities<\/strong>, enter a name for the Activity, and use <strong>+ Add Activity<\/strong> to create additional Activities if needed.<\/li>\n<div class=\"sogo-help-info-box\">\n<i class=\"fal fa-info-circle\"><\/i><\/p>\n<p class=\"sogo-info-text\">A maximum of 50 activities can be added per Directory.<\/p>\n<\/div>\n<li>Click <strong>Save<\/strong>. The newly created Activities will appear under the <strong>Activities<\/strong> tab.<\/li>\n<p><img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/03\/Add-Activity.gif\" \/><\/p>\n<div class=\"example-block-container blue-shade\">\n        <span class=\"example-block-content\"><span class=\"example-block-header\">For example:<\/span><br \/>\nYou may name the Activity <strong>Purchase History<\/strong>.<br \/>\n<\/span>\n  <\/div>\n<li>Hover over the Activity and click <strong>Import Records<\/strong>.<\/li>\n<p><img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/03\/Import_Records.png\" \/><\/p>\n<li>Select <strong>From External Sources<\/strong> and choose <strong>SFTP<\/strong>.<\/li>\n<li>Select the folder from which you want to import data. All available folders will be listed. Click the <strong>Refresh<\/strong> icon to fetch newly created folders.<\/li>\n<li>After selecting the folder, choose a file to use as a sample for mapping and click <strong>Continue<\/strong>.<\/li>\n<p><img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/04\/SFTP_source.png\" \/><\/p>\n<div class=\"sogo-help-info-box\">\n<i class=\"fal fa-info-circle\"><\/i><\/p>\n<div class=\"sogo-info-text\">\n<ul>\n<li>Imports from SFTP are dynamic and follow the defined automation rules.<\/li>\n<li>The sample file must match the format of the actual files used for import.<\/li>\n<li>The selected file is used only for mapping; no records are imported at this stage.<\/li>\n<li>Any mismatch in file structure may cause import failures.<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<li>Next, in the <strong>Define Directory Lookup<\/strong> step, create a mapping rule to connect Activity records with contacts in the parent Directory.<\/li>\n<div class=\"example-block-container blue-shade\">\n        <span class=\"example-block-content\"><span class=\"example-block-header\">For example:<\/span> In the Purchase History example, the <strong>Email Address<\/strong> from the Customer Directory can be mapped to the <strong>Customer Email<\/strong> field in the Activity to link each purchase record to the correct customer.<\/span>\n  <\/div>\n<p>There are two types of Activity mapping:<\/p>\n<ol style=\"list-style: lower-alpha;\">\n<li><strong>Respondent Mapping:<\/strong> This is used when the survey respondents are contacts in the same Directory where the Activity exists. To configure Respondent Mapping, follow the steps below:\n<ul>\n<li>Select the <strong>Directory Field<\/strong> you want to use for the lookup.<\/li>\n<li>Map it to the corresponding <strong>Activity Field<\/strong>.<\/li>\n<\/ul>\n<li><strong>Feedback Recipient Mapping:<\/strong> This is used when the feedback recipient belongs to a different Directory, such as employees, vendors, or service providers. To configure Feedback Recipient Mapping, follow the steps below:\n<ul>\n<li>Toggle <strong>Create Feedback Recipient Mapping<\/strong>.<\/li>\n<li>Select the <strong>Directory<\/strong> from which the feedback recipients will be pulled.<\/li>\n<li>Choose the appropriate <strong>Directory Field<\/strong>.<\/li>\n<li>Ensure it matches the corresponding <strong>Activity Field<\/strong>.<\/li>\n<\/ul>\n<\/ol>\n<div class=\"example-block-container blue-shade\">\n        <span class=\"example-block-content\"><span class=\"example-block-header\">For example:<\/span><br \/>\nContinuing with the retail company example, the company may want to collect feedback about the <strong>salesperson<\/strong> who assisted the customer.<\/p>\n<p>In this case, the customer remains the respondent from the <strong>Customer Directory<\/strong>, while the salesperson belongs to a separate <strong>Salesperson Employee Directory<\/strong> (Feedback Recipient Directory).<\/p>\n<p>The Activity file may include a field such as <strong>Salesperson Email<\/strong> or <strong>Salesperson ID<\/strong>, which can be mapped to the corresponding field in the Salesperson Directory. This ensures feedback is sent to the correct salesperson.<br \/>\n<img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/03\/Create_Respondent.png\" \/><br \/>\n<\/span>\n  <\/div>\n<div class=\"sogo-help-info-box\">\n<i class=\"fal fa-info-circle\"><\/i><\/p>\n<div class=\"sogo-info-text\">\n<ul>\n<li>The mapping field must match exactly between Directory and Activity.<\/li>\n<li>The Feedback Recipient Directory must be different from the Respondent Directory.<\/li>\n<li>Mappings cannot be edited after creation.<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<ol start=\"10\">\n<li>Click <strong>Continue<\/strong> to proceed to field mapping.<\/li>\n<li><strong>Map Fields:<\/strong> Assign the appropriate field type for each imported field.<\/li>\n<\/ol>\n<div class=\"example-block-container blue-shade\">\n        <span class=\"example-block-content\"><span class=\"example-block-header\">For example:<\/span><br \/>\nCustomer Email (Email), Product (String), Purchase Date (Date), Amount (Number)<br \/>\n<\/span>\n  <\/div>\n<p>Available field types include:<\/p>\n<ul>\n<li><strong>String<\/strong> \u2013 Used for text-based information.<\/li>\n<li><strong>Email<\/strong> \u2013 Used for storing email addresses.<\/li>\n<li><strong>Number<\/strong> \u2013 Used for storing integer values.<\/li>\n<li><strong>Date<\/strong> \u2013 Used for saving dates in the following formats: MM\/DD\/YYYY, DD\/MM\/YYYY, YYYY-MM-DD.<\/li>\n<li><strong>Time<\/strong> \u2013 Used for saving time as hh:mm or hh:mm:ss.<\/li>\n<li><strong>Date-Time<\/strong> \u2013 Used for saving date and time in the following formats: MM\/DD\/YYYY hh:mm, DD\/MM\/YYYY hh:mm, YYYY\/MM\/DD hh:mm, MM\/DD\/YYYY hh:mm:ss, DD\/MM\/YYYY hh:mm:ss, YYYY\/MM\/DD hh:mm:ss <\/li>\n<li><strong>Boolean<\/strong> \u2013 Used for saving Boolean values such as 1|0, Yes|No, Y|N, True|False. These values are normalized to True and False after importing.<\/li>\n<li><strong>Phone<\/strong> \u2013 Used for saving phone numbers. You can specify the country code by clicking the <strong>gear icon<\/strong> next to the Field Type column.<\/li>\n<li><strong>URL<\/strong> \u2013 Used for saving URLs.<\/li>\n<\/ul>\n<\/ul>\n<p><img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/04\/SFTP_mapF.png\"><\/p>\n<div class=\"sogo-help-info-box\">\n<i class=\"fal fa-info-circle\"><\/i><\/p>\n<div class=\"sogo-info-text\">\nThe system may automatically detect some field types. Unrecognized fields can be imported as <strong>Custom Fields<\/strong>.\n<\/div>\n<\/div>\n<ol start=\"12\">\n<li>Click <strong>Continue<\/strong> to proceed to the <strong>Automation Rules<\/strong> wizard.<\/li>\n<p><img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2026\/04\/AR_SFTP.png\"><\/p>\n<li>In the <strong>File Selection<\/strong> step, choose how files should be processed:\n<ul>\n<li><strong>All files<\/strong><\/li>\n<li><strong>New files only<\/strong><\/li>\n<li><strong>Files uploaded on selected days<\/strong><\/li>\n<\/ul>\n<p>  Enable <strong>Never use the same file again<\/strong> to avoid duplicate imports.\n<\/li>\n<li>Define the schedule for importing contacts: <strong>Daily<\/strong>, <strong>Weekly<\/strong>, <strong>Monthly<\/strong>, <strong>Custom<\/strong>, or <strong>Hourly<\/strong>.<\/li>\n<\/ol>\n<p>If the rule is set on <strong>Thursday, 1 January 2026<\/strong>, the schedule will run as follows:<\/p>\n<ol style=\"list-style: lower-alpha;\">\n<li><strong>Daily:<\/strong> Runs every day at 10:00 AM starting from 1 January 2026.<\/li>\n<li><strong>Weekly:<\/strong> Runs on the selected day of the week (e.g., Monday) at 10:00 AM. The first run will occur on the next matching day:\n<ul>\n<li>5 Jan 2026 (Monday) \u2013 10:00 AM<\/li>\n<li>12 Jan 2026 (Monday) \u2013 10:00 AM<\/li>\n<\/ul>\n<\/li>\n<li><strong>Monthly:<\/strong> If the rule is configured to run on the <strong>1st of every month<\/strong> at 10:00 AM, it will execute as follows:\n<ul>\n<li>1 Jan 2026 \u2013 10:00 AM<\/li>\n<li>1 Feb 2026 \u2013 10:00 AM<\/li>\n<\/ul>\n<\/li>\n<li><strong>Custom:<\/strong>\n<ul>\n<li><strong>Every 2 days:<\/strong> 1 Jan, 3 Jan, 5 Jan\u2026<\/li>\n<li><strong>Every 2 weeks:<\/strong> 1 Jan, 15 Jan, 29 Jan\u2026<\/li>\n<li><strong>Every 3 months:<\/strong> 1 Jan, 1 Apr, 1 Jul\u2026<\/li>\n<\/ul>\n<\/li>\n<li><strong>Instantly:<\/strong> The system automatically checks the SFTP server every 15 minutes for new or updated files and updates Activity contacts accordingly.<\/li>\n<\/li>\n<\/ol>\n<ol start=\"15\">\n<li>Define the <strong>Start Date<\/strong> and <strong>End Date<\/strong>.<\/li>\n<li>Enable <strong>Email Alerts<\/strong> on your registered email ID to stay informed about any of the following events:\n<ul>\n<li>Send alert email to confirm successful rule execution.<\/li>\n<li>Send alert email if automation fails.<\/li>\n<li>If exceptions are found when UIDs in the file are checked, send an email with a file of exceptions.<\/li>\n<li>If exceptions are found, do not send, and disable further automation.<\/li>\n<\/ul>\n<p>You can also choose to send alerts to alternate email addresses by enabling the <strong>Would you like to send alerts to any alternate email addresses?<\/strong> toggle.<\/li>\n<li>Once you have set up the automation rule, click on <strong>Save Automation Rule<\/strong>. In the modal that appears, enter the desired name for the automation rule. You can also enable <strong>Initial Sync<\/strong> to import records from all relevant files defined in the automation rule as soon as the rule is saved. This is a one-time process; all future updates will follow the configured automation schedule. <img decoding=\"async\" src=\"\/help\/wp-content\/uploads\/2025\/03\/Directory21.png\" \/>\n<div class=\"sogo-help-info-box\"><i class=\"fal fa-info-circle\"><\/i><\/p>\n<p class=\"sogo-info-text\"><strong>Initial Sync<\/strong> is a one-time sync. Moving forward, the data sync will occur as per the automation rule.<\/p>\n<\/div>\n<\/li>\n<li>Your automation rule is now set up and your Activity will be created within a few minutes.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>Want to track important interactions related to your contacts? Activities allow you to store and manage transactional or event-based records associated with contacts in a Directory. Using Activities, you can track information such as purchases, service visits, support cases, or any other events connected to your contacts. Build Activity Using Salesforce To build an Activity using Salesforce as an external source, follow the steps below: Open the Directory where you want to create the Activity, and navigate to the Activities tab next to the All Contacts tab. Click + Add Activities, enter a name for the Activity, and use + Add Activity if you want to create additional Activities. A maximum of 50 activities can be added per Directory. Once you have added the required Activity name(s), click Save. The newly created Activities will appear under the Activities tab. Next, hover over the Activity into which you want to import records and select Import Records. Select From External Sources and choose Salesforce. Then, select the appropriate Salesforce Account and choose the Salesforce Object you want to use as the data source. After selecting the source, use the Import just this one time toggle to define how the data should be imported: Enable this option to perform a one-time import. Disable this option to establish a continuous connection with Salesforce, allowing data to be imported automatically based on a defined schedule. If required, you can further refine the data by enabling Do you want to apply a filter on selected contacts? [&hellip;]<\/p>\n","protected":false},"author":30,"featured_media":0,"parent":0,"menu_order":62,"comment_status":"closed","ping_status":"closed","template":"sogo_new_design.php","meta":{"footnotes":""},"categories":[456],"tags":[485,486,487,463],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v19.7.2 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Build Activity Using External Sources | Sogolytics<\/title>\n<meta name=\"description\" content=\"Want to track important interactions related to your contacts? Activities allow you to store and manage transactional or event-based records associated with contacts in a Directory. Using Activities, you can track information such as purchases, service visits, support cases, or any other events connected to your contacts.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Build Activity Using External Sources | Sogolytics\" \/>\n<meta property=\"og:description\" content=\"Want to track important interactions related to your contacts? Activities allow you to store and manage transactional or event-based records associated with contacts in a Directory. Using Activities, you can track information such as purchases, service visits, support cases, or any other events connected to your contacts.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/\" \/>\n<meta property=\"og:site_name\" content=\"Sogolytics\" \/>\n<meta property=\"article:modified_time\" content=\"2026-04-28T12:18:52+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/\",\"url\":\"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/\",\"name\":\"Build Activity Using External Sources | Sogolytics\",\"isPartOf\":{\"@id\":\"https:\/\/www.sogolytics.com\/help\/#website\"},\"datePublished\":\"2026-04-28T09:34:30+00:00\",\"dateModified\":\"2026-04-28T12:18:52+00:00\",\"description\":\"Want to track important interactions related to your contacts? Activities allow you to store and manage transactional or event-based records associated with contacts in a Directory. Using Activities, you can track information such as purchases, service visits, support cases, or any other events connected to your contacts.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.sogolytics.com\/help\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Build Activity Using External Sources\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.sogolytics.com\/help\/#website\",\"url\":\"https:\/\/www.sogolytics.com\/help\/\",\"name\":\"Sogolytics\",\"description\":\"Sogolytics - Online Survey Tool\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.sogolytics.com\/help\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Build Activity Using External Sources | Sogolytics","description":"Want to track important interactions related to your contacts? Activities allow you to store and manage transactional or event-based records associated with contacts in a Directory. Using Activities, you can track information such as purchases, service visits, support cases, or any other events connected to your contacts.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/","og_locale":"en_US","og_type":"article","og_title":"Build Activity Using External Sources | Sogolytics","og_description":"Want to track important interactions related to your contacts? Activities allow you to store and manage transactional or event-based records associated with contacts in a Directory. Using Activities, you can track information such as purchases, service visits, support cases, or any other events connected to your contacts.","og_url":"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/","og_site_name":"Sogolytics","article_modified_time":"2026-04-28T12:18:52+00:00","twitter_card":"summary","twitter_misc":{"Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/","url":"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/","name":"Build Activity Using External Sources | Sogolytics","isPartOf":{"@id":"https:\/\/www.sogolytics.com\/help\/#website"},"datePublished":"2026-04-28T09:34:30+00:00","dateModified":"2026-04-28T12:18:52+00:00","description":"Want to track important interactions related to your contacts? Activities allow you to store and manage transactional or event-based records associated with contacts in a Directory. Using Activities, you can track information such as purchases, service visits, support cases, or any other events connected to your contacts.","breadcrumb":{"@id":"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.sogolytics.com\/help\/build-activity-using-external-sources\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.sogolytics.com\/help\/"},{"@type":"ListItem","position":2,"name":"Build Activity Using External Sources"}]},{"@type":"WebSite","@id":"https:\/\/www.sogolytics.com\/help\/#website","url":"https:\/\/www.sogolytics.com\/help\/","name":"Sogolytics","description":"Sogolytics - Online Survey Tool","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.sogolytics.com\/help\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"}]}},"seo_meta_info":{"yoast_noindex":"","rankmath_noindex":"","yoast_title":"Build Activity Using External Sources | Sogolytics","yoast_desc":"Want to track important interactions related to your contacts? Activities allow you to store and manage transactional or event-based records associated with contacts in a Directory. Using Activities, you can track information such as purchases, service visits, support cases, or any other events connected to your contacts.","rankmath_title":"Build Activity Using External Sources","rankmath_desc":"Want to track important interactions related to your contacts? Activities allow you to store and manage transactional or event-based records associated with contacts in a&hellip;"},"_links":{"self":[{"href":"https:\/\/www.sogolytics.com\/help\/wp-json\/wp\/v2\/pages\/66014"}],"collection":[{"href":"https:\/\/www.sogolytics.com\/help\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.sogolytics.com\/help\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.sogolytics.com\/help\/wp-json\/wp\/v2\/users\/30"}],"replies":[{"embeddable":true,"href":"https:\/\/www.sogolytics.com\/help\/wp-json\/wp\/v2\/comments?post=66014"}],"version-history":[{"count":23,"href":"https:\/\/www.sogolytics.com\/help\/wp-json\/wp\/v2\/pages\/66014\/revisions"}],"predecessor-version":[{"id":66358,"href":"https:\/\/www.sogolytics.com\/help\/wp-json\/wp\/v2\/pages\/66014\/revisions\/66358"}],"wp:attachment":[{"href":"https:\/\/www.sogolytics.com\/help\/wp-json\/wp\/v2\/media?parent=66014"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.sogolytics.com\/help\/wp-json\/wp\/v2\/categories?post=66014"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.sogolytics.com\/help\/wp-json\/wp\/v2\/tags?post=66014"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}