Download PDF
Download page Salesforce: Setting up approvals.
Salesforce: Setting up approvals
You can set up tracking and approvals workflows in Salesforce. A system administrator can enable and configure this feature of your Salesforce-Conga Collaborate integration.
Enable Chatter Approvals
Log into Salesforce, and then follow these steps to enable Chatter Approvals:
- Go to Setup
- In the Quick Find menu on the left, use the drop-down arrows to go to Build > Customize > Chatter > Chatter Settings
- Click Edit
- Check Allow Approvals
- Click SaveEnable Feed Tracking for Custom Objects
- Go to Setup
- In the Quick Find menu on the left, use the drop-down arrows to go to Build > Customize > Chatter > Feed Tracking
- Choose Conga Collaborate Document from the Object panel on the left. If you became a customer in 2015 or later, you should be using Conga Collaborate Documents. Contact Global Support if you’re unsure of which object to use.
- Check Enable Feed Tracking (there are default fields in the approval process already checked, if your approval depends on other fields, make sure those are checked)
- Click SaveCreate a Chatter Post Template
- Go to Setup
- In the Quick Find menu on the left, use the drop-down arrows to go to Build > Create > Workflow & Approvals > Post Templates
- Click New Template
- Select the object you want to post for approval. If you became a customer in 2015 or later, you should be using Conga Collaborate Documents. Contact Global Support if you’re unsure of which object to use.
- Click Next
- Give the Template a Name and, if you like, a description
- (Optional) Check Default if you want to use this Template for all related posts
- Select up to four fields you want to include on the Chatter post (an example preview can be seen by clicking the box to the right)
- Click SaveCreate an Approval Process
- Go to Setup
- In the Quick Find menu on the left, use the drop-down arrows to go to Build > Create > Workflow & Approvals > Approval Processes
- From the drop-down menu next to “Manage Approval Processes For”, select the Object for which you want to manage approvals. If you became a customer in 2015 or later, you should be using Conga Collaborate Documents. Contact Global Support if you’re unsure of which object to use.
- Click Create New Approval Process
- Select either Jump Start Wizard or Standard Setup Wizard. The Jump Start Wizard allows you to fill in basic information quickly.
- Under Approval Process Information, give the Approval Process a Name, and assign an Email and/or Post Template to be used for notifications
- Under Specify Entry Criteria, set the following criteria:
- Field: Conga Collaborate Document: Status
- Operator: equal
- Value: Pending ApprovalYou can use additional criteria, but Conga Collaborate depends on the Pending Approval status
- Under Select Approver, choose one of the following Conga Collaborate-supported options:
- Automatically assign an approver using a standard or custom hierarchy field
- Automatically assign to queue
- Automatically assign to approver(s)
- Click Save.
You can use additional criteria, but Conga Collaborate depends on the Pending Approval status. The Approver options supported by Conga Collaborate are the “Automatically assign” options. There is not a way to choose the approver through the Conga Collaborate interface at this time.
Further Configuration Options
The above sections get you going, but on the Approval Process edit page you can follow these steps to further configure your approval options:
- Click the Edit drop-down
- Enter Name and Description
- Specify Entry Criteria
- Select Approver Field and choose the desired Automated Approval Routing
- Record Editability Properties. You may want to allow the assign approver to edit records during the process.
- Choose Notifications Templates. Choose to notify approvers via email and/or chatter. Choosing a template enables this feature.
- Set Approval Page Layout. The Post Template (created in the previous section) is for Chatter only. This Page Layout is for the full Approval Page displayed when the Approver logs into Salesforce.com
- Select Initial Submitters (a good default Submitter is the Opportunity Owner that the Conga Collaborate Proposal is attached to)
Salesforce Outbound Messages
In order to send messages to Conga Collaborate when an Approve, Reject, or Recall action is performed, configure the actions in Salesforce. You do this in Outbound Messages.
Follow these steps to configure this feature:
- Go to Setup
- In the Quick Find menu on the left, use the drop-down arrows to go to Build > Create > Workflow & Approvals > Outbound Messages
- Click New Outbound Message
- Select the Object you want to use in the Approval Process
If you became a customer in 2015 or later, you should be using Conga Collaborate Documents. Contact Global Support if you’re unsure which object to use.
Approve Publish Outbound Message
- Enter a Name and optionally a Description
- Enter the Endpoint URL as client Conga Collaborate domain + /salesforce + /approve (e.g., https://example.Conga Collaborate.com/salesforce/approve)
- Select a Salesforce SysAdmin user to receive the messages to avoid permission-related issues. The only required field to send is tinderbox__TinderBoxId__c.
- Click Save
Reject Publish Outbound Message
- Click the Clone button on the Approval Outbound Message to create the Reject message
- Change all instances of Approve to Reject and select the same fields to send
- Click Save
Recall Publish Outbound Message
- Click the Clone button on the Reject Outbound Message to create the Recall message
- Change all instances of Reject to Recall and select the same fields to send
- Click Save
Assign Outbound Messages to Approval Process
- Go to Setup
- In the Quick Find menu on the left, use the drop-down arrows to go to Build > Create > Workflow & Approvals > Approval Processes
- Select the Approval Process you created earlier to assign actions to it. From this screen you can specify Initial Submission Actions, Approval Steps, and Final Approval, Final Rejection, and Recall Actions. You may include any actions of your own in any of the phases but the Conga Collaborate outbound messages must be assigned to the appropriate action.
- For each of the Final Approval, Final Rejection, and Recall Actions:
- Click Add Existing.
- Select Outbound Message as the search option.
- Select the appropriate message from the list.
Optional Email Approval
If you’re using an Email Notification, you can also enable email responses to be processed and APPROVE or REJECT the requested approval.
Steps in Conga Collaborate
Your last step is to adjust user permissions in Conga Collaborate.
Conga Collaborate administrator can follow these steps to adjust the user permissions:
- From the user drop-down in the upper-right corner, go to Administration > Roles and Permissions
- Select the role that contains your approvals users. Only custom permissions roles can be edited. If you haven’t created a custom role yet, select Create New Role in the upper-right corner
- Click Permissions
- Enter Publish into the search bar
- Disable the permission “Publish proposal”
- Enable the permission “Request approval to publish”
- Click Save