Anunciar issues concluídas do Linear
A integração com o Linear transforma o que você entrega em posts nas redes sociais. Você conecta sua conta do Linear e adiciona regras de anúncio. Cada regra acompanha um time do Linear. Quando uma issue desse time é concluída, o AdaptlyPost escreve um post sobre ela para as contas que você escolheu e salva como rascunho ou agenda.
Requisitos
- Um workspace do AdaptlyPost com um plano que inclua publicação.
- Pelo menos uma conta conectada do Facebook, Threads, X, Bluesky, LinkedIn, Mastodon, Telegram ou Google Business Profile. As regras publicam só texto, então plataformas que exigem imagem ou vídeo, como Instagram, TikTok, YouTube e Pinterest, não aparecem.
- Uma conta do Linear que veja o time que você quer anunciar. Qualquer membro do Linear pode se conectar. Você não precisa ser administrador do Linear.
- Uma função no workspace que permita o que a regra faz. Veja Quem pode fazer o quê mais abaixo.
Conectar o Linear
- No AdaptlyPost, abra Integrações e escolha a aba Linear.
- Clique em Conectar Linear.
- O AdaptlyPost leva você ao Linear. Escolha seu workspace do Linear e aprove o acesso. O AdaptlyPost pede só acesso de leitura, para listar seus times e etiquetas e ler as issues que você conclui. Ele nunca altera nada no Linear.
- De volta ao AdaptlyPost, o cartão mostra com qual nome do Linear você está conectado.
A conexão é sua, não do workspace. Ela vale em todos os workspaces do AdaptlyPost de que você é membro, e cada membro que adiciona ou edita uma regra conecta a própria conta do Linear.
Adicionar uma regra de anúncio
Na aba Linear, clique em Adicionar regra e preencha o formulário.
- Time do Linear. Escolha o time cujas issues concluídas devem ser anunciadas. Em Etiqueta, deixe Qualquer etiqueta ou escolha uma para anunciar só as issues que a tiverem.
- Contas. Escolha até 20 contas que recebem cada anúncio.
- Quando uma issue é concluída. Escolha Criar um rascunho para alguém revisar e publicar, ou Agendar para publicar depois de um atraso. O atraso vai de 5 minutos a 7 dias, contados a partir da conclusão da issue.
- Conteúdo do post. Escolha Modelo para escrever o texto você mesmo, ou Texto com IA para a IA escrever a partir da issue.
- Clique em Adicionar regra.
Um workspace pode ter até 20 regras.
Variáveis do modelo
Um modelo é o seu próprio texto, com até 2.000 caracteres. Digite { no modelo, ou clique em uma opção em Inserir:, para adicionar uma variável. O AdaptlyPost preenche com os dados da issue.
| Variável | Substituída por |
|---|---|
{title} | o título da issue |
{description} | a descrição da issue, sem formatação Markdown e encurtada para cada plataforma |
{identifier} | o ID da issue, como ENG-123 |
{team} | o nome do time do Linear |
{label} | a etiqueta que a regra acompanha. Fica vazia quando a regra não tem etiqueta |
Uma regra nova começa com este modelo:
{title}
{description}Textos com IA
Com Texto com IA, o AdaptlyPost escreve um texto para cada plataforma a partir do título e da descrição da issue. Em Instruções para a IA (opcional) você pode adicionar até 1.000 caracteres de orientação, como "Tom amigável, explique o que mudou para os usuários, sem hashtags".
Os textos com IA usam 1 crédito de IA por plataforma para cada issue concluída. Os créditos saem do membro dono da regra.
O que acontece quando uma issue é concluída
Quando uma issue do time da regra passa para um estado concluído no Linear, e tem a etiqueta da regra, se houver uma, o AdaptlyPost:
- Escreve o post a partir do modelo ou com IA.
- Cria o post para as contas da regra, como rascunho ou agendado depois do atraso.
- Mostra a issue em Issues recentes da regra, com um link para o post.
Cada issue é anunciada uma única vez por regra. Reabrir uma issue e concluí-la de novo não cria um segundo post, e editar uma issue já concluída não faz nada. Issues concluídas antes de você criar a regra não são anunciadas. As canceladas também não.
O post passa pelas mesmas verificações de um post que você cria no AdaptlyPost. Se uma verificação falhar, a issue aparece como Falhou em Issues recentes, com o motivo.
Gerenciar as regras
Cada cartão de regra mostra o time, a etiqueta, as contas, o modo de publicação, o tipo de texto e quando a regra criou o último post. No menu do cartão você pode:
- Editar a regra
- Pausar, para que as issues concluídas sejam ignoradas até você retomar
- Retomar uma regra pausada
- Excluir a regra. Os posts que ela já criou continuam lá.
Clique em Issues recentes para ver as últimas issues que a regra tratou. Cada uma tem um status: Publicando, Rascunho criado, Agendado, Ignorada ou Falhou, e Abrir post leva você ao post.
De quem é a regra
Uma regra roda em nome do membro que a adicionou, editou ou retomou por último. O AdaptlyPost lê o Linear pela conexão desse membro, cria os posts com as permissões dele e debita dele os créditos de IA. Editar ou retomar a regra de outra pessoa torna você o dono, e para isso você precisa da sua própria conexão com o Linear com acesso ao time.
Quem pode fazer o quê
| Ação | Funções |
|---|---|
| Ver as regras e as issues recentes delas | Todas as funções |
| Adicionar uma regra que cria rascunhos, ou editar as suas | Admin, Editor, Contributor |
| Adicionar ou editar uma regra que agenda posts | Admin, Editor |
| Usar textos com IA | Admin, Editor, Contributor |
| Editar, pausar, retomar ou excluir a regra de outro membro | Admin, Editor |
Veja Papéis e permissões para a lista completa.
Desconectar o Linear
Na aba Linear, clique em Desconectar no cartão do Linear. O AdaptlyPost revoga o acesso e apaga a conexão. Nada muda no Linear. As regras que usam a sua conexão ficam pausadas até você conectar o Linear de novo e retomá-las.
Solução de problemas
Uma regra pausada mostra o motivo:
- A conexão do dono com o Linear foi removida ou expirou. O dono conecta o Linear de novo na aba Linear e aprova o acesso no Linear. Depois, retome a regra.
- O dono não pode mais publicar neste workspace. Edite ou retome a regra para assumi-la.
- O plano do workspace não inclui publicação. Renove o plano e retome a regra.
- Nenhuma das contas dela está mais conectada. Edite a regra e escolha contas.
- Três anúncios com falha seguidos. Abra Issues recentes, leia o erro dos itens com falha, corrija a causa e retome a regra.
Nenhum time aparece ao adicionar uma regra. A conta do Linear que você conectou não faz parte de nenhum time. Peça a um administrador do Linear para adicioná-la a um time, ou desconecte e conecte outra conta.
Uma conta não aparece na lista. As regras só publicam no Facebook, Threads, X, Bluesky, LinkedIn, Mastodon, Telegram e Google Business Profile. Contas de outras plataformas não aparecem.
Uma issue concluída não foi anunciada. Confira se a regra está Ativa, se a issue é do time da regra e tem a etiqueta dela, e se foi concluída depois de você criar a regra.
Para qualquer outra dúvida, escreva para contact@adaptlypost.com com o nome do seu workspace e o time da regra.