Webhook Configuration 

Registering a Webhook 

  • Navigate to Settings > Widgets > Add and give a name for your widget. 

  • Then, choose a brand for which you want to create a widget.

  • Then, choose the modules.

  • Then, choose the platform to build your widget on - Webhooks

  • Then, click Create Widget.

  • The Webhooks configuration window appears. Provide the URL to be invoked for creating a connection.

Webhook Pre-requisites

  • The "https" URL is recommended for security reasons. 
  • Our server can not connect with the URL with the port number.
  • Make sure the URL can be accessed in public API clients such as Postman and Talend API Tester to be accessible in our server.
  • Once the URL is provided, it will be pinged to get validated with the read time out of 5 seconds
  • If it is not reached within 5 seconds, an HTTP HEAD request gets triggered to the URL to check the status code 200.
  • Ensure the webhook returns the response within 10 seconds. If not, the bot will not work. 
  • Furthermore, generate a public key to secure your webhook.​​

  • Then, click Save.

  • You can preview your widget before you publish it in the Widget Preview window. You can choose the module of your choice and preview the widget.

  • Once you are done, click Publish.

  • You can also edit the URL, if required .

 

Webhook failure alerts

When the webhook continuously fails under the below instances, SalesIQ will send an email alert to both the bot creator/modifier and the portal owner.

  • No emails will be triggered for the first failure.
  • The first warning email will be sent after the second failure, with no success within the past hour.
  • The second warning/alert will be sent following the third failure, with no success within an hour of the first warning email.
  • Upon the fourth failure, with no success within an hour since the second warning email, the bot will be disabled, and a third
  • warning/alert email will be sent.

410 Error: If the webhook returns a 410 error at any time, it will be instantly deactivated, and a warning/alert email will be sent.