Sending Data to Salesforce Marketing Cloud using PathFactory Webhooks

1. Create a Data Extension in Marketing Cloud and ensure the following:
   • The Data Extension form has a field for each of the event field data points for a Form Capture Webhook, Visitor Session Webhook, and/or Visitor Activity Webhook.  For definitions of each webhook field and descriptions of the different webhook types see, Webhook Field Definitions.
   • If you are creating a Visitor Session or Visitor activity webhook, Session ID should be the primary key
   • All fields have an adequate length.  It is recommended to set text fields to a length of at least 255
   • All fields are set to Nullable
2. Set the “Used for Sending” option to Yes and map email address to the subscriber key.

   

1. Click on the gear icon at the top right of the page, and select Webhooks from the dropdown menu.

   

2. You are now on the Webhooks page. Click Add Webhook.

   

3. Name the webhook at the prompt.

   

4. Set the URL to https://cl.s1.exct.net/DEManager.aspx (replace “s1” with your Salesforce pod )
5. Select the webhook event type which will trigger this webhook.

   

6. If you only want information sent for visitors who are known, click Fire for known visitors only.

   

7. Click Add Webhook.

   

8. Ensure that all the mapped event fields that you need are present in Event Fields and any custom fields are set up in Custom Fields via the webhook configuration on the right hand side of the screen.

   

9. Map the following fields in custom fields. the _clientID and _deExternalKey should be your SFMC client ID, and the external key of your data extension.

   

10. Save the webhook and set it to Enabled

    

Test a Form Capture Webhook

1. Create a Form Capture webhook.
2. Enable our PathFactory Standard form on one of the assets in a PathFactory content track.
3. Engage with the PathFactory asset that has the form enabled and submit the form.
4. The engagement data will appear in the target form in the external system within 2 minutes after our standard form has been submitted.

Test a Session Activity Webhook

1. Create a Visitor Activity (Session Closed) Webhook.
2. Engage with one or more PathFactory content tracks you have built in your PathFactory install. Close the PathFactory content tracks after ending your engagement.
3. The engagement data will appear in the target form in the external system after 30 minutes from the time you have finished engaging with the PathFactory content tracks.

Test a Visitor Activity Webhook

1. Create a new Visitor Activity.
2. Create a Visitor Activity Webhook.
3. Engage with one or more PathFactory content tracks you have built in your PathFactory install, ensuring that the criteria set in the visitor activity is fulfilled.
4. The engagement data will appear in the target form in the external system after 30 minutes from the time you have finished engaging with the PathFactory content tracks. Close the PathFactory content tracks after ending your engagement.