Twitter

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

Visão geral

A integração com o Twitter permite criar tarefas no Twitter, configurar a criação automática de quests com base nos teus tweets e autenticar a tua conta. Com as automações do Twitter, podes gerar quests automaticamente sempre que publicas um tweet, simplificando o fluxo de envolvimento da tua comunidade.

Noções básicas

Configuração

Os administradores da comunidade podem adicionar integrações através do seguinte caminho: Definições > Comunidade > Integrações > Twitter. Depois de ligada, qualquer editor ou administrador pode adicionar tarefas do Twitter e configurar automações. Aparecerá uma ligação à tua conta do Twitter na página de destino e nas informações da tua comunidade.

Automações do Twitter

As automações do Twitter permitem criar quests automaticamente quando publicas tweets. Esta funcionalidade ajuda-te a manter um envolvimento consistente da comunidade sem criar manualmente quests para cada tweet.

Como funciona

Quando crias uma automação do Twitter, o Zealy monitoriza a tua conta do Twitter ligada em busca de novos tweets. Quando um tweet corresponde aos filtros configurados, o sistema cria automaticamente uma quest com base nas definições do teu modelo.

Configuração da automação

Cada automação requer as seguintes definições:

Definições básicas

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

Configuração do acionador

• Incluir retweets (obrigatório): Se devem ser criadas quests para retweets
• Incluir respostas (obrigatório): Se devem ser criadas quests para tweets de resposta
• Palavras-chave (opcional): Filtrar tweets por palavras-chave específicas - a automação só é acionada quando o tweet contém todos estes termos

Modelo de quest

Ao definir que quest deve ser criada, configuras:

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

Para definições relacionadas com quests, como recompensas, condições e limites de claim, consulta a secção Funcionalidades das quests abaixo.

Definições avançadas

• Atraso em horas (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 utilizadores devem esperar entre tentativas da quest - consulta a documentação sobre cooldown
• Limite de claims (opcional): Número máximo de claims permitidos - consulta a documentação sobre limite de claims
• Adicionar à sprint atual (opcional): Se deve adicionar a quest à sprint atualmente ativa (predefinição: true)

Revisão por IA (opcional)

• Ativar revisão por IA: Rever automaticamente as submissões de quests com IA
• Prompt de IA: Prompt personalizado para orientar a revisão por IA - consulta a documentação sobre revisão por IA
  • Podes usar placeholders dinâmicos para fornecer contexto do tweet à IA

Limites das automações

• Máximo de 5 automações por comunidade
• Podes ativar/desativar automações sem as eliminar
• As automações inativas não são acionadas
• Cada automação registra o número de quests que criou

Placeholders

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

Placeholders disponíveis

• {{tweet_url}} - O URL completo do tweet (por exemplo, https://twitter.com/zealy_io/status/123456789)
• {{tweet_author}} - O nome de utilizador do Twitter do autor do tweet (por exemplo, @zealy_io)
• {{tweet_text}} - O conteúdo de texto completo do tweet (nota: truncado a 100 caracteres quando usado em títulos de quests)
• {{tweet_date}} - A data em que o tweet foi criado no formato YYYY-MM-DD (por exemplo, 2025-01-15)

Onde usar placeholders

Os placeholders podem ser usados em:

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

Exemplo de utilização

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}}

Funcionalidades das quests

As automações do Twitter criam quests completas com todas as funcionalidades padrão das quests. Para informações detalhadas sobre definições específicas das quests, consulta estas páginas de documentação:

• Recompensas - Configurar XP, cargos, tokens, zaps e outras recompensas
• Métodos de recompensa - Distribuir recompensas usando métodos como "Top" (baseado no desempenho para o envolvimento com tweets)
• Condições - Adicionar requisitos como número de seguidores, nível ou cargo
• Limite de claims - Limitar quantos utilizadores podem fazer claim da quest
• Revisão por IA - Configurar a revisão de submissões com IA
• Cooldown - Definir períodos de repetição entre tentativas

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

Este exemplo demonstra como criar uma campanha de envolvimento coordenada usando três automações que funcionam em conjunto para maximizar interações de qualidade com os teus tweets ao longo do tempo.

A estratégia

Quando publicas um tweet, queres:

1. Envolvimento imediato - Obter respostas de alta qualidade da tua comunidade
2. Criar impulso - Gerar gostos depois de começar a 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 publicas um tweet, usando a 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 (apenas tweets originais)
• Palavras-chave: (opcional, por exemplo, "anúncio", "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: (deixar vazio)

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

Esta automação cria uma quest de gosto depois de a discussão inicial ter começado, incentivando um envolvimento mais amplo.

Configuração:

• Nome: "Gosto - 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: Gostar do tweet
• Horas de Atraso: 1
• Arquivar Após Horas: 24

Porquê um atraso de 1 hora? Isto dá tempo para se acumularem respostas de qualidade, tornando o tweet mais envolvente antes de pedir gostos.

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

Para alcance máximo, cria uma quest de retweet no dia seguinte à publicação, quando a conversa já amadureceu.

Estratégia: Como não podes definir um atraso de 24 horas diretamente, usa esta abordagem:

1. Define Arquivar Após Horas: 24 na Automação 2
2. Cria 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 Cronologia

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

Vantagens desta Abordagem

1. Qualidade Primeiro: As respostas revistas por IA garantem um envolvimento significativo antes de pedir gostos simples
2. Envolvimento Progressivo: Cria impulso gradualmente (discutir → apoiar → amplificar)
3. Otimizado no Tempo: Cada quest aparece quando é mais provável obter envolvimento autêntico
4. Limpeza Automática: As definições de arquivo evitam que quests antigas sobrecarreguem a tua comunidade
5. Reutilizável: Uma vez configuradas, estas automações funcionam automaticamente para cada tweet relevante

Dicas para o Sucesso

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

FAQ