Configuring Salesforce

Introduction

Frame uses the standard Salesforce oauth flow. From inside your Frame account, select the Salesforce connector, and follow the dialogs to log in as a user, then enter the instance URL.

Once your accounts are connected, a member of success engineering will review the mappings and make adjustments as needed to correct for misattributed authors and roles, connect chat-to-email workflows, import custom fields as tags, etc.

Once approved, Frame will replay your historical data into the UI and begin collecting new data as it arrives.

Salesforce loginSalesforce login

Salesforce login

Salesforce domainSalesforce domain

Salesforce domain

Permissions

Frame's integration is read-only and focuses on Case objects and their related EmailMessages, Tasks, CaseTag, CaseComment, and LiveChatTranscript objects. Emails and chats will be normalized as "messages" on a case and unified with messages from other connected sources.

In addition, Frame may be configured to import a user-requested list of custom fields from cases so that they may be applied as tags in Frame's analytics views. Tags can then be managed easily (renamed, merged, hidden, grouped, etc.) and applied to conversations in bulk (added, removed) or as they arrive with auto-tagging.

Frame uses targeted SOQL queries to access Salesforce data. We use extensive caching and request de-duplication to avoid making unnecessary API calls, and we request only what is needed to deliver our service.

If any of the types below are not applicable because they are either disabled or not compatible with your version of Salesforce, then they may be ignored when configuring the Frame integration user's access.

Objects

  • Account
    • Id
    • Name
    • PhotoUrl
    • SystemModstamp
    • Website
  • Case
    • CaseNumber
    • CreatedById
    • CreatedDate
    • Description
    • Id
    • Origin
    • OwnerId
    • Subject
    • SuppliedEmail
    • SuppliedName
    • SystemModstamp
    • SystemModstamp
  • CaseComment
    • CommentBody
    • CreatedById
    • CreatedDate
    • Id
    • IsPublished
    • SystemModstamp
  • CaseTag
    • TagDefinitionId
    • Name
    • Type
  • Contact
    • Email
    • Id
    • Name
    • PhotoUrl
    • SystemModstamp
  • EmailMessage
    • CreatedById
    • FromAddress
    • HtmlBody
    • Id
    • MessageDate
    • SystemModstamp
    • TextBody
  • EmailMessageRelation
    • EmailMessageId
    • Id
    • RelationAddress
    • RelationId
    • RelationObjectType
    • RelationType
    • SystemModstamp
  • Lead
    • Email
    • Id
    • Name
    • PhotoUrl
    • SystemModstamp
  • LiveChatTranscript
    • AccountId
    • Body
    • Browser
    • ContactID
    • CreatedById
    • Id
    • LeadID
    • Location
    • OwnerID
    • Platform
    • SupervisorTranscriptBody
    • SystemModstamp
  • LiveChatVisitor
    • Id
    • SystemModstamp
  • User
    • Alias
    • Email
    • FullPhotoUrl
    • Id
    • Name
    • SystemModstamp
  • Skill
    • Id
    • MasterLabel
  • TagDefinition
    • SystemModstamp
  • Task
    • CreatedById
    • CreatedDate
    • Description
    • Id
    • OwnerId
    • Subject
    • SystemModstamp
    • TaskSubtype
    • TaskWhoIds
    • WhoId

Relations

  • Case
    • Account
    • CaseComments
    • CaseTags
    • Contact
    • CreatedBy
    • EmailMessages
    • LiveChatTranscripts
    • Tasks
  • CaseTag
    • TagDefinition
  • Contact
    • Account
  • LiveChatTranscript
    • LiveChatVisitor
    • Skill