Twitter Integration Module

This module converts incoming Twitter direct messages into FreeScout conversations and allows support agents to reply from FreeScout.

Each mailbox can be connected to it’s own Twitter account.

Twitter conversations are marked with the corresponding badge.

Before Purchasing

Before purchasing the module make sure that you have a Twitter Developer Account (see “Step 1” of the Instruction below) and that you are able to create a Twitter app at The module also requires you to have “X API access level” of Enterprise, (According to Twitter, the monthly costs for this start at 42,000 USD) as the module utilizes Account Activity API to set up the webhook.


  • PHP >=7.1
  • FreeScout should use HTTPS protocol
  • FreeScout should NOT be protected with Basic HTTP Authentication.


Twitter integration errors are logged in:

  • “Manage » Logs » App Logs”
  • “Manage » Logs » Twitter Errors”


1) Apply for Twitter Developer account at

2) Create an app at (regular app, not a Standalone).

3) Copy Twitter Consumer “API key” and Consumer “API secret key” to the FreeScout.

4) Go to the “Keys and tokens” section of the Twitter app, click “Regenerate” button next to “Access token & secret” and copy generated “Access Token” and “Access Token Secret” to the FreeScout.

5) In app’s settings in “User authentication settings” section select “OAuth 1.0a” and choose “Read + Write + Direct Messages”. In “Callback URI / Redirect URL” enter your FreeScout URL.

6) Select “Production” environment under “Environment” section.

7) Go to Twitter settings in the FreeScout and turn on “Enabled” checkbox.

Auto Replies

If you want to send auto replies to customers messaging you via the Twitter you can use Workflows Module (“Communication Channel” condition allows you to distinguish messages sent via the Twitter).


If you are receiving the following error “Error occurred setting up a Twitter webhook: [{“code”:200,”message”:”Forbidden.”}]” when enabling the integration try these recommendations. Also make sure you have “Enterprise” access level.

Lifetime license for one FreeScout instance
  • Version: 1.0.13
  • Required App Version: 1.8.97
  • License Period: Lifetime
  • Open Source: AGPL-3.0