Skip to main content
Conga Support

Create a Workflow Rule for Conga Workflow

Create a workflow rule for Conga Workflow:

  1. Navigate to Setup > Create > Workflow & Approvals > Workflow Rules.
  2. Click New Rule.
  3. Complete the steps using the information below:
    1. The Object selected must be the same as the Master Object from your Conga Composer solution (the same object on which you created the Conga Workflow formula field).

    2. We recommend setting the Rule Name to “Conga Workflow [Name of Composer solution] [Output Mode]” (e.g. “Conga Workflow Invoice Email).

    3. We recommend setting the Evaluation Criteria to created, and any time it’s edited to subsequently meet criteria. However, you may select another option depending on your requirements.  See the Warning below for further details.

    4. You may create a new field (for example, a checkbox called Conga Workflow Trigger) or leverage an existing field (such as Opportunity Stage) in the criteria of your workflow rule.

In the example above, the Salesforce workflow rule runs when the Opportunity Stage field is changed to “Closed Won,” which then initiates Conga Workflow.  Conga Workflow creates an invoice document, attaches it to an email, and sends that email to the Opportunity’s Primary Contact.

The ability to merge and send a document without user oversight or intervention potentially poses a great risk.  Remember that every time the Salesforce workflow rule fires, the Conga Workflow process runs as well, meaning the merged output file will be generated, which can have far-reaching implications, such as an infinite loop.

 

For example, assume your Salesforce workflow rule is set to evaluate every time a record is edited and you’re using a checkbox field as the rule criteria (e.g. “Conga Workflow Trigger equals true”).  If you don’t include an additional field update workflow action to disable the checkbox field after Conga Workflow fires, then a document will be generated every time the record is edited.

 

Please thoroughly test your solution and confirm it’s working correctly before deploying it fully.

Add an Outbound Message workflow action to the Salesforce workflow rule.

  1. We recommend setting the Name of the outbound message as “Conga Workflow [Name of Composer solution] [Output Mode]” (e.g. “Conga Workflow Invoice Email). Optionally, include a Description as well.
  2. Endpoint URL is: https://workflow.congamerge.com/OBMListener.ashx
  3. User to Send As is the user under whose authority Conga Workflow will run.  Typically, this is a System Administrator.  Ensure that this user is active and has access to all of the components used in the Conga Workflow solution (e.g. reports, queries, objects, fields, email privileges, eSignature privileges) as well as access to the Conga Workflow formula field.
  4. Send Session ID must be enabled.
  5. Selected Fields must include the Master Object ID (Id) and the Conga Workflow formula field.
  1. Activate the Salesforce workflow rule by clicking Activate

    The Active checkbox enables and the Activate button changes to Deactivate.

Test the Conga Workflow solution.