Events

This article is to give you an understanding of the kind of listing and buyer events that Labra Flyout will inform you about via your chosen email and Slack channel

Different kind of events

AWS sends 3 categories of events for listings that are published on AWS Marketplace. Labra Flyout will be collecting the information from such events and notifying you about them.

The 3 event categories which you will get notifications for are:

  1. Buyer lifecycle events
  2. Private offer events
  3. Metering events

Buyer Lifecycle events

This will inform you of the various buyer actions taken on your AWS Marketplace listing. These would include notifying you when the following events take place:

  1. Buyer Registration Pending
    1. When a user has bought your subscription on AWS Marketplace but has not completed the registration process for setting up their account.
  2. Buyer Registration Completed
    1. When a user has bought your subscription on AWS Marketplace and has successfully completed the registration process for setting up their account.
  3. Subscribe Failed
    1. When a buyer has tried to subscribe to your listing but has failed to do so due to some error.
  4. Entitlement Renewed
    1. When a buyer’s initially bought entitlement has been renewed by them.
  5. Entitlement Expired
    1. When the entitlement purchased by your buyer has expired.
  6. Entitlement Upgraded
    1. When a buyer upgrades from an old to a new entitlement, which is being offered inside your listing.
  7. Unsubscribe Pending
    1. When a buyer unsubscribes from your product but the process is pending. In the meantime, the buyer will be able to make use of your product and their bought entitlement.
  8. Unsubscribe Success
    1. When the buyer has successfully unsubscribed and can no longer use your product.

Private Offer events

This will inform you of the status of your private offer acceptance from your buyer. You will get notifications on the happening of the following:

  1. Private offer accepted
    1. When a buyer you have sent a private offer to has accepted the offer and taken your product subscription.
  2. Private offer expiring soon
    1. When the private offer that you have shared with a buyer is about to expire, and the buyer has still not accepted the offer.
  3. Private offer expired
    1. When a private offer you shared with a buyer was not accepted and has expired.

Metering events

This will inform you whenever metering is sent for your listing to AWS Marketplace for billing purposes.

  1. Metering sent
    1. When you have sent the usage metering information for a buyer to the AWS Marketplace

Modes of Event Delivery

Currently we offer our customers multiple event delivery methods to notify them of different events

  1. E-mail
  2. Slack
  3. HTTP Webhook ( Customer provided endpoint ) to receive payloads. Refer our API documentation on webhook HTTP calls. This can help customers to setup their own workflows based on event triggers from Labra. Currently only buyer lifecycle events mentioned are supported
  • Retry Mechanism on the HTTP webhook - Currently Labra performs retries on your HTTP webhook to ensure error handling and service unavailability in case of temporary issues
    • 500 retries spanning over a 8 hours period
    • Interval will be ~ 8 minutes in linear fashion
    • Retry triggers
      • Timeout (server not available)
      • Non HTTP 2xx response code on our HTTP POST call
    • Retries end when we receive a HTTP 2xx response on any of retry or all of the retries are exhausted. Labra still maintains a copy of your webhook event in case retries exhaust

FAQs

  1. Who on my team will get email notifications for different events ?
    1. You can choose as many stakeholders from your team to receive listing notifications. It is not necessary to have the same stakeholder for each event, i.e., based on the listing event, you can choose who from your team you want to notify. Most customers share their group email list for notifications depending on type of event.
  2. Which of my Slack channels will receive notifications ?
    1. You can choose any Slack channel in your workspace where you want to get all listing notifications.
  3. Are there any more events for which I can get notifications ?
    1. No, AWS only shares the above-mentioned events with us, on which we can send you notifications.
  4. What happens to events if our HTTP Webhook faces downtime ?
    1. Labra ensures that the webhook receives events even if it faces downtime momentarily or for about 8 hours with our retry mechanism built to take care of such scenarios. Labra still maintains a copy of your webhook event in case retries exhaust