Integrations

Annunciare le issue completate di Linear

L'integrazione con Linear trasforma quello che rilasci in post per i social. Colleghi il tuo account Linear e aggiungi delle regole di annuncio. Ogni regola osserva un team di Linear. Quando una issue di quel team viene completata, AdaptlyPost scrive un post per gli account che hai scelto e lo salva come bozza o lo programma.

Requisiti

  • Un workspace AdaptlyPost con un piano che include la pubblicazione.
  • Almeno un account collegato tra Facebook, Threads, X, Bluesky, LinkedIn, Mastodon, Telegram e Google Business Profile. Le regole pubblicano solo testo, quindi le piattaforme che richiedono un'immagine o un video, come Instagram, TikTok, YouTube e Pinterest, non sono disponibili.
  • Un account Linear che veda il team da annunciare. Qualsiasi membro di Linear può collegarsi. Non serve essere amministratore di Linear.
  • Un ruolo nel workspace che consenta quello che fa la regola. Vedi Chi può fare cosa più sotto.

Collegare Linear

  1. In AdaptlyPost, apri Integrazioni e scegli la scheda Linear.
  2. Clicca su Collega Linear.
  3. AdaptlyPost ti porta su Linear. Scegli il tuo workspace Linear e approva l'accesso. AdaptlyPost chiede solo l'accesso in lettura, per elencare team ed etichette e leggere le issue che completi. Non modifica mai nulla in Linear.
  4. Tornato in AdaptlyPost, la scheda mostra con quale nome Linear sei collegato.

Il collegamento è tuo, non del workspace. Ti segue in tutti i workspace AdaptlyPost di cui sei membro, e ogni membro che aggiunge o modifica una regola collega il proprio account Linear.

Aggiungere una regola di annuncio

Nella scheda Linear, clicca su Aggiungi regola e compila il modulo.

  1. Team di Linear. Scegli il team le cui issue completate vanno annunciate. In Etichetta, lascia Qualsiasi etichetta o scegline una per annunciare solo le issue che la hanno.
  2. Account. Scegli fino a 20 account che ricevono ogni annuncio.
  3. Quando una issue viene completata. Scegli Crea una bozza perché qualcuno la riveda e la pubblichi, oppure Programmalo per pubblicare dopo un ritardo. Il ritardo va da 5 minuti a 7 giorni, a partire dal momento in cui la issue è stata completata.
  4. Contenuto del post. Scegli Modello per scrivere tu il testo, oppure Didascalia AI perché l'AI lo scriva a partire dalla issue.
  5. Clicca su Aggiungi regola.

Un workspace può avere fino a 20 regole.

Variabili del modello

Un modello è il tuo testo, fino a 2.000 caratteri. Digita { nel modello, oppure clicca su una voce sotto Inserisci:, per aggiungere una variabile. AdaptlyPost la riempie con i dati della issue.

VariabileViene sostituita con
{title}il titolo della issue
{description}la descrizione della issue, senza formattazione Markdown e accorciata per ogni piattaforma
{identifier}l'ID della issue, per esempio ENG-123
{team}il nome del team di Linear
{label}l'etichetta osservata dalla regola. Vuota se la regola non ne ha

Una nuova regola parte con questo modello:

{title}
 
{description}

Didascalie AI

Con Didascalia AI, AdaptlyPost scrive un testo per ogni piattaforma a partire dal titolo e dalla descrizione della issue. In Istruzioni per l'AI (facoltative) puoi aggiungere fino a 1.000 caratteri di indicazioni, per esempio "Tono amichevole, spiega cosa cambia per gli utenti, niente hashtag".

Le didascalie AI usano 1 credito AI per piattaforma per ogni issue completata. I crediti vengono scalati al membro a cui appartiene la regola.

Cosa succede quando una issue viene completata

Quando una issue del team della regola passa a uno stato completato in Linear, e ha l'etichetta della regola se ce n'è una, AdaptlyPost:

  1. scrive il post con il modello o con l'AI;
  2. lo crea per gli account della regola, come bozza o programmato dopo il ritardo;
  3. mostra la issue in Issue recenti della regola, con un link al post.

Ogni issue viene annunciata una sola volta per regola. Riaprire una issue e completarla di nuovo non crea un secondo post, e modificare una issue già chiusa non fa nulla. Le issue completate prima di creare la regola non vengono annunciate. Nemmeno quelle annullate.

Il post passa dagli stessi controlli di un post che crei tu in AdaptlyPost. Se un controllo non va a buon fine, la issue appare come Non riuscito in Issue recenti, con il motivo.

Gestire le regole

Ogni scheda di regola mostra team, etichetta, account, modalità di pubblicazione, tipo di testo e quando ha creato l'ultimo post. Dal menu della scheda puoi:

  • Modifica la regola
  • Metti in pausa, così le issue completate vengono ignorate finché non la riprendi
  • Riprendi una regola in pausa
  • Elimina la regola. I post già creati restano.

Clicca su Issue recenti per vedere le ultime issue gestite dalla regola. Ognuna ha uno stato: In pubblicazione, Bozza creata, Programmato, Saltata o Non riuscito, e Apri il post ti porta al post.

A chi appartiene una regola

Una regola lavora a nome del membro che l'ha aggiunta, modificata o ripresa per ultimo. AdaptlyPost legge Linear con il collegamento di quel membro, crea i post con i suoi permessi e gli addebita i crediti AI. Modificare o riprendere la regola di un altro te la assegna, e richiede un tuo collegamento Linear con accesso al team.

Chi può fare cosa

AzioneRuoli
Vedere le regole e le loro issue recentiTutti i ruoli
Aggiungere una regola che crea bozze, o modificare le proprieAdmin, Editor, Contributor
Aggiungere o modificare una regola che programma i postAdmin, Editor
Usare le didascalie AIAdmin, Editor, Contributor
Modificare, mettere in pausa, riprendere o eliminare la regola di un altro membroAdmin, Editor

Vedi Ruoli e permessi per l'elenco completo.

Scollegare Linear

Nella scheda Linear, clicca su Scollega nella scheda di Linear. AdaptlyPost revoca il suo accesso ed elimina il collegamento. In Linear non cambia nulla. Le regole che usano il tuo collegamento vanno in pausa finché non ricolleghi Linear e le riprendi.

Risoluzione dei problemi

Una regola in pausa mostra il motivo:

  • Il collegamento Linear del proprietario è stato rimosso o è scaduto. Il proprietario ricollega Linear dalla scheda Linear e approva l'accesso in Linear. Poi riprendi la regola.
  • Il proprietario non può più pubblicare in questo workspace. Modifica o riprendi la regola per prenderla in carico.
  • Il piano del workspace non include la pubblicazione. Rinnova il piano e riprendi la regola.
  • Nessuno dei suoi account è ancora collegato. Modifica la regola e scegli degli account.
  • Tre annunci non riusciti di fila. Apri Issue recenti, leggi l'errore delle voci non riuscite, risolvi la causa e riprendi la regola.

Quando aggiungi una regola non compare nessun team. L'account Linear collegato non fa parte di alcun team. Chiedi a un amministratore di Linear di aggiungerlo a un team, oppure scollegalo e collega un altro account.

Un account manca dall'elenco. Le regole pubblicano solo su Facebook, Threads, X, Bluesky, LinkedIn, Mastodon, Telegram e Google Business Profile. Gli account delle altre piattaforme non compaiono.

Una issue completata non è stata annunciata. Controlla che la regola sia Attiva, che la issue sia del team della regola e abbia la sua etichetta, e che sia stata completata dopo la creazione della regola.

Per qualsiasi altra cosa, scrivi a contact@adaptlypost.com con il nome del workspace e il team della regola.