app.trial_started

The app.trial_started event is emitted when a trial of the partner app officially starts. This will follow the app.installed event and the partner successful acknowledgement of the installation via Apps API.

📘

Supported Regions and Base URLs

👍

Access and Registration

Authentication

Payload Types

AttributeDescription
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
expires_at
datetime
Expiration date and time for the trial subscription
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_started",
    "app_id": "8fcf7a3762d94f938e71b3a42618fd14",
    "app_version_id": "dd357179dc4a4f8a9c243638eb122f69",
    "data": {
      "installation_id": "4400ebd85fa04322abf5b64de93dc913",
      "account_id": "573491d5df012e3242001b52",
      "expires_at": "2017-08-18T10:29:52.000+00:00"
    },
    "_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:

AttributeDescription
selfURL to retrieve the event content
installationURL to retrieve installation data
rootURL to Talkdesk's API Gateway

🚧

Troubleshooting

If you have any questions regarding the usage of this API, or if you’re having any technical issues, please open a ticket using this form.