Overview

CleverTap allows you to export data to third-party partners, such as Amazon Web Services (AWS), Google Cloud Platform (GCP), etc. You have the flexibility to choose between one-time data exports and recurring exports. Keeping track of export status is crucial, especially for recurring exports, as they are scheduled to run at regular intervals.

This feature allows you to monitor the status of your data exports via Webhook on your preferred systems. It provides alerts when an export is initiated or completed successfully. Status tracking allows for keeping track of your recurring exports and taking necessary decisions whenever required.

📘

Supported Partners for Export Status

Currently, we provide events export status for Amazon S3 and Google Cloud Platform (GCP) partners only.

This document further explains the prerequisites, how to enable and disable export status alerts, and track and monitor them.

Prerequisite

Ensure you integrate with the preferred technology partners:

• Amazon S3
• Google Cloud Platform (GCP)
• Microsoft Azure

Setup

This procedure involves the following major steps:

1. Set up a Webhook
2. Enable Status Alerts for Exports on CleverTap Dashboard
   OR
3. Add or Modify the Webhook

Enable Status Alerts for Exports

To enable status alerts for exports:

1. On the CleverTap dashboard, go to Settings > Partners > Exports center.

2. Click the Manage Status Alerts button in the top right corner. The Manage Status Alerts window appears.

2. Toggle on the Enable the status to get notified about exports switch to enable the status alerts.
3. Click Save.

📘

Note

Once enabled, the export status tracking is applied to both existing and new export creations.

Disable Status Alerts for Exports

To disable status alerts for exports:

1. Toggle off the Enable the status to get notified about exports switch.
2. Click Save.

Add or Modify the Webhook

If required, edit the Webhook as follows:

1. On the Exports page, Click the Manage Status Alerts button in the top right corner. The Manage Status Alerts window appears.
2. On the Enable export status alerts pane, you can either create a new URL or use the existing one.

• To use an existing Webhook URL, select one of the preferred Webhook URLs from the Webhook name drop-down list.
• If required, to create a new Webhook URL, click the Add webhook link.
  For more information about creating Webhook URLs, refer to the Webhooks documentation. Once you create a new Webhook, click the Refresh icon for the new Webhook to appear here.

3. Click Save.

📘

Note

We only support a POST Webhook.

Sample Payload for Export Status

The JSON payload configured on the Webhook URL will be pushed to the user once the export begins or ends. The following is a sample JSON payload showing the export status received via the Webhook URL.

{
"Export Request Id": 1690283492,
"Partner": "Google Cloud Storage",
"Type": "Events",
"Status": "Completed",
"Frequency": "One Time",
"Date and Time": "25/07/2023 4:50:52 PM"
}

The JSON payload contains the following parameters: