Introduction
Channels
Templates
Contacts
Messages
API
public
beta
Docs Contact Login

Twitter Twitter

Send Tweets and direct messages to your contacts with Notifuse.

Features

Twitter specific features
Geo-tagging Set the location of your Tweets.
Reply to Tweets You can post messages in response to other Tweets.
Tag a place Set the Place of your Tweet.
Attach medias Include up to 4 photos or 1 animated GIF or 1 video in your Tweet.

Connect Twitter

Connecting your Twitter account with Notifuse is as simple as clicking on the "Twitter Connect" button in your project!

Posting a Tweet with Notifuse

There are 2 kinds of Tweets: messages on your timeline and direct messages. Here is how to write your templates:


  {# To mention the user in your Tweet: #}
  Hello @{{twitterUsername}}

  {# To send a direct (private) message to a user, start your Tweet with a D: #}
  D @{{twitterUsername}} your message...

  

Available settings

The Twitter settings are defined at the template level from the Notifuse interface when you create/update a template.

If you don't plan to create your templates via API, or overwrite some settings at the last minute when you send a message (via API), you can skip the following table.

However it can be useful to overwrite some settings when you send a message from the API, like the inReplyToStatusId parameter to reply to a special Tweet.

The settings you can overwrite when you send a message via API are marked in the Available in column.
Parameter Expected value Available in Description
twitterUsername
required
string: username contact, message Twitter username of your contact, without the @.
text
required
string template Content of your Tweet.
inReplyToStatusId
optional
string: tweet id template, message The ID of an existing status that the update is in reply to.
Note: This parameter will be ignored unless the author of the tweet this parameter references is mentioned within the status text. Therefore, you must include @username, where username is the author of the referenced tweet, within the update.
possiblySensitive
optional
boolean template, message If you upload Tweet media that might be considered sensitive content such as nudity, violence, or medical procedures, you should set this value to true. See Media setting and best practices for more context.
latitude
optional
number: from -90.0 to +90.0 template, message Latitude of the geo-tagging. Required with the longitude parameter.
longitude
optional
number: from -180.0 to +180.0 template, message Latitude of the geo-tagging. Required with the latitude parameter.
placeId
optional
string template, message Twitter Place id for geo-tagging.
displayCoordinates
optional
boolean template, message Whether or not to put a pin on the exact coordinates a tweet has been sent from.
mediaIds
optional
array of ids template, message A list of media_ids to associate with the Tweet. You may include up to 4 photos or 1 animated GIF or 1 video in a Tweet. See Uploading Media for further details on uploading media.
testData
optional
object template JSON object of fake data used to test your templates.

Next: How to use the templates ยป