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


  • 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) Go to “Dev Environments” (under Products » Premium) page and click “Set up” next to “Account Activity API” (enter “prod” as the “Dev environment label”).

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).

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