Event subscriptions

Apart from letting you to perform read and write operations on your backend, Integration Connectors also let you subscribe to events that occur in your backend applications. For example, consider you want to get notified when a new Jira ticket is created. You can accomplish this by configuring the Jira Cloud connector for event subscriptions. By using the event subscriptions along withApplication Integration, you can create useful integrations to address your business needs. For more information, seeUse event subscriptions in your integrations

Enable event subscriptions in connections

A connection that you create can be used for any of the following purposes:

• For performing connector operations (entities and actions) only
• For event subscriptions only
• For performing connector operations and event subscriptions

The option to enable event subscriptions and configure event related details are available to you duringconnection creation. However, if you already have an existing connection and want to re-purpose it for event subscription, you can do so byediting and re-configuring the connection.

The following connectors support event subscriptions:

• Apache Kafka
• Azure AD (Entra ID)
• Hubspot
• HL7
• IBM MQ
• Jira Cloud
• Jira Server Data Center
• Rabbit MQ
• SAP Gateway
• SAP ERP
• ServiceNow
• Solace
• TIBCOEMS
• Webhook
• Zendesk

Data enrichment in event notifications

You can configure a connection to append additional information in an event notification response. The additional information is specific to the entity for which you have configured the event. To get the additional information, you must enableData enrichment in your connection.

For example, if you have subscribed for a ticket creation event in Zendesk, you will be notified when a ticket gets created. However, the event notification payload consists only the basic ticket details. Additional details such as ticket description, assignee, and status aren't present in the payload. To get these additional details of theticket entity, you must enable data enrichment in a Zendesk connection. For more information, seeConfigure event subscription. Thefollowing samples show the response payload without and with data enrichment.

{"account_id":12345,"integration_key":"my_integration_key","subdomain":"my_zendesk_subdomain","input":{"ticket_event":{"meta":{"version":"1.0",........"position":1,"total":9}},"type":"Ticket Created","ticket":{"id":35436,........"external_id":"TEST1234","tags":["enterprise"],"via":{"channel":"web"}}}}

{"context-data":{"AllowChannelback":false,"Assignee":null,"AssigneeId":1.6696812051473E13,"Brand":null,"BrandId":1.6696812163985E13,"Cc":null,"CollaboratorIds":null,"Commenter":null,"HasAttachment":null,"CreatedAt":"2023-07-08 11:37:19.0","CustomFields":null,"Description":"Test desc 2",........"Status":"open","Subject":"Test Zendesk Ticket Created -2 -DA","Submitter":null,"SubmitterId":1.6696812051473E13,"Tags":"tag-changed-after-cache,ticket-created",........"ViaChannel":"web","ViaFollowupSourceId":null,"ViaSource":"{\r\n  \"from\": null,\r\n  \"to\": null,\r\n  \"rel\": null\r\n}","View_Id":null},"data":{"account_id":12345,"integration_key":"my_integration_key","subdomain":"my_zendesk_subdomain","input":{"ticket_event":{"meta":{"version":"1.0",........"position":1,"total":9}},"type":"Ticket Created","ticket":{"id":35436,........"external_id":"TEST1234","tags":["enterprise"],"via":{"channel":"web"}}}}}

• If you have enabled data enrichment, the response payload contains thecontext-data field in addition to the normal response that you would have got without data enrichment. In the previous example, thecontext-data field contains additional details of the newly created ticket in Zendesk.
• Only theZendeskconnector supports data enrichment for event notifications.

Private connectivity for event subscription

For enhanced security, you can configure private connectivity between your backend application and your connection. In private connectivity, the event listener of your connection will not be made public directly. Instead, you must allow ingress network traffic to the event listener through a PSC service attachment that will be provided to you by Integration Connectors.

During connection creation, if you have selectedEnable private connectivity for event subscription, Integration Connectors creates aPSC service attachment. You must expose the PSC service attachment to your backend application by using any approach that is sutiable to you. One possible approach is to use the PSC service attachment in a load balancer, and then configure the load balancer to accept events from your backend application. The connection then listens to your backend's events on the load balancer's address. The following high-level steps show how you can use a load balancer to configure private connectivity:

1. Go to the connection details page of the newly created connection.
2. ClickEdit ingress endpoint. This shows theEvent subscription settings pane.
3. Copy the service attachment name as displayed in thePSC service attachment name field.
4. Create aPSC network endpoint group pointing to the service attachment that you got in the previous step.
5. Create anexternal load balancer with the PSC network endpoint group created in the previous step as the backend.Tip:If you already have an external load balancer, you can use it to configure private connectivity, instead of creating a new one.
6. Configure the load balancer to accept requests from your event provider's (backend application) IP address.

   The subsequent setps (7 to 11) are applicable only in connectors whose backend supports auto-registration of event subscription. For example, Zendesk, and Jira.

7. Go to the connection details page of the newly created connection.
8. ClickEdit ingress endpoint. This shows theEvent subscription settings pane.
9. Enter the address of the load balancer in theEvent listener ingress endpoint field.
10. ClickDone.
11. ClickSave to save the changes to the connection.

Use event subscriptions in your integrations

When you use event subscriptions along with your integrations, you can create integrations to solve your complex business problems. For example, you can start the execution of your entire integration based on a ServiceNow event. Application Integration provides the following triggers that listen to event notifications from your backend applications:

• Azure AD trigger - Listens for Azure AD events.
• HL7 trigger - Listens for HL7 events.
• HubSpot trigger - Listens for HubSpot events.
• IBM MQ trigger - Listens for IBM MQ events.
• Jira Cloud trigger - Listens for Jira Cloud events.
• Rabbit MQ trigger - Listens for Rabbit MQ events.
• ServiceNow trigger - Listens for ServiceNow events.
• TIBCOEMS trigger - Listens for TIBCOEMS events.
• Webhook trigger - Listens for generic webhook events.
• Zendesk trigger - Listens for Zendesk events.

To configure the triggers, you must enable event subscription for your connections. You can either enable the event subscription in an existing connection, or in a new connection. For detailed steps on how to configure these Application Integration triggers, see the corresponding trigger documentation.

View active subscriptions

When you use an event subscription in your application integration, Integration Connectors creates an entry for the subscription in the corresponding connection. To view all the subscriptionsfor a connection, perform the following steps:

1. Open the all Connections page for your Google Cloud project.

   Go to the Connections page

2. Click the connection for which you want to view the subscriptions.

   This opens theConnection Details page.

3. Click theSubscriptions tab.

   This displays all the subscriptions for the connection. A subscription listed on this page can be in any of the following states:

   • Creating - The subscription is being created by an integration.
   • Active - The subscription is valid and functioning.
   • Suspended - The connection is in asuspended state.
   • Error - The subscription creation is unsuccessful. For example, authentication failure during subscription creation.