Twitter

A integração do Zealy com o X (Twitter) abrange tarefas baseadas em tweets e automações, limitadas a cinco por comunidade. Uma automação monitora a conta conectada e cria uma quest sempre que um novo tweet corresponde aos filtros definidos para palavras-chave, retweets e respostas. O modelo de quest inclui título, tipo de tarefa, timing e revisão por IA opcional.

Visão geral

A integração com o Twitter permite criar tarefas no Twitter, configurar a criação automatizada de quests com base nos seus tweets e autenticar sua conta. Com as automações do Twitter, você pode gerar quests automaticamente sempre que publicar um tweet, otimizando o fluxo de engajamento da sua comunidade.

Noções básicas

Configuração

Administradores da comunidade podem adicionar integrações pelo seguinte caminho: Configurações > Comunidade > Integrações > Twitter. Depois de conectada, qualquer editor ou administrador pode adicionar tarefas do Twitter e configurar automações. Um link para sua conta do Twitter aparecerá na landing page e nas informações da sua comunidade.

Automações do Twitter

As automações do Twitter permitem criar quests automaticamente quando você publica tweets. Esse recurso ajuda a manter um engajamento consistente da comunidade sem criar quests manualmente para cada tweet.

Como funciona

Quando você cria uma automação do Twitter, o Zealy monitora sua conta conectada do Twitter em busca de novos tweets. Quando um tweet corresponde aos filtros configurados, o sistema cria automaticamente uma quest com base nas configurações do seu modelo.

Configuração da automação

Cada automação exige as seguintes configurações:

Configurações básicas

• Nome (obrigatório): Um nome descritivo para sua automação

Configuração do gatilho

• Incluir retweets (obrigatório): Se deve criar quests em retweets
• Incluir respostas (obrigatório): Se deve criar quests em tweets de resposta
• Palavras-chave (opcional): Filtra tweets por palavras-chave específicas - a automação só é acionada quando o tweet contém todos esses termos

Modelo de quest

Ao definir qual quest deve ser criada, você configura:

• Título (obrigatório): O título da quest (1-200 caracteres)
  • Você pode usar placeholders dinâmicos como {{tweet_author}} ou {{tweet_text}}
• Descrição (opcional): Texto de descrição da quest
  • Você pode usar placeholders dinâmicos como {{tweet_url}} ou {{tweet_date}}
• Sprint/Módulo (obrigatório): A qual sprint ou categoria adicionar a quest
• Tipo de tarefa (obrigatório): Tipo de tarefa do Twitter que os usuários devem concluir
  • Curtir o tweet
  • Retweetar o tweet
  • Responder ao tweet

Para configurações relacionadas à quest, como recompensas, condições e limites de claim, consulte a seção Recursos de quest abaixo.

Configurações avançadas

• Horas de atraso (opcional): Atraso no aparecimento da quest após a publicação do tweet
• Arquivar após horas (opcional): Arquivar automaticamente a quest após o tempo especificado
• Cooldown (opcional): Tempo que os usuários devem esperar entre tentativas de quest - consulte documentação de Cooldown
• Limite de claims (opcional): Número máximo de claims permitidos - consulte documentação de Limite de claims
• Adicionar à sprint atual (opcional): Se deve adicionar a quest à sprint atualmente ativa (padrão: true)

Revisão por IA (opcional)

• Ativar revisão por IA: Revisar automaticamente os envios de quest usando IA
• Prompt de IA: Prompt personalizado para orientar a revisão por IA - consulte documentação de Revisão por IA
  • Você pode usar placeholders dinâmicos para fornecer contexto do tweet à IA

Limites de automação

• Máximo de 5 automações por comunidade
• Você pode ativar/desativar automações sem excluí-las
• Automações inativas não serão acionadas
• Cada automação rastreia o número de quests que criou

Placeholders

Ao configurar automações do Twitter, você pode usar placeholders dinâmicos no modelo de quest para incluir automaticamente informações do tweet que acionou a automação. Esses placeholders são substituídos pelos dados reais do tweet quando uma quest é criada.

Placeholders disponíveis

• {{tweet_url}} - A URL completa do tweet (ex.: https://twitter.com/zealy_io/status/123456789)
• {{tweet_author}} - O nome de usuário do Twitter do autor do tweet (ex.: @zealy_io)
• {{tweet_text}} - O conteúdo de texto completo do tweet (observação: truncado em 100 caracteres quando usado em títulos de quest)
• {{tweet_date}} - A data em que o tweet foi criado no formato YYYY-MM-DD (ex.: 2025-01-15)

Onde usar placeholders

Os placeholders podem ser usados em:

• Título da quest - Adicione contexto dinâmico aos nomes das quests
• Descrição da quest - Inclua detalhes do tweet na descrição da quest
• Prompt de revisão por IA - Forneça contexto do tweet aos revisores de IA

Exemplo de uso

Exemplo de título:

Engage with our latest tweet {{tweet_date}}

Exemplo de descrição:

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

Tweet URL: {{tweet_url}}

Exemplo de prompt de IA:

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

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

Recursos de quest

As automações do Twitter criam quests completas com todos os recursos padrão de quest. Para informações detalhadas sobre configurações específicas de quest, consulte estas páginas de documentação:

• Recompensas - Configure XP, cargos, tokens, zaps e outras recompensas
• Métodos de recompensa - Distribua recompensas usando métodos como "Top" (baseado em desempenho para engajamento em tweets)
• Condições - Adicione requisitos como número de seguidores, nível ou cargo
• Limite de claims - Limite quantos usuários podem fazer claim da quest
• Revisão por IA - Configure a revisão de envios com IA
• Cooldown - Defina períodos de nova tentativa entre tentativas

Exemplo: Campanha de engajamento em tweets com várias etapas

Este exemplo demonstra como criar uma campanha de engajamento coordenada usando três automações que trabalham juntas para maximizar interações de qualidade com seus tweets ao longo do tempo.

A estratégia

Quando você publica um tweet, você quer:

1. Engajamento imediato - Obter respostas de alta qualidade da sua comunidade
2. Criar impulso - Gerar curtidas após o início da discussão inicial
3. Ampliar o alcance - Obter retweets no dia seguinte, quando a conversa já amadureceu

Automação 1: Quest de resposta de alta qualidade (imediata)

Esta automação cria uma quest de resposta imediatamente quando você tweeta, usando revisão por IA para garantir conteúdo de qualidade.

Configuração:

• Nome: "Resposta de qualidade - imediata"
• Incluir retweets: Não
• Incluir respostas: Não (somente tweets originais)
• Palavras-chave: (opcional, ex.: "announcement", "alpha")

Modelo de Quest:

• Título: Share your thoughts on {{tweet_author}}'s post
• Descrição:

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

• Tipo de Tarefa: Responder ao tweet
• Revisão por IA: Ativada
• Prompt de IA:

  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!"
  

• Horas de Atraso: 0 (imediato)
• Arquivar Após Horas: (deixe vazio)

Automação 2: Quest de Curtida (1 Hora Depois)

Esta automação cria uma quest de curtida depois que a discussão inicial começou, incentivando um engajamento mais amplo.

Configuração:

• Nome: "Curtida - Atraso de 1 Hora"
• Incluir Retweets: Não
• Incluir Respostas: Não

Modelo de Quest:

• Título: Like our tweet from {{tweet_author}}
• Descrição:

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

• Tipo de Tarefa: Curtir o tweet
• Horas de Atraso: 1
• Arquivar Após Horas: 24

Por que atraso de 1 hora? Isso dá tempo para que respostas de qualidade se acumulem, tornando o tweet mais envolvente antes de pedir curtidas.

Automação 3: Quest de Retweet (Dia Seguinte)

Para alcance máximo, crie uma quest de retweet no dia seguinte à postagem, quando a conversa já amadureceu.

Estratégia: Como você não pode definir um atraso de 24 horas diretamente, use esta abordagem:

1. Defina Arquivar Após Horas: 24 na Automação 2
2. Crie uma terceira automação com Horas de Atraso: 24

Configuração:

• Nome: "Retweet - Dia Seguinte"
• Incluir Retweets: Não
• Incluir Respostas: Não

Modelo de Quest:

• Título: Amplify: Retweet from {{tweet_date}}
• Descrição:

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

• Tipo de Tarefa: Retweetar o tweet
• Horas de Atraso: 24
• Arquivar Após Horas: 48

Visualização da Linha do Tempo

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

Benefícios Desta Abordagem

1. Qualidade em Primeiro: Respostas revisadas por IA garantem engajamento significativo antes de pedir curtidas simples
2. Engajamento Progressivo: Construa impulso gradualmente (discutir → apoiar → amplificar)
3. Otimizado no Tempo: Cada quest aparece quando é mais provável obter engajamento autêntico
4. Limpeza Automática: As configurações de arquivamento evitam que quests antigas poluam sua comunidade
5. Reutilizável: Uma vez configuradas, essas automações funcionam automaticamente para cada tweet relevante

Dicas para o Sucesso

• Ajuste o tempo com base no fuso horário e nos padrões de atividade da sua comunidade
• Monitore o desempenho usando o contador de criação de quests em cada automação
• Combine com recompensas para incentivar a participação (XP, cargos ou tokens)

Perguntas Frequentes