# Integrations

## Overview

Channels, e.g Webhook allows you to send data to other services when specific events are triggered in TilliT

For example, when a specific activity passes in TilliT, you can send the data in a payload to Microsoft Dynamics 365.

{% hint style="warning" %}
For setting up SMS, Email, Push notification and Notification in the TilliT app see the [user-subscriptions](https://help.tillit.cloud/tillit/knowledge-base/users/manage/user-subscriptions "mention")
{% endhint %}

## Navigation

{% hint style="info" %}
Navigation: ***Settings > Integrations***
{% endhint %}

## Configure a Channel

Navigate to Settings > Integrations > Channels and **create** a Channel

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-2b23da3b9eca8b9d0498a074f7c6afe72f5ad2c6%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Fill in the form and hit **Save and Open**

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-82ac35912c9e7b4e691f71e2e5734be78e9a9253%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>The name of your channel</td></tr><tr><td>Type</td><td>Webhook, MQTT, or Sftp</td></tr><tr><td>Endpoint</td><td>See <a href="https://help.tillit.cloud/api/mqtt-api/subscribe-to-a-tillit-topic">https://help.tillit.cloud/api/mqtt-api/subscribe-to-a-tillit-topic</a></td></tr><tr><td>Options<img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-df66b5f0538f3656c576ac1af0b680b1fffbe66d%2Fimage.png?alt=media" alt=""></td><td><p>See below for general options and Sft channel options. It should be written as a json object<br></p><pre><code>export type ChannelOptions = {
  username?: string;
  headers?: any;
  authType?: 'OAUTH' | 'BASIC' | 'TOKEN';
  tokenUrl?: string;
  clientId?: string;
  secretName?: string;
  scope?: string;
  grantType?: string;
  jsonata?: string;
  contentType?: string; // Support form-urlencoded content type 
};
export type SftChannelOptions = {
tempFolder?: string;
filePrefix?: string;
host?: string;
username?: string;
port?: number;
secretName?: string;
};
Example:
{
"username": "myName",
"tokenUrl": "tokenUrl.here"
}
</code></pre></td></tr><tr><td>Transform Payload</td><td>This is a jsonata expression. See their documentation here - <a href="https://jsonata.org/">https://jsonata.org/</a>. It is used to reduce the payload size so that only the requirement data will be sent to the channel.</td></tr></tbody></table>

Click the ***Save and close*** button to finalise.


---

# Agent Instructions: 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:

```
GET https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/integrations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
