Perform the following steps to create a workflow rule for Conga Trigger:

  1. Navigate to Setup → Process Automation → 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 CQG solution (the same object on which you created the Conga Trigger formula field).
    2. We recommend setting the Rule Name to “Conga Trigger [Name of CQG solution] [Output Mode]” (ex: “Conga Trigger Quotation Email").
    3. We recommend setting the Evaluation Criteria to created, and any time it’s edited to subsequently meet the criteria. However, you may select another option depending on your requirements. See the warning below for more details.
    4. You may create a new field (for example, a checkbox named Conga Trigger) or leverage an existing field (such as Quote Status) in the criteria of your Conga Trigger rule.
  4. Click Save & Next.

In the example above, the Salesforce workflow rule runs when the Quote Status field is changed to “Accepted", which then initiates Conga Trigger. Conga Trigger creates an invoice document, attaches it to an email, and sends that email to the 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 Trigger 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 Trigger equals true”). If you don’t include an additional field update workflow action to disable the checkbox field after Conga Trigger fires, then a document will be generated every time the record is edited.

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

To add an Outbound Message workflow action to the Salesforce workflow rule

  1. Open a workflow rule.
  2. In the Immediate Workflow Actions section, click Add Workflow Action.
  3. Selec New Outbound Message option.
  4. Add an Outbound Message workflow action to the Salesforce Workflow Rule.
    1. We recommend setting the Name of the outbound message as “Conga Trigger [Name of Composer solution] [Output Mode]” (ex: “Conga Trigger Quotation Email). Optionally, include a description as well.
    2. Add the following Endpoint URL: https://workflow.congamerge.com/OBMListener.ashx

      The Endpoint URL is different for integrating Conga Trigger with the Conga Invoice Generation solution. The Conga Trigger Endpoint URL for Conga Invoice Generation is https://workflow.congamerge.com/sfb/obmlistener.ashx

    3. User to send as is the user under whose authority Conga Trigger will run. The User to send as should have a custom or standard System Administrator profile and a CQG license. Ensure that this user is active and has access to all of the components used in the Conga Trigger solution (ex: reports, queries, objects, fields, email privileges, eSignature privileges) as well as access to the Conga Trigger formula field.

      Important

      The User to send as overwrites the EmailFromId parameter when you add the EmailFromId parameter to your solution.

    4. Send Session ID must be enabled.
    5. Selected Fields must include the Master Object ID (id) and the Conga Trigger formula field.
  5. Click Save.
  6. Click Done.
  7. Click Activate. The Active checkbox enables and the Activate button changes to Deactivate.

Test the Conga Trigger solution.