Webhooks in IT Expert

[JLehr]

Webhooks seamlessly integrate external applications and services with EcoStruxure IT.

Get real-time data updates, trigger specific actions based on events, automate workflows, and enhance collaboration between different systems.

Administrators can configure webhooks to manage the incident escalation process in platforms such as ServiceNow, X-matters, MoogSoft, or on local servers.

An IT Expert subscription is required.

About webhooks

Webhooks are automated requests sent from one application or service to another when a specific event occurs.

An application subscribes to events to receive notifications when those events happen. The webhook subscription describes the event the application wants to receive and the destination where webhooks should be sent.

Configure webhooks in EcoStruxure IT

Add destinations

Go to Administration > More > Webhooks.

Add one or more destinations and then add subscriptions. Subscriptions must be associated with a valid destination.

Click New destination.

Specify the Destination name and the URL starting with https://

Select the Authentication method, Basic or Token.

For Basic authentication, enter the Username and Password.

For Token authentication, enter the Security token.

Click Save.

Add subscriptions

Click New subscription.

Specify the Subscription name and select the Event type, API version, and the Destination.

At this time, only the ALARM event type and 1.0.0 API version are available.

Select a destination from the dropdown list, or click New to create a new destination.

Note: Multiple subscriptions can point to a destination.

When you select an existing destination, you can click Info to update it. You can modify its name and URL or reset its authentication. Click Update to save your changes.

Click Save. 

Modify webhook settings

Click the dots next to each entry to see available actions.

Destinations

• Edit
• Delete: You cannot delete a destination when a subscription is associated with it.

Subscriptions

• Test configuration: Sends multiple requests to the destination with data that can be used by the subscription.

  After a subscription begins sending events, view the delivery log to verify. If an event cannot be delivered after several retries, it will be logged as failed.

• Delivery logs: View the log for the subscription including the Timestamp, Request start time, End time, Duration, Destination URL, Authentication method, and Description. The delivery log cannot be exported at this time.
• Edit
• Delete

[DrewWatson]

Will teams webhooks be supported? 

[JLehr]

Hi @DrewWatson,

Engineering verified that Teams webhooks are not supported.

Teams uses its own JSON formatted objects with predefined fields, which IT Expert does not support.

Since Teams needs a special message format, direct integration won't work; you'll need to transform the data.

You might consider using a message adaptation service to receive messages from IT Expert, transform them into the format Teams expects, and then forward the adapted message to Teams.