https://docs.yesware.com/assets/js/fcd71fc5.8c5e8237.js

1"use strict";(self.webpackChunkdocusaurus=self.webpackChunkdocusaurus||[]).push([["5301"],{4694:function(e,s,t){t.r(s),t.d(s,{frontMatter:()=>r,default:()=>h,toc:()=>l,metadata:()=>n,assets:()=>c,contentTitle:()=>i});var n=JSON.parse('{"id":"settings/salesforce/sync/index","title":"Salesforce Sync","description":"How to enable and configure Yesware\'s Salesforce Sync, what it logs, and how to manage it.","source":"@site/docs/settings/salesforce/sync/index.mdx","sourceDirName":"settings/salesforce/sync","slug":"/settings/salesforce/sync/","permalink":"/docs/settings/salesforce/sync/","draft":false,"unlisted":false,"tags":[],"version":"current","frontMatter":{"title":"Salesforce Sync","sidebar_label":"Sync","description":"How to enable and configure Yesware\'s Salesforce Sync, what it logs, and how to manage it."},"sidebar":"tutorialSidebar","previous":{"title":"Dashboards","permalink":"/docs/settings/salesforce/getting-started/using-yesware-data-to-build-salesforce-dashboards"},"next":{"title":"Summary Task Logging","permalink":"/docs/settings/salesforce/sync/how-do-i-leverage-summary-task-logging"}}'),a=t(5893),o=t(65);let r={title:"Salesforce Sync",sidebar_label:"Sync",description:"How to enable and configure Yesware's Salesforce Sync, what it logs, and how to manage it."},i=void 0,c={},l=[{value:"Enable Salesforce Sync",id:"enable-salesforce-sync",level:2},{value:"What Yesware logs",id:"what-yesware-logs",level:2},{value:"Where activity appears in Salesforce",id:"where-activity-appears-in-salesforce",level:2},{value:"Summary task logging",id:"summary-task-logging",level:2},{value:"Dynamic templates",id:"dynamic-templates",level:2},{value:"Common questions",id:"common-questions",level:2}];function d(e){let s={a:"a",admonition:"admonition",code:"code",h2:"h2",li:"li",ol:"ol",p:"p",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,o.a)(),...e.components},{Details:t}=s;return t||function(e,s){throw Error("Expected "+(s?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("Details",!0),(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(s.p,{children:"Salesforce Sync automatically logs your sent emails, replies, and recipient engagement events as completed tasks in Salesforce against the matching Contact, Lead, Account, or Opportunity."}),"\n",(0,a.jsx)(s.admonition,{type:"info",children:(0,a.jsxs)(s.p,{children:["Salesforce Sync is available on the ",(0,a.jsx)(s.strong,{children:"Enterprise plan"})," only."]})}),"\n",(0,a.jsx)(s.h2,{id:"enable-salesforce-sync",children:"Enable Salesforce Sync"}),"\n",(0,a.jsx)(s.p,{children:(0,a.jsx)(s.strong,{children:"Gmail"})}),"\n",(0,a.jsxs)(s.ol,{children:["\n",(0,a.jsxs)(s.li,{children:["Click the Yesware menu at the top of Gmail and select ",(0,a.jsx)(s.code,{children:"Preferences"}),"."]}),"\n",(0,a.jsxs)(s.li,{children:["Go to ",(0,a.jsx)(s.code,{children:"Integrations"})," and toggle Salesforce on."]}),"\n",(0,a.jsx)(s.li,{children:"Authenticate your Salesforce account when prompted."}),"\n",(0,a.jsxs)(s.li,{children:["Click ",(0,a.jsx)(s.code,{children:"Save & Reload"}),"."]}),"\n"]}),"\n",(0,a.jsxs)(s.p,{children:["Once enabled, all tracked emails and engagement events sync automatically. To disable sync for a single email, click the Salesforce cloud icon at the bottom of the compose window and toggle ",(0,a.jsx)(s.code,{children:"Send to Salesforce"})," off."]}),"\n",(0,a.jsxs)(s.p,{children:[(0,a.jsx)(s.strong,{children:"Outlook"}),"\nOpen the Yesware Sidebar from the ribbon and toggle ",(0,a.jsx)(s.code,{children:"Send to Salesforce"})," on in the sidebar settings."]}),"\n",(0,a.jsx)(s.h2,{id:"what-yesware-logs",children:"What Yesware logs"}),"\n",(0,a.jsx)(s.p,{children:"Yesware creates a completed Task in Salesforce for each of the following activity types:"}),"\n",(0,a.jsxs)(s.table,{children:[(0,a.jsx)(s.thead,{children:(0,a.jsxs)(s.tr,{children:[(0,a.jsx)(s.th,{children:"Activity"}),(0,a.jsx)(s.th,{children:"Task subject in Salesforce"})]})}),(0,a.jsxs)(s.tbody,{children:[(0,a.jsxs)(s.tr,{children:[(0,a.jsx)(s.td,{children:"Email sent"}),(0,a.jsx)(s.td,{children:"Message Sent: [subject]"})]}),(0,a.jsxs)(s.tr,{children:[(0,a.jsx)(s.td,{children:"Email opened"}),(0,a.jsx)(s.td,{children:"Message Opened: [subject]"})]}),(0,a.jsxs)(s.tr,{children:[(0,a.jsx)(s.td,{children:"Reply received"}),(0,a.jsx)(s.td,{children:"Reply: [subject]"})]}),(0,a.jsxs)(s.tr,{children:[(0,a.jsx)(s.td,{children:"Link clicked"}),(0,a.jsx)(s.td,{children:"Link Clicked in Message: [subject]"})]}),(0,a.jsxs)(s.tr,{children:[(0,a.jsx)(s.td,{children:"Attachment opened"}),(0,a.jsx)(s.td,{children:"Attachment Opened: [subject]"})]}),(0,a.jsxs)(s.tr,{children:[(0,a.jsx)(s.td,{children:"Presentation viewed"}),(0,a.jsx)(s.td,{children:"Presentation Viewed: [subject]"})]}),(0,a.jsxs)(s.tr,{children:[(0,a.jsx)(s.td,{children:"Bounce received"}),(0,a.jsx)(s.td,{children:"Bounce: [subject]"})]})]})]}),"\n",(0,a.jsxs)(s.p,{children:["Each task includes a ",(0,a.jsx)(s.strong,{children:'"Data provided by Yesware"'})," note in the Comments field. Yesware logs at most one task per event type per email. Duplicate events from the same device and location are not re-logged."]}),"\n",(0,a.jsx)(s.h2,{id:"where-activity-appears-in-salesforce",children:"Where activity appears in Salesforce"}),"\n",(0,a.jsxs)(s.ul,{children:["\n",(0,a.jsxs)(s.li,{children:[(0,a.jsx)(s.strong,{children:"Lead match"}),": Activity History of the Lead record."]}),"\n",(0,a.jsxs)(s.li,{children:[(0,a.jsx)(s.strong,{children:"Contact match"}),": Activity History of the Contact and the associated Account."]}),"\n",(0,a.jsxs)(s.li,{children:[(0,a.jsx)(s.strong,{children:"Contact Role on open Opportunity"}),": Activity History of the Contact, Account, and Opportunity."]}),"\n"]}),"\n",(0,a.jsx)(s.p,{children:"To associate email activity with an Opportunity, assign the recipient Contact as a Contact Role on that Opportunity in Salesforce. Yesware will then automatically sync activity to all three records."}),"\n",(0,a.jsx)(s.h2,{id:"summary-task-logging",children:"Summary task logging"}),"\n",(0,a.jsxs)(s.p,{children:["By default, Yesware creates separate tasks for each activity type. If you'd prefer a single consolidated task per email \u2014 with counts and timestamps for each event type \u2014 you can enable ",(0,a.jsx)(s.strong,{children:"Summary Task Logging"}),". This requires installing a Salesforce package and contacting Yesware support to activate it."]}),"\n",(0,a.jsxs)(s.p,{children:["See ",(0,a.jsx)(s.a,{href:"how-do-i-leverage-summary-task-logging",children:"Summary Task Logging"})," for setup steps."]}),"\n",(0,a.jsx)(s.h2,{id:"dynamic-templates",children:"Dynamic templates"}),"\n",(0,a.jsx)(s.p,{children:"On the Enterprise plan, you can personalise templates using live data from Salesforce Contact or Lead records. When you select a template, Yesware looks up the first recipient in the To field and auto-fills any dynamic fields with matching Salesforce data."}),"\n",(0,a.jsxs)(s.p,{children:["See ",(0,a.jsx)(s.a,{href:"how-do-dynamic-templates-work-with-salesforce",children:"Dynamic Templates"})," for setup and field reference."]}),"\n",(0,a.jsx)(s.h2,{id:"common-questions",children:"Common questions"}),"\n",(0,a.jsxs)(t,{children:[(0,a.jsx)("summary",{children:"What happens with duplicate records that share an email address?"}),(0,a.jsxs)(s.p,{children:["Yesware picks one record to sync to. It prefers Leads over Contacts, then Contacts with open Opportunities, then the record with the most recent activity, then the most recently modified re

1cord. If you use Gmail and are on the Enterprise plan, you can use the ",(0,a.jsx)(s.strong,{children:"Sync Selector"})," to manually choose which record to associate."]})]}),"\n",(0,a.jsxs)(t,{children:[(0,a.jsx)("summary",{children:"How does the Sync Selector work?"}),(0,a.jsx)(s.p,{children:"When composing in Gmail, click the Salesforce cloud icon at the bottom of the compose window. A panel shows any duplicate records \u2014 select the Contact or Lead you want to sync to. Yesware then syncs that email and all future events from that message to the record you chose."})]}),"\n",(0,a.jsxs)(t,{children:[(0,a.jsx)("summary",{children:"What is Background Sync?"}),(0,a.jsxs)(s.p,{children:["Background Sync lets Yesware log emails sent from any device or browser, including ones without the Yesware extension, as long as the recipient has a matching Salesforce record. Account managers can enable it under ",(0,a.jsx)(s.code,{children:"Global Policies"}),"."]})]}),"\n",(0,a.jsxs)(t,{children:[(0,a.jsx)("summary",{children:"Does Yesware support Salesforce Person Accounts?"}),(0,a.jsx)(s.p,{children:"Yes. Yesware syncs email activity to Person Accounts and you can create Tasks, Events, and logged calls against them. Viewing Person Accounts in the Salesforce Sidebar is supported, but editing from the Sidebar is not."})]}),"\n",(0,a.jsxs)(t,{children:[(0,a.jsx)("summary",{children:'How do tracked events show up as "Email" instead of "Call" in Salesforce?'}),(0,a.jsxs)(s.p,{children:["Yesware uses your Salesforce environment's default value for the Activity Type field. Ask your Salesforce administrator to change the default to ",(0,a.jsx)(s.code,{children:"Email"})," in Salesforce Setup under ",(0,a.jsx)(s.code,{children:"Customize"})," \u2192 ",(0,a.jsx)(s.code,{children:"Activities"})," \u2192 ",(0,a.jsx)(s.code,{children:"Task Fields"})," \u2192 ",(0,a.jsx)(s.code,{children:"Activity Type"}),', or create a workflow rule that sets Activity Type to "Email" for tasks created by Yesware.']})]}),"\n",(0,a.jsxs)(t,{children:[(0,a.jsx)("summary",{children:"How many Salesforce API calls does Yesware use?"}),(0,a.jsx)(s.p,{children:"Yesware uses API calls for Sidebar lookups and email sync actions \u2014 some activities trigger multiple calls. Your Salesforce administrator can monitor usage from within Salesforce and request a limit increase if needed."})]}),"\n",(0,a.jsxs)(t,{children:[(0,a.jsx)("summary",{children:"Why isn't Send to Salesforce working?"}),(0,a.jsxs)(s.p,{children:["Check that ",(0,a.jsx)(s.code,{children:"Send to Salesforce"})," is toggled on in your Yesware preferences. If it is on but emails still aren't syncing, deauthorize and reauthorize your Salesforce connection from the Yesware web app. If the issue continues, ask your Salesforce administrator to confirm your user profile has API access enabled. Note that Yesware does not sync emails sent to addresses on the same domain as your own, or to addresses with no matching Contact or Lead. See ",(0,a.jsx)(s.a,{href:"why-isn-t-send-to-salesforce-working",children:"Troubleshooting"})," for more detail."]})]})]})}function h(e={}){let{wrapper:s}={...(0,o.a)(),...e.components};return s?(0,a.jsx)(s,{...e,children:(0,a.jsx)(d,{...e})}):d(e)}},65:function(e,s,t){t.d(s,{Z:()=>i,a:()=>r});var n=t(7294);let a={},o=n.createContext(a);function r(e){let s=n.useContext(o);return n.useMemo(function(){return"function"==typeof e?e(s):{...s,...e}},[s,e])}function i(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:r(e.components),n.createElement(o.Provider,{value:s},e.children)}}}]);