Twitter

Twitter

Connect a Twitter account to chat via Twitter DM.

Integrate 
Twitter
To connect Twitter, a Twitter Developer account is required.

Twitter is an American online news and social networking service on which users post and interact with messages known as "tweets". As of 2016, Twitter had more than 319 million monthly active users and is one of the top 10 most visited websites.

Setting Up Twitter

Apply for a Twitter Developer account

  • Step 1: Apply for a Twitter Developer account
    Use a Twitter account to sign up for a developer account.
  • Step 2: Fill in the required details
    As part of the approval process, Twitter needs to understand the usage of API before approving the developer account. Please provide a clear and thorough explanation to prevent any misunderstanding or rejections.
  • Step 3: Submit and wait for the approval
    If all is good, you should receive an email on the approval of the developer account. You can continue with setting up Twitter for resala.io

Creating a Twitter App

You will require an approved Twitter Developer account to proceed to this step. Apply for a Twitter Developer account if you haven't got one yet.
  • step 1: Login to Twitter app
    Head over to the Twitter App Dashboard and log in with your Twitter Developer Account.
  • Step 2: Create a Twitter App
    Press the Create App button to create a new Twitter App. You should be prompted to fill in some information about your new Twitter App under the Application Details section.
  • Step 3: Create the Twitter Application
    Name the Twitter application and press Complete to create the app
  • Step 4: Navigate to User authentication settings section
    On the Twitter App Dashboard, locate User authentication settings section. Press Edit to make changes.
  • Step 5: Enabling Permissions
    Enable the OAuth 1.0a settings and select the Read + Write + Direct Messages option under App permissions section.
  • Step 6: Set the respective URL under General Authentication Settings Section
    Add the following URL to the corresponding fields at twitter platform.

Callback URI / Redirect URL: https://app.resala.io/twitter/redirect

Website URL: https://www.resala.io

  • Step 7: Save Changes
    Press Save at the bottom of the page to save your changes.

Setting up a Dev Environment

In order for resala.io platform to connect to your Twitter App, you will need to create a development environment on Twitter.

  • Step 1: Navigate to the Twitter Dev Environment
    Locate the Account Activity API section and press Set up Dev Environment
  • Step 2: Enter a label and select the app
    Enter a dev environment label and select the Twitter app from the dropdown.
  • Step 3: Complete Setup
    Press Complete Setup to create the dev environment. Be sure to take note of the dev environment as it will be needed to configure the platform.

Connecting Twitter

  • Step 1: Navigate to Channel Settings
  • Step 1: Navigate to Channel Settings
    From Settings Module, navigate to the menu item, Channels
  • Step 2: Add Channel
    Press Add Channel and choose Twitter. The Connect your Channel dialog should open up.
  • Step 4: Navigate to Twitter Apps
    Find your Twitter app here
  • Step 5: View app details
    Press details from the app record
  • Step 6: Navigate to User authentication settings section
    On the Twitter App Dashboard, locate User authentication settings section. Press Edit to make changes.
  • Step 7: Enabling Permissions
    Enable the OAuth 1.0a settings and select the Read + Write + Direct Messages option under App permissions section.
  • Step 8: Locate the API Key
    Select Keys and Tokens tab. Locate the API Key and add it in the corresponding field in resala.io platform.
  • Step 9: Follow through the instructions
    After you have filled in the API key value, follow through the instructions by pressing NEXT.
  • Step 10: Locate the Access Token and Access Token Secret
  • Following from Step 8, at the same tab, locate the Access Token and Access Token Secret at the bottom of the screen.
  • Step 11: Generate Access Token and Access Token Secret
    Press Generate to generate both Access Token and Access Token Secret. Once both are generated, add it to the corresponding field at resala.io platform.
  • Step 12: Follow through the instructions
    After you have filled in both values, follow through the instructions by pressing NEXT.
Connecting Twitter
  • Step 13: Add Dev Environment Label
    Add the Dev Environment Label to the corresponding field.
  • Step 14: Enable receiving direct messages from anyone
  • Navigate to Twitter Account's Privacy and Safety and enable the Receive messages from anyone option under Direct Messages section
  • Navigate to Twitter Account's Privacy and Safety and enable the Receive messages from anyone option under Direct Messages section
Enable Receive messages from anyone
  • Step 15: Complete setup at resala.io
    Press DONE to complete set up.  
Once you completed the setup, any direct messages sent to your Twitter will now be received in your space.

Channel Configuration

Twitter channel can be configured with a unique channel name.
  • Step 1: Navigate to Channel Settings
    From Settings Module, navigate to the menu item, Channels
  • Step 2: Locate the Twitter channel
    Once you have located the Twitter channel, press Configure
  • Step 3: Make the necessary configuration
    You can configure the following:
  • Channel name - Name used internally to identify the account
Important: As for the other details, take extra note while updating as it might fail to receive messages from the connected Twitter account.
  • Step 4: Update the configuration
    Press Done to update the channel configuration

Troubleshoot

If you are unable to receive messages after following the instructions above, we recommend you to check the access level of your developer account.

  • Step 1: Navigate to Twitter Developer Portal
    Navigate to the Developer Portal page on Twitter.
  • Step 2: Verify the access level
    Click on Twitter API v2 on side menu. Verify if you have the Elevated access level. If you are not under the Elevated access level, proceed to apply for Elevated access level.
Having trouble with the channel? Contact us here!