Twitter

Overview

The Twitter integration allows you to create tasks on Twitter, set up automated quest creation based on your tweets, and authenticate your account. With Twitter automations, you can automatically generate quests whenever you post a tweet, streamlining your community engagement workflow.

Basics

Configuration

Community administrators can add integrations through the following path: Settings > Community > Integrations > Twitter. Once connected, any editor or admin can add Twitter tasks and configure automations. A link to your Twitter account will appear on the landing page and in your community information.

Twitter Automations

Twitter automations allow you to automatically create quests when you post tweets. This feature helps you maintain consistent community engagement without manually creating quests for each tweet.

How It Works

When you create a Twitter automation, Zealy monitors your connected Twitter account for new tweets. When a tweet matches your configured filters, the system automatically creates a quest based on your template settings.

Automation Configuration

Each automation requires the following settings:

Basic Settings

• Name (required): A descriptive name for your automation

Trigger Configuration

• Include Retweets (required): Whether to create quests on retweets
• Include Replies (required): Whether to create quests on reply tweets
• Keywords (optional): Filter tweets by specific keywords - automation only triggers when tweet contains all these terms

Quest Template

When defining what quest should be created, you configure:

• Title (required): The quest title (1-200 characters)
  • You can use dynamic placeholders like {{tweet_author}} or {{tweet_text}}
• Description (optional): Quest description text
  • You can use dynamic placeholders like {{tweet_url}} or {{tweet_date}}
• Sprint/Module (required): Which sprint or category to add the quest to
• Task Type (required): Type of Twitter task users must complete
  • Like the tweet
  • Retweet the tweet
  • Reply to the tweet

For quest-related settings like rewards, conditions, and claim limits, see the Quest Features section below.

Advanced Settings

• Delay Hours (optional): Delay quest appearance after tweet is posted
• Archive After Hours (optional): Automatically archive quest after specified time
• Cooldown (optional): Time users must wait between quest attempts - see Cooldown documentation
• Claim Limit (optional): Maximum number of claims allowed - see Claim Limit documentation
• Add to Current Sprint (optional): Whether to add quest to the currently active sprint (default: true)

AI Review (optional)

• Enable AI Review: Automatically review quest submissions using AI
• AI Prompt: Custom prompt to guide AI review - see AI Review documentation
  • You can use dynamic placeholders to provide tweet context to the AI

Automation Limits

• Maximum of 5 automations per community
• You can toggle automations active/inactive without deleting them
• Inactive automations won't trigger
• Each automation tracks the number of quests it has created

Placeholders

When configuring Twitter automations, you can use dynamic placeholders in your quest template to automatically include information from the triggering tweet. These placeholders are replaced with actual tweet data when a quest is created.

Available Placeholders

• {{tweet_url}} - The full URL to the tweet (e.g., https://twitter.com/zealy_io/status/123456789)
• {{tweet_author}} - The Twitter username of the tweet author (e.g., @zealy_io)
• {{tweet_text}} - The full text content of the tweet (note: truncated to 100 characters when used in quest titles)
• {{tweet_date}} - The date the tweet was created in YYYY-MM-DD format (e.g., 2025-01-15)

Where to Use Placeholders

Placeholders can be used in:

• Quest Title - Add dynamic context to quest names
• Quest Description - Include tweet details in the quest description
• AI Review Prompt - Provide tweet context to AI reviewers

Example Usage

Title Example:

Engage with our latest tweet {{tweet_date}}

Description Example:

Help us boost this tweet from {{tweet_date}}: {{tweet_text}}

Tweet URL: {{tweet_url}}

AI Prompt Example:

Review if the user's reply to this tweet is relevant and adds value to the conversation.

Original tweet: "{{tweet_text}}" by {{tweet_author}}

Quest Features

Twitter automations create full quests with all standard quest features. For detailed information on quest-specific settings, refer to these documentation pages:

• Rewards - Configure XP, roles, tokens, zaps, and other rewards
• Reward Methods - Distribute rewards using methods like "Top" (performance-based for tweet engagement)
• Conditions - Add requirements like follower count, level, or role
• Claim Limit - Limit how many users can claim the quest
• AI Review - Configure AI-powered submission review
• Cooldown - Set retry periods between attempts

Example: Multi-Step Tweet Engagement Campaign

This example demonstrates how to create a coordinated engagement campaign using three automations that work together to maximize quality interactions with your tweets over time.

The Strategy

When you post a tweet, you want to:

1. Immediate engagement - Get high-quality replies from your community
2. Build momentum - Generate likes after initial discussion starts
3. Amplify reach - Get retweets the next day when conversation has matured

Automation 1: High-Quality Reply Quest (Immediate)

This automation creates a reply quest immediately when you tweet, using AI review to ensure quality content.

Configuration:

• Name: "Quality Reply - Immediate"
• Include Retweets: No
• Include Replies: No (only original tweets)
• Keywords: (optional, e.g., "announcement", "alpha")

Quest Template:

• Title: Share your thoughts on {{tweet_author}}'s post
• Description:

  Reply to this tweet with your thoughtful perspective: {{tweet_url}}
  
  Original tweet: {{tweet_text}}
  

• Task Type: Reply to the tweet
• AI Review: Enabled
• AI Prompt:

  Review if the user's reply is thoughtful and adds value to the discussion.
  
  Original tweet content:
  `
  {{tweet_text}}
  `
  
  The reply should be relevant, constructive, and demonstrate understanding of the original tweet.
  Reject generic responses like "Great post!" or "Agree!"
  

• Delay Hours: 0 (immediate)
• Archive After Hours: (leave empty)

Automation 2: Like Quest (1 Hour Later)

This automation creates a like quest after the initial discussion has started, encouraging broader engagement.

Configuration:

• Name: "Like - 1 Hour Delay"
• Include Retweets: No
• Include Replies: No

Quest Template:

• Title: Like our tweet from {{tweet_author}}
• Description:

  Show your support by liking this tweet: {{tweet_url}}
  

• Task Type: Like the tweet
• Delay Hours: 1
• Archive After Hours: 24

Why 1 hour delay? This gives time for quality replies to accumulate, making the tweet more engaging before asking for likes.

Automation 3: Retweet Quest (Next Day)

For maximum reach, create a retweet quest the day after posting when the conversation has matured.

Strategy: Since you can't set a 24-hour delay directly, use this approach:

1. Set Archive After Hours: 24 on Automation 2
2. Create a third automation with Delay Hours: 24

Configuration:

• Name: "Retweet - Next Day"
• Include Retweets: No
• Include Replies: No

Quest Template:

• Title: Amplify: Retweet from {{tweet_date}}
• Description:

  Help spread the word by retweeting this post: {{tweet_url}}
  
  {{tweet_text}}
  

• Task Type: Retweet the tweet
• Delay Hours: 24
• Archive After Hours: 48

Timeline Visualization

Tweet Posted (Time 0)
│
├─ [Immediate] Reply Quest appears (with AI review)
│
├─ [1 hour] Like Quest appears
│   └─ [24 hours] Like Quest archives
│
└─ [24 hours] Retweet Quest appears
    └─ [48 hours] Retweet Quest archives

Benefits of This Approach

1. Quality First: AI-reviewed replies ensure meaningful engagement before asking for simple likes
2. Progressive Engagement: Build momentum gradually (discuss → support → amplify)
3. Time-Optimized: Each quest appears when it's most likely to get authentic engagement
4. Automatic Cleanup: Archive settings prevent stale quests from cluttering your community
5. Reusable: Once set up, these automations work for every relevant tweet automatically

Tips for Success

• Adjust timing based on your community's timezone and activity patterns
• Monitor performance using the quest creation counter on each automation
• Combine with rewards to incentivize participation (XP, roles, or tokens)

FAQ