Developer Hub - Webhooks

Link: https://support.brilliantdirectories.com/support/solutions/articles/12000083005

Overview

Webhooks are one of a few ways web applications can communicate with each other. It allows to send real-time data from one application to another whenever a given event occurs.

The Webhooks functionality can be used to send data to any URL endpoint.  This allows for sending data to intermediaries (Zapier, Pabbly Connect, Wokato, APIFuse, etc), API endpoints on other platforms, or custom endpoints created by the user to receive data.

To learn how to connect a webhook through Zapier see: Connecting Webhook Events With Zapier

For Smartlist Webhooks and how to connect them see: How To Create Smart List Webhooks

Webhooks

To set up a form to send submitted data to a custom Webhook URL, navigate to the Developer Hub >> Webhooks.

Available Webhook Events - Event Name

A "Webhook Event" is the action that triggers data to be sent to a Webhook Link (URL). The following Webhook Events are currently supported.

Actions

The actions column is going to display Edit and Delete options for Custom Webhooks. Default Webhook Events can't be deleted.

Event

A user submitting the following forms will trigger the data submitted in those forms to be sent to the Webhook Link in addition to its normal functionality.

• Member Review Submitted - [form=member_review]
• Contact Us Form Submitted - [form=contact_form]
• Newsletter Signup - [form=newsletter_modal_signup]
• Lead Submitted - [form=bootstrap_get_match]
• Paid Members Signup - [Using On-Site Payment Gateway - form=whmcs_signup_paid]
• Paid Members Signup - [Using Off-Site Payment Gateway - form=whmcs_signup_external]
• Free Members Signup - [form=signup_free]
• Members Imported / Added / Updated / Deleted Via Admin (Sends data when members are imported, added manually via Admin, when the member data is updated through Quick Edit and when the member is deleted.) 
• Post - Standard (Sends data when one of these gets created or updated: Videos, Articles, Blog Articles, Jobs, Events, Coupons, Audios, Discussions)
• Post - Photo Album (Sends data when one of these gets created or updated: Photo Albums, Digital Products, Products, Classifieds, Properties)
• Sub Account Form Submitted
  
• Contact Details Form Submitted - [form=member_contact_details & form=contact_general_user]
• Additional Details Form Submitted - [form=member_listing_details]
• About Me Form Submitted - [form=about]
• Profile Photos Form Submitted - Profile, Logo, Cover Phto
• Member Clicked Email Verification Link - "basic-validation" email variable: %confirm_link%
• Member Plan Changed (Upgrade, Downgrade)
• Member Plan Cancelled (Cancel Account)
• One-Time Purchase (Lead, Pay Per Post, Digital Download)
• Post Comment Submitted
• Smart Lists (Form Inquiries, Reviews, Leads and Members)
• UnsubscribedForm Submitted (unsubscribe_email)
• Chat Message Actions (Sends data when a chat message is submitted)
• Member Dashboard Payment (Sends data when a member makes a payment directly from their dashboard)
• System Invoice Action (Sends data when the system collects a recurring payment during the daily cronjob)
• Admin Subscription / Invoice Action (Sends data when an Admin creates a new subscription, 
  modifies an existing subscription, or modifies and invoice via de admin area)
• Lead Accept / Decline (Sends data when a member accepts or declines a lead)
• + Custom Forms  
  
  

Note: Custom versions of the Contact Details + Additional Details + About Forms using a different variable and name are going to appear when creating a custom webhook when clicking on "New Webhook +".

Category

The category column explains what is the form that will send the data to the webhook.

Enable Webhook?

Toggle On - Off to enable or disable the Webhook.

Webhook Link

Enter the full URL of the endpoint the data should be sent to when the corresponding Webhook Event is triggered.

New Webhook

To create a custom webhook using a custom form click on "New Webhook +"

On the Pop Up window Custom Webhook:

1. Select Custom Form or Smart List
2. Enter a Webhook Nickname
3. Enter an Internal Description

Click on "Save Changes". To test the Webhook Event enter a Webhook Link and submit the custom form, if a form was selected, or add a member to a smart list if a Smart List was selected.

For Smartlist Webhooks and how to connect them see: How To Create Smart List Webhooks

Save Webhook Settings

To save changes on the Webhook Events page.

Add "Single Image" & "Multi-Image" Post Types Custom Webhooks

Our webhooks include a Single Image Post Type (Post - Standard) and Multi-image Post Types (Post - Photo Album):

These webhooks will apply to all post types with these characteristics. If needed a custom webhook can now be created for a specific post type. 

Click on New Webhook + then select the specific "Feature" form:

Post-PhotoThis new custom webhook will be used for the specific post type, and the rest of the post types will continue to use the default Post-Standard or Post - Photo Album, depending on it's type. 

Activity Tracker 

Logs of the Webhook actions and the information sent can be seen in the Activity Tracker.

When an individual webhook is triggered, log this action in the Activity Tracker:

When a Smart List webhook is triggered, log the first record sent to the webhook endpoint with a confirmation message that the webhook data was correctly sent.

Multi-Value Fields(Checkboxes, Dropdowns, Radial Buttons)

All Multi-value fields types like Checkboxes, Dropdowns and Radial buttons will send the normal information and additionally, it will send information about the field Option labels from the front end and database variables. These can be identified with labels that have "_stringify" on the webhooks

For example a checkbox field:

When the options are selected:

The information sent  to the webbooks: 

• Array of the different options selected : "checkbox_label": ["option_1","option_2","option_3"] 
• Database Values: "checkbox_label_stringify": "option_1,option_2,option_3" 
• Values of Labels in the front end "checkbox_label_values_stringify": "Option 1,Option 2,Option 3" 

This information can also be viewed in the Activity Tracker:

Developers: Data Transfer with Webhooks

What happens when a Form Submission Webhook Event is triggered?

When a user submits one of the forms a Webhook is configured for, the data submitted in the form is sent to the Webhook URL via CURL (https://www.php.net/manual/es/book.curl.php) as a POST array.

For example, the default Contact Us form has the following fields:

• Name [yourname]
• Email [inquiry_email]
• Phone Number [phone]
• Message [comments]

A user submits the following information to these fields: