Twitter DM

Our Twitter DM integration allows you to send & receive direct messages on Twitter using your own account. You will receive these messages in a business system or with webhooks.

Capabilities

Twitter supports a wide variety of capabilities as seen in the channel capabilities grid. Below is a detailed view of each capabilities.

Content Types

  • Full Support

    API

    Text

    Plain text messages

  • Full Support

    API

    Image

    Display static images

  • Partial Support

    API

    File

    Send and receive any file types

  • Full Support

    API

    Emoji

    Unicode Emojis✨

  • Full Support

    API

    GIF

    Send animated GIFs

Action Types

  • Full Support

    API

    Link

    Display web links

  • Partial Support

    API

    Extensions

    Send custom interactive experiences built with Jav...

  • Full Support

    API

    Buy

    Request payments within a conversation

  • Full Support

    API

    Postback

    Send buttons to trigger events on your server

  • Full Support

    API

    Replies

    Suggest a few answers to reply to a message

  • Full Support

    API

    Location Request

    Request the current location of the user

Structured Messages

  • Full Support

    API

    Compound Messages

    Compose messages with multiple actions

  • Partial Support

    API

    Carousel

    Send a set of cards that can contain text, image, ...

Indicators

  • Full Support

    API

    Typing

    Display a typing indicator

  • Full Support

    API

    Read

    Display read status

Setup

Due to account limits put in place by Twitter during their beta period, we’re restricting access to the channel to companies building software on the Smooch API. If this describes your business, please contact Twitter mentioning you’re a Smooch customer to get priority access.

Alternately, if you already have a whitelisted Twitter app for the Activity API, you can already connect it via our Integration API and start building Twitter DM features inside your software.

You can create a Twitter app here and request access to the Twitter DM API here.

Direct Messages

In order for a business to receive direct messages from anyone (including accounts it does not follow), the option must be enabled in Twitter’s settings. Go to Twitter’s privacy and safety settings and check “Receive Direct Messages from anyone”. Be sure to save your changes!

Twitter DM

Structured Messages

The Twitter DM integration supports sending and receiving images, GIFs & emojis. A business can also send quick replies, location request and carousel messages. Refer to the channel capabilities grid to see all the Twitter DM integration capabilities.

You can easily send links to your users to direct them to a private conversation from a public Tweet.

Sending https://twitter.com/messages/compose?recipient_id={your account’s numeric user ID} will render in twitter a “Send a private message” button like this:

send private message

You can find your User ID here:

twitter userid

These links also works anywhere on the web. Read more details about the “Send a private message” link here.