app.trial_ended

The app.trial_ended event is emitted when a trial of the partner app has been expired by the system, or ended by the user in the event of app uninstallations or subscription changes.

Payload Types

Attribute

Description

installation_id
string

Unique identifier of the partner app's installation in the Talkdesk account of the user

account_id
string

Unique identifier for the customer's Talkdesk account

ended_at
datetime

The date time when the trial ended

expires_at
datetime

Expiration date and time for the trial subscription - in this case, it will be the same as the event date

ended_reason
string

The reason for the trial ending: trial_expired, app_uninstalled or plan_upgraded. Trials will end because the system had expired the trial (trial_expired), or if a customer uninstalls the app (app_uninstalled) or upgrades the subscription to a paid one (plan_upgraded).

ended_by
string

The initiator of the trial ending: system or user. Trials will end because the system had expired the trial (system), or if a customer uninstalls the app or upgrades subscription (user).

app_version_id
string

Unique identifier of the partner app's version

Payload Example

{
    "id": "a16521d26f89418dab1402e68c5a4ba7",
    "created_at": "2017-08-18T10:29:52.000+00:00",
    "api_version": "1",
    "type": "app.trial_ended",
    "app_id": "8fcf7a3762d94f938e71b3a42618fd14",
    "app_version_id": "dd357179dc4a4f8a9c243638eb122f69",
    "data": {
      "installation_id": "4400ebd85fa04322abf5b64de93dc913",
      "account_id": "573491d5df012e3242001b52",
      "expires_at": "2017-08-18T10:29:52.000+00:00",
      "ended_at": "2017-08-08T10:29:52.000+00:00",
      "ended_reason": "trial_expired",
      "ended_by": "system"
    },
    "_links": {
      "root": {
        "href": "https://api.talkdeskapp.com"
      },
      "self": {
        "href": "https://api.talkdeskapp.com/apps/8fcf7a3762d94f938e71b3a42618fd14/events/a16521d26f89418dab1402e68c5a4ba7"
      },
      "installation": {
        "href": "https://api.talkdeskapp.com/apps/8fcf7a3762d94f938e71b3a42618fd14/installations/4400ebd85fa04322abf5b64de93dc913"
      }
    }
  }

The links section contains:

Attribute

Description

self

URL to retrieve the event content

installation

URL to retrieve installation data

root

URL to Talkdesk's API Gateway