# Create New Twitter Channel

This section explains how to create a new Twitter channel by following the steps described below:

Go to the **Integration** menu and click the **Channel Connector** menu, then you will see a channel connector page in such images below.

![Channel Connector Twitter](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2Fv8yThJPMhYI3b9TgfWVe%2FChannel%20connector%20twitter%20edit.png?alt=media\&token=dd9ffc91-ef78-4b75-9a75-aa5d8aa9d76b)

On the Channel Connector page, click the **'Plus'** button in the channel Twitter account, and then you will see a pop-up channel setting. On the pop-up channel setting, you can view automatically or manual authentication display. Choose one of those to create a Twitter channel either automatic or manual authorization. 

<div><figure><img src="https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2F6ggPsksaJRiE0yyLIpqG%2FAutomatic%20Authorization%20edit.png?alt=media&#x26;token=b9e4a98b-68a7-4198-abd1-d79158edd2ea" alt=""><figcaption><p>Automatic Authentication</p></figcaption></figure> <figure><img src="https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2Fad8xeEQ6NJRWQ0qNC7YN%2FManual%20Authentication%20edit.png?alt=media&#x26;token=99f89180-1a2d-416e-814c-710c93feb89b" alt=""><figcaption><p>Manual Authentication</p></figcaption></figure></div>

### Automatic Authentication

The following fields must be completed for configuring channel setting Twitter.

![Channel Setting Automatic Authentication](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2FjL6RugIo0sxPRwBwHIE1%2FAutomatic%20Authorization%20edit.png?alt=media\&token=5692bf0b-0947-4731-b2b4-229d5eec76ca)

**Component Explanation:**

| Name                     | Description                              |
| ------------------------ | ---------------------------------------- |
| Consumer Key             | The API key to access Twitter.           |
| Consumer Secret          | The API Secret key to access Twitter.    |
| Twitter Application Type | Premium/Enterprise.                      |
| Dev Label                | Account activity API (Dev. Environment). |

{% hint style="info" %}
When you copy and paste all the needed **"access keys and tokens"**, ensure you don’t have any empty spaces, either at the beginning or at the end of these entries. If you have any empty spaces, the Application won’t work and will show an error message when you try to connect to the App.
{% endhint %}

Copy-paste the Twitter **'Consumer Keys'** to the channel setting. If you forgot your access key, you can go to the **Keys and Token** tab to regenerate the access consumer key.

![Key and Tokens Tab](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2F4c4VJznhqeKNfyGHkPRI%2FConsumer%20key%20and%20tokens%20edit.png?alt=media\&token=39a4d9b1-5f45-475f-a8a0-27783e2b3521)

Select your Twitter application type (Premium/Enterprise).&#x20;

![Application Type](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2FG1UfyZzn9kIfSxiZFd3G%2FApplication%20Type%20automation%20edit.png?alt=media\&token=89807259-a204-4fe5-91ea-34c50d696167)

You can found '**Dev Label'** one of the APIs available in the developer portal click the **Products** menu > **Dev Environment** > **Account Activity API/Sandbox**. See the image below.

![Dev Environments](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2F2C8YFwbxeiY80H9ZqeaZ%2Fdev%20environment.png?alt=media\&token=80e60e2f-f778-484a-8544-c00aeec048aa)

And then click the **'Authorize'** button. If the authorization is successful, click the **'Save'** button.

<figure><img src="https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2FnAoUCMWg3Zk6ZwDYJSt7%2Fauthorize%20automatic%20channel%20twitter%20edit.png?alt=media&#x26;token=e4b4527e-4e6b-4f0f-85b8-877af0b57a7c" alt=""><figcaption><p>Authorize Automatic Authentication</p></figcaption></figure>

### Manual Authentication

The following fields must be completed for configuring channel setting Twitter using manual authentication.&#x20;

![Channel Setting Manual Authentication](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2Fad8xeEQ6NJRWQ0qNC7YN%2FManual%20Authentication%20edit.png?alt=media\&token=99f89180-1a2d-416e-814c-710c93feb89b)

**Component Explanation:**

| Name                     | Description                              |
| ------------------------ | ---------------------------------------- |
| Screen Name              | Enter your Twitter username.             |
| Consumer Key             | The API key to access Twitter.           |
| Consumer Secret          | The API Secret key to access Twitter.    |
| Access Token             | Token to access Twitter.                 |
| Access Token Secret      | Token secret to access Twitter.          |
| Twitter Application Type | Premium/Enterprise.                      |
| Dev Label                | Account activity API (Dev. Environment). |

{% hint style="info" %}
When you copy and paste all the needed **"access keys and tokens"**, make sure there are no extra spaces at the beginning or end of these entries. If there are spaces, the App won't work and will show an error message when you try to connect.
{% endhint %}

First, enter your Twitter username. then, copy-paste the Twitter **'Consumer Keys'** and **'Authentication Tokens'** to the channel setting. If you forgot your access key and token, you can go to the **Key and Token** tab to regenerate the access key and token.

![Key and Tokens Tab](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2F4c4VJznhqeKNfyGHkPRI%2FConsumer%20key%20and%20tokens%20edit.png?alt=media\&token=39a4d9b1-5f45-475f-a8a0-27783e2b3521)

Select your Twitter application type (Premium/Enterprise).

![Application Type](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2Ff7PU2AAlKDhVye5JFx9o%2FApplication%20Type%20manual%20edit.png?alt=media\&token=92c15ea6-a348-403c-9ed1-77afb98d5845)

You can be found **'Dev Label'** one of the APIs available in the developer portal click the **Products** menu > **Dev Environment** > **Account Activity API/Sandbox**. See the image below.

![Dev Environments](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2F2C8YFwbxeiY80H9ZqeaZ%2Fdev%20environment.png?alt=media\&token=80e60e2f-f778-484a-8544-c00aeec048aa)

Enter the dev label then, click the **'Authorize'** button.&#x20;

![Authorize](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2FL8HA8qCgr2duW6B5Fq6J%2Fchannel%20setting%20dev%20label%20manual%20edit.png?alt=media\&token=5d73d7e1-2ac0-4b19-8fec-36bf4afe81dc)

And you will see a pop-up authorization channel will appear either using manual or automatic authorization then click **'Authorize App'**.&#x20;

<figure><img src="https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2FfVD6o6EAMiWag9v7o0VC%2FAuthorization%20Channel%20edit.png?alt=media&#x26;token=28771fb1-da41-4874-a887-2e0c4a98d674" alt=""><figcaption><p>Pop-up Authorization Channel</p></figcaption></figure>

You will be informed that your Twitter application is now integrated with 3Dolphins. Click the **'Proceed'** button to return to the channel connector page.

<figure><img src="https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2FFi9rAUebBq5VFX4iywcj%2FTwitter%20auth%20complete%20edit.png?alt=media&#x26;token=a8bec854-b6bc-4857-a89c-a1aa15bd6631" alt=""><figcaption><p>Twitter Authorization Complete</p></figcaption></figure>

Then, click the **'Save'** button to add your new channel.&#x20;

<figure><img src="https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2Fnm7rIEYjYYJH5VeT8Eld%2FSave%20channel%20setting%20edit.png?alt=media&#x26;token=7acfed53-3cc5-4665-8438-3553019cc613" alt=""><figcaption><p>Save Twitter Channel</p></figcaption></figure>

&#x20;Your Twitter channel has been successfully created as seen below.&#x20;

![Add New Twitter Channel](https://765826444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYDAnLjpg2T8z2BplJOS%2Fuploads%2FFe4JVfRtNmpOxxqlAhUu%2FChannel%20Twitter%20Created%20edit.png?alt=media\&token=9bfe199f-5212-41f5-bc6d-56e8f784482c)

**Component Explanation:**

<table><thead><tr><th width="92.66666666666666">No.</th><th width="218">Component</th><th>Description</th></tr></thead><tbody><tr><td>1.</td><td>Channel Name</td><td>Name of your Twitter account channel. Hover on the channel name to view the channel port.</td></tr><tr><td>2.</td><td>Channel ID</td><td>Each channel registered in Omni Channel 3Dolphins has a different ID.</td></tr><tr><td>3.</td><td>Channel Config Button</td><td><p>Click to edit your configuration channel. The following are various Twitter channel configurations:</p><ul><li>Line of Business(LOB): to edit LOB who can access this Twitter channel.</li><li>Send to current handling agent (Only Mention): the agent automatically handles new ticket's Twitter mentions from the same customer's active tickets.</li><li>Send to current handling agent (DM &#x26; Mention): the agent will automatically handle new ticket's Twitter DM and mentions from the same customer if one of those tickets is still active. </li></ul></td></tr><tr><td>4. </td><td>Channel URL Edit Button</td><td>Click to edit channel URL. If connecting with proxy, please adjust the URL accordingly.</td></tr><tr><td>5</td><td>Channel URL Copy Button</td><td>Click to copy the channel URL to the clipboard.</td></tr><tr><td>6</td><td>Online / Offline Button</td><td>Click to turn on or off the channel. Red means offline, Green means online.</td></tr><tr><td>7</td><td>Refresh Button</td><td>Refresh your channel at any time to ensure you are always up to date with the refresh button.</td></tr></tbody></table>