Salesforce: Using the Outgoing Data Tool
The Conga Collaborate Outgoing Data tool allows you to push information back into Salesforce. Outgoing Data rules can be triggered by system events and automatically make field updates on any editable field on your Salesforce launching object.
Outgoing Data removes manual steps by automatically updating fields on your Salesforce launching object. This allows you to reduces Salesforce management time and mitigate user error. For example, you might update the Opportunity Stage to Closed Won upon document acceptance.
Create an Outgoing Data Rule
Available objects for Outgoing Data
Outgoing Data can update fields on your launching object and the Octiv Document object. It cannot update fields on parents of your launching object or children of your launching object.
When selecting the Octiv Document object, look for its API name, tinderbox__Document__c.
Additionally, Conga Collaborate can use Outgoing Data to push back a PDF or Word file of a Conga Collaborate document to the standard Notes & Attachments list on a Salesforce record (described in the example below).
Example Use Cases
Update the Closed Date of an Opportunity when a document is accepted
A common use of Outgoing Data is to update the closed date of an Opportunity based upon document acceptance. Follow these steps to update the Closed Date of an Opportunity:
- Select Event: Accept.
- Select the appropriate Template.
- For Object, choose Opportunity.
- For Field, choose Close Date.
- For Value, select Proposal Field - Proposal: Closed At (DateTime).
- Click Add.
Attach the PDF or Word file of a Conga Collaborate document to a Salesforce record
If using the standard Notes & Attachments object, you can push the PDF or Word file of a Conga Collaborate document as an attachment to a record in Salesforce. Once the rule is triggered, the file will be added to the Notes & Attachments related list on the record.
This feature is not compatible with Salesforce Files.
In this example, we will push a document’s PDF to an Opportunity when the document is created:
- Select Event: Created.
- Select the appropriate Template.
- For Object, choose Attachment.
- For Field, choose Body.
- For Value, select Proposal Field - Proposal: PDF.
- Click Add.
Update the Status Field on the Document record when an email is sent
In some use cases, it is helpful to see in Salesforce when a user sends an email from the Collaborate Document. In this case, you can set the value of the document Status field in Salesforce to a value that indicates that an email was sent from the document.
- Select Event: Email Sent.
- Select the appropriate Template.
- For Object, choose tinderbox__Document__c.
- For Field, choose Status.
- For Value, enter Email Sent.
- Click Add.
Salesforce Data Types
Every field in Salesforce has an associated data type that defines the type of data that must live in that field. In order for Outgoing Data to work correctly, the data you are sending from Conga Collaborate must match the data type of the field in Salesforce. To assist with this, Conga Collaborate displays the data type of the field you are choosing to update when configuring Outgoing Data.
When you select a Salesforce field in Outgoing Data, Conga Collaborate displays all of the available pieces of information of that data type that can be sent back into Salesforce. Alternatively, you have the option to define a static value to be sent back to Salesforce.
For example, if you choose a Salesforce field that holds a double (a type of number field), Conga Collaborate does not have any pieces of dynamic document information stored as data type double, so your only option would be to record a static value to send back. If, however, you choose a Salesforce field that is of type string, then Conga Collaborate has multiple document fields that can be pushed back to Salesforce. You can define a static value in this scenario as well.
Below is a list of all dynamic Conga Collaborate document fields that can be sent back to Salesforce, along with their compatible data types:
Strings (compatible with any Salesforce fields that use strings)
- Proposal: ID
- Proposal: Public URL
- Proposal: Build URL
- Proposal: Name
- Proposal: Status
- Proposal: Template Name
- Proposal: Owner
- Proposal: Access Code
- DocuSign: Envelope Data URLDates (compatible with any Salesforce date fields)
- Proposal: Closed At (DateTime)
- Proposal: Published At (DateTime)
- Proposal: Expires At (Date)
- Proposal: Created At (Date)
- Proposal: Updated At (Date)Attachments (compatible with the Attachments object in Salesforce)
- Proposal: PDF
- Proposal: Word