# Authorizations

### Google Drive

To authorize your Google Drive connection, you just need to log into your Google Drive account when asked.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2Fxn3AtMVUTCSILFe2S7XS%2Fimage.png?alt=media&#x26;token=f9161578-cda5-49d1-b3f9-f365774bdc91" alt=""><figcaption></figcaption></figure>

You will see this message after you have selected your account telling you that the app isn't verified, this is because we are waiting on Google to approve our app - to continue, click the "Advanced" button in the bottom left and then "Go to myaskai.com":

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2FamlkSxL1gZ5AITbNFkVt%2Fimage%20(61).png?alt=media&#x26;token=9c1260f9-26b6-4a5d-ace2-74ca5da4ad14" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
If you are using a Google workplace account, you may need your admin to grant access to 3rd party apps to connect.
{% endhint %}

#### My Google Drive connection is blocked (for a Google Workspace account)

If you are the Google Workspace admin

You can approve (or unblock) the app like this:

1. Go to [admin.google.com](http://admin.google.com)
2. Security → Access and data control
3. Open API controls
4. Click App access control
5. Find the app: [`692421788097-i80n4hu6c7pbmhhi366ltudlo43i7kpi.apps.googleusercontent.com`](http://692421788097-i80n4hu6c7pbmhhi366ltudlo43i7kpi.apps.googleusercontent.com)
6. Change the status for the app to: **Trusted** (full access)
7. Save changes

For further info: <https://support.google.com/a/answer/7281227?hl=en-IN>

### OneDrive

To authorize your OneDrive connections, you just need to log into your Microsoft account when asked, then click confirm to grant permission.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2F4iqUXMXC7iXm26DqCtrt%2Fimage.png?alt=media&#x26;token=6cf22ec1-f16e-471a-83fb-5b0adc1b7a5b" alt=""><figcaption></figcaption></figure>

#### [​](https://docs.carbon.ai/connectors/onedrive#microsoft-admin-approval-2)Microsoft Admin Approval <a href="#microsoft-admin-approval-2" id="microsoft-admin-approval-2"></a>

To allow My AskAI to access your Microsoft applications (OneDrive and SharePoints), users might need to request admin consent approval.

Here’s a step-by-step guide:

#### [​](https://docs.carbon.ai/connectors/onedrive#prerequisites-2)Prerequisites <a href="#prerequisites-2" id="prerequisites-2"></a>

Before you begin, ensure you have:

* Gone through My AskAI's managed OAuth flow and submitted the admin consent request (see screenshot below):

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2Ff0Gy51udIdS0dpaNpFaD%2Fimage.png?alt=media&#x26;token=a415aa0b-dfb2-4c11-a2c9-6dcaeb3af45c" alt="" width="375"><figcaption></figcaption></figure>

* An administrator role or designated reviewer role to review admin consent requests

#### [​](https://docs.carbon.ai/connectors/onedrive#approve-the-request)Approve the Request <a href="#approve-the-request" id="approve-the-request"></a>

1. Sign in to the Microsoft Entra admin center as at least a Cloud Application Administrator who is a designated reviewer.
2. Navigate to **Identity** > **Applications** > **Enterprise applications**.
3. Under **Activity**, select **Admin consent requests**.
4. Select the **My Pending** tab to view and act on the pending requests.
5. From the list, select the My AskAI application that is being requested.
6. Review the request details:
   * Select **Review permissions and consent** to see what permissions are being requested by My AskAI.
   * Select the **App details** tab to view the application details.
   * Select the **Requested by** tab to see who is requesting access and why.
7. **Approve the request** to grant admin consent to allow My AskAI to access your Microsoft application. All requestors will be notified that their request for access is granted. This allows all users in your tenant to access My AskAI unless otherwise restricted with user assignment.

#### Do You Have the Right Permissions?

If you are unable to consent to the approval request under **My Pending** because the admin consent flow has not been activated, then you will need **Global Administrator** permissions. Once you are a **Global Administrator**, you can set up the admin consent flow or consent directly via My AskAI's managed OAuth flow.

![](https://imagedelivery.net/_sHUUMiZokZ59YDFOZEZTw/d45b40bc-423a-4f77-3dc5-f93f2633fa00/public)

### Dropbox

To authorize your Dropbox connection, you just need to log into your Dropbox account when asked.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2Fo507FJ8d9Wp9CMN6yzru%2Fimage.png?alt=media&#x26;token=f012ca5e-8376-4315-825b-2bcc06315e4f" alt=""><figcaption></figcaption></figure>

### Intercom

{% hint style="warning" %}
Your Intercom help center must be published and turned on to use this feature
{% endhint %}

To authorize your Intercom connection, you just need to log in and authorize your Intercom account when asked.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2FTqlqVpKuZcvMzgEgX07i%2Fimage.png?alt=media&#x26;token=67de77ca-a821-4ab0-9f25-2ae6ab3051b0" alt=""><figcaption></figcaption></figure>

### Zendesk

To authorize your Zendesk connection, you just need to provide the Zendesk sub-domain of the account you want to connect when asked, then log in with your Zendesk account details to approve.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2FtXwl6TYd6AuRYEudCLUi%2Fimage.png?alt=media&#x26;token=3e11e1ef-60ad-40df-9aac-f1fb37310e5c" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2F8yKyeH6fTGWXGlqEBneu%2Fimage.png?alt=media&#x26;token=4babfdf5-a6f2-4fd1-9c29-57a7c7840d88" alt=""><figcaption></figcaption></figure>

### Freshdesk

{% hint style="warning" %}
If you are unable to connect to Freshdesk, first check whether you have Admin permissions on your Freshdesk account as it will be needed to connect to your knowledgebase.

The role type you need to connect i&#x73;**`Account Administrator`**
{% endhint %}

To authorize your Freshdesk connection, you just need to provide the Freshdesk domain and API key you want to connect to when asked.

{% hint style="info" %}
When adding your Freshdesk domain, ensure it is your original Freshdesk domain e.g. yourdomain.freshdesk.com, not any custom domains you may now use.
{% endhint %}

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2F8JcLyPf0ABBe9snh2bos%2Fimage.png?alt=media&#x26;token=ed693fc7-bfd8-4320-b67e-947a5c21cc1b" alt="" width="360"><figcaption></figcaption></figure>

To find your API key:

1. Log in to your Freshdesk Support Portal
2. Click on your profile picture on the top right corner of your portal

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2FmXHj97YjIK0WCEY9t6RY%2Fimage.png?alt=media&#x26;token=e5ab94b4-187b-4e8c-ae0b-cbb0181a4be9" alt=""><figcaption></figcaption></figure>

3. Go to Profile settings Page

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2Fpi6Wh7tkmQXpxi9xNrla%2Fimage.png?alt=media&#x26;token=3c2e0533-99f9-460b-ba42-b419ead9e47f" alt=""><figcaption></figcaption></figure>

4. Your API key will be available below the change password section to your right.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2F2Ro2pTGIvG5R6bno8Yqt%2Fimage.png?alt=media&#x26;token=4fdec0be-e507-4a7d-8b0b-84c691fcda5f" alt=""><figcaption></figcaption></figure>

For more information, please refer to [this solution article](https://docs.carbon.ai/connectors/'https://support.freshdesk.com/en/support/solutions/articles/215517') from Freshdesk.

### Notion

To authorize your Notion connection, you just need to log in and authorize your Notion account when asked and grant permission.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2FPwWUTrsOwJCKR3WVFkAB%2Fimage.png?alt=media&#x26;token=c24a41a0-ca55-4fa3-9e7c-651461fae375" alt="" width="563"><figcaption></figcaption></figure>

### SharePoint

To authorize your SharePoint connection enter your SharePoint `tenant` and `site name`.&#x20;

For example, if the SharePoint site URL is: `https://mikemmyaskai.sharepoint.com/sites/myaskai-dev`

`mikemyaskai` is the tenant and `myaskai-dev` is the site name.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2F1lkULcagQE2hoCKQ0L2t%2Fimage.png?alt=media&#x26;token=46f51e44-ec95-490b-a45b-5d1ade1f4d45" alt=""><figcaption></figcaption></figure>

Log into your Microsoft SharePoint account.

<figure><img src="https://i.ibb.co/86FPknL/Screen-Shot-2023-08-31-at-4-41-48-PM.png" alt=""><figcaption></figcaption></figure>

Click the “Confirm” button to grant us permission to access your SharePoint.

<figure><img src="https://i.ibb.co/x6L7knS/Screen-Shot-2023-10-24-at-11-45-27-AM.png" alt=""><figcaption></figcaption></figure>

Once clicking “Confirm”, you will be taken through a flow to grant permissions.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2FyXrWKmAq0XaCDEb7FDht%2Fimage.png?alt=media&#x26;token=21df8b2b-da8a-43b4-9255-f935f18434a3" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
You may get a message like the below, if you are using a workplace Sharepoint, if so you will need to get your company admin to grant access to 3rd party apps in order to connect, you can [read more on user consent and permissions here](https://learn.microsoft.com/en-us/microsoft-365/admin/misc/user-consent?view=o365-worldwide).
{% endhint %}

{% hint style="info" %}
Note, the app approval request will be for My AskAI.
{% endhint %}

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2Flh5SymO3TE4Woa4FbFTj%2Fimage.png?alt=media&#x26;token=9fa265ca-61a0-4036-93eb-70a9a0056eb5" alt="" width="375"><figcaption></figcaption></figure>

#### Approving the SharePoint admin request

1. Sign in to the Microsoft Entra admin center as at least a Cloud Application Administrator who is a designated reviewer.
2. Navigate to **Identity** > **Applications** > **Enterprise applications**.
3. Under **Activity**, select **Admin consent requests**.
4. Select the **My Pending** tab to view and act on the pending requests.
5. From the list, select the Carbon application that is being requested.
6. Review the request details:
   * Select **Review permissions and consent** to see what permissions are being requested by Carbon.
   * Select the **App details** tab to view the application details.
   * Select the **Requested by** tab to see who is requesting access and why.
7. **Approve the request** to grant admin consent to allow My AskAI to access your Microsoft application. All requestors will be notified that their request for access is granted. This allows all users in your tenant to access My AskAI unless otherwise restricted with user assignment.

{% hint style="info" %}
If you are unable to consent to the approval request under **My Pending** because the admin consent flow has not been activated, then you will need **Global Administrator** permissions. Once you are a **Global Administrator**, you can set up the admin consent flow or consent directly via Carbon’s managed OAuth flow.
{% endhint %}

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2FhzuqKLqkBfTSLUcOss4W%2Fimage.png?alt=media&#x26;token=dc2da224-7b39-4f4c-b798-04cc80b795be" alt=""><figcaption></figcaption></figure>

### Confluence

To authorize your Confluence connection, you just need to provide the Confluence sub-domain of the workspace you want to connect to when asked, then log in with your Confluence account details to approve.

When you connect Confluence, the content that will be synced will be the same content that the user profile (used to authenticate with Confluence) has access to (i.e. all available content, you can't choose specific content to add).&#x20;

If you want to choose specific content to add from Confluence you can create a separate, specific account on Confluence that has access to certain 'spaces' to make sure that only certain content is synced.

For example, if the Confluence workspace URL is `https://myaskai.confluence.com`, then`myaskai` will be the subdomain.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2FW9Y40b5rdLzcUVRllOaM%2Fimage.png?alt=media&#x26;token=578d3701-b21e-4426-9780-7e85fed0f7c7" alt="" width="301"><figcaption></figcaption></figure>

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2Fte2Er4pm42vrkcC1m4gH%2Fimage.png?alt=media&#x26;token=d1a86c1f-564c-49f6-a41c-4c31add4aaf0" alt=""><figcaption></figcaption></figure>

### Salesforce

{% hint style="info" %}
All `Published` articles under a single Salesforce knowledgebase will be synced. Any Draft article won’t be synced.
{% endhint %}

To authorize your Salesforce connection, you just need to provide the Salesforce domain of the account you want to connect to when asked, then log in with your Salesforce account details to approve.

For example, if the Salesforce account URL is `https://myaskai.my.salesforce.com`, then`myaskai` will be the domain.

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2FM5mJSuIGfqvQjJEjTBx6%2Fimage.png?alt=media&#x26;token=db9a5872-81c7-4cb4-979e-a3766fa31cee" alt="" width="242"><figcaption></figcaption></figure>

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2Fte2Er4pm42vrkcC1m4gH%2Fimage.png?alt=media&#x26;token=d1a86c1f-564c-49f6-a41c-4c31add4aaf0" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3477336559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhu0WRsaCQQRKP3KeuIOQ%2Fuploads%2FmExKXdzWs8TMbt8orjeq%2Fimage.png?alt=media&#x26;token=5bc1315b-302b-4d24-81a2-6894b055dbad" alt=""><figcaption></figcaption></figure>