> For the complete documentation index, see [llms.txt](https://help.clickatell.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.clickatell.com/data/data-sharing-services.md).

# Data Sharing Services

{% hint style="info" %}
Only available to clients that have adopted the Data Sharing Service.
{% endhint %}

Our Data Sharing services gives you the ability to retrieve raw data from a secure server, enabling you to analyze and apply your own insights in your environment and keep the history in your data lakes.

The raw data is supplied as standardized, templated sets of data elements referred to as "data templates". *Data Templates* are generic datasets created for each application and normalized for clients' easy consumption. You can download these sets of raw data (CSV files) from a Clickatell-hosted cloud SFTP server.

The **weekly** Data Sharing service is included as standard in all packages. You can upgrade to a higher frequency delivery at an **additional cost**. The table below describes the options available.

| Frequency         | Weekly                                                  | Once a day                                                                   | Every 4 hours                                                            | Hourly                                                                   |
| ----------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| Value             | Gain a holistic view.                                   | Build descriptive analytics for more granularity.                            | Gain real-time data insights for agile decision-making.                  | Gain real-time data insights for on-the-spot decision-making.            |
| Service           | Included                                                | Upgrade                                                                      | Upgrade                                                                  | Upgrade                                                                  |
| Retention         | 3 months                                                | 3 months                                                                     | 3 months                                                                 | 3 months                                                                 |
| No. of files      | 1 file weekly per template (7 days' data per template). | 1 file daily per template.                                                   | 6 files daily per template.                                              | 24 files daily per template.                                             |
| Delivery schedule | Mondays at 10:00 (UTC).                                 | 03:00 (UTC)                                                                  | 04:30, 08:30, 12:30, 16:30, 20:30, 00:30 (UTC)                           | 01:30 ... 22:30, 23:30, 00:30 (UTC)                                      |
| Manifest File     | Not included.                                           | <p>Weekly:<br>Mondays, 03:00 (UTC) Contains info from the previous week.</p> | Daily: 03:00 (UTC) Contains info for today -1 + last 4 hours of today -2 | Daily: 03:00 (UTC) Contains info for today -1 + last 4 hours of today -2 |
|                   |                                                         |                                                                              |                                                                          |                                                                          |

<details>

<summary>The service includes:</summary>

* A set of standard **data templates** based on the package purchased. Each template includes a standard set of data elements. Data can be downloaded on a fixed schedule based on the selected delivery frequency.
* The associated **manifest file** containing a summary view of the data in each template (if downloads occur daily or more frequently – see below).
* A **data dictionary** with detailed definitions of each data element and possible values.
* One setup per account – setup includes automatic mapping of datasets and pipeline augmentation based on package selection.
* The following 5 generic templates (availability based on the applications and channel you have configured):
  * Broadcast Messenger
  * Chat Desk (Chat Messages)
  * Chat Desk (Agent Performance)
  * Chat Flow
  * Chat 2 Pay
  * SMS
  * WhatsApp

</details>

### Delivery Conditions

&#x20;A detailed Data Sharing Agreement between Clickatell and you, the client, outlines the terms and conditions for data sharing. This establishes clear guidelines to ensure the responsible and ethical use of the shared data and to protect the interests of all parties involved.&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.clickatell.com/data/data-sharing-services.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.