So how does a webhook work? In short, it's like HubSpot playing ping pong with us. They fire a webhook to Seventh Sense with the contact details and then based on the timing criteria you set within Seventh Sense, Seventh Sense pings HubSpot back by manually enrolling the contact back into the specified workflow.
Most of Seventh Sense's existing customers use this functionality to make their nurture campaigns smarter as people traverse them, however can be used in all kinds of scenarios.
This knowledge base article details how to build a webhook within Seventh Sense.
On the dashboard, click on "Marketing" in either the top menu bar or on the left side of the application.
Once you are on the Marketing page, click on "Webhooks" in the left side menu.
On the Webhooks page, click on "Create" under the "Actions" menu on the left side menu.
After clicking on the "Create" icon, a modal will show up to create the webhook. For the "Name", we suggest using the HubSpot workflow name that is associated with the webhook for easy identification. The "Connector" should automatically identify the HubSpot connector. Use the droptown menu under "Workflow" which will identify the workflow that the webhook is associated with. (Tip: New workflows are always at the bottom, so scroll all the way down to find new workflow).
Underneath "Webhook Type" select when you'd like the contact to be re-enrolled in the workflow. Below are the options and intended use case of each:
- IMMEDIATE - This option will immediately re-enroll the contact into the workflow so that the next action can take place. This option is used in scenarios where a contact update needs to take place such as with an Email Marketing Fatigue Engine.
- NEXT_24_HOURS - This option is the most commonly used and was developed for nurture campaigns. Once the webhook is sent to Seventh Sense by HubSpot for a particular contact, the system will then re-enroll the contact at the next most optimal time within the following 24 hours.
- NEXT_WEEK - This option is rarely used for nurture campaigns that have an important end date. Once the webhook is sent to Seventh Sense by HubSpot for a particular contact, the system will determine the most optimal time in the next 7 days to re-enroll a contact into the workflow.
- UPDATE_ONLY -This option was created to update contact's list memberships and should only be used in examples where the list size is greater than 200K contacts. This alleviates the need to sync a list prior to scheduling.
Once all of the components of the webhook are created, click the "Create Webhook" link. After the webhook is created, you will see the same modal. Click the "x" on the top right hand side and then refresh your browser screen.
Once you've refreshed your screen, you'll see all the available webhooks similar to the below. Click on the "Details" link which will show the webhook URL, your username and password for the webhook that are the inputs for the HubSpot workflow webhook details. Please note that you need to include the entire URL in the webhook details in HubSpot.