Dal brief del cliente ai post pubblicati: una settimana gestita da un agente, chiamata per chiamata
Un esempio completo di una settimana di un cliente in Shager: brief, media, bozze per account, revisione, approvazione, programmazione, verifiche e report.
Per passare dal brief di un cliente ai post pubblicati con un agente servono otto fasi: verificare l'accesso e l'area di lavoro, controllare gli account collegati, caricare i file multimediali, pianificare, scrivere le bozze con un testo per ogni account, rivedere, ottenere l'approvazione del cliente, infine programmare e verificare. In ogni fase il lavoro di volume lo fa l'agente. Una persona prende tre decisioni: approva il piano, concede il diritto di pubblicare e, se il cliente lo desidera, raccoglie il via libera del cliente stesso tramite un link di approvazione.
Ecco una settimana realistica per un cliente immaginario, con tutte le chiamate a Shager che l'agente esegue, nell'ordine. Il cliente, Harbor Coffee, ha 14 caffetterie, ognuna con una Pagina Facebook e un account professionale Instagram, più un canale YouTube del marchio.
Lunedì mattina: arriva il brief
L'account manager lascia un brief nella cartella di contesto del cliente: una nuova bevanda autunnale, il lancio giovedì, uno sconto del 20% per il primo weekend, un video verticale di 25 secondi e due foto ospitate sulla CDN del cliente. Nient'altro. Le istruzioni permanenti dell'agente gli vietano di inventare qualsiasi cosa che il brief non dica, quindi lo sconto, la data e il nome del prodotto sono gli unici fatti che userà.
La sessione parte dalla cartella del cliente, così l'agente ha caricato le regole dell'agenzia e il file sul tono di voce di Harbor Coffee, e nulla sugli altri clienti. Il perché è spiegato in un agente, tanti clienti.
Fase 1: chi sono e dove lavoro
whoami -> organization, claimed or sandbox, key scopes
list_workspaces -> "Harbor Coffee" (ws_harbor), timezone Europe/London
whoami risponde a due domande prima di qualsiasi lavoro: l'organizzazione è stata rivendicata? La chiave ha publish? Se si tratta di un ambiente di prova non rivendicato, l'agente può comunque caricare file e scrivere bozze, ma la programmazione e le richieste di approvazione falliranno con un errore chiaro finché una persona non lo rivendica. La procedura di rivendicazione è descritta in /auth.md.
Fase 2: controllare gli account
list_channels ws_harbor -> 29 channels: 14 Facebook, 14 Instagram, 1 YouTube
list_groups ws_harbor -> "All cafes FB", "All cafes IG", "Brand YouTube"
L'agente guarda lo stato di ogni canale. Un account Instagram risulta scollegato. Invece di aggirarlo in silenzio, l'agente crea un link di collegamento per il responsabile di quella caffetteria:
{
"tool": "create_connect_link",
"arguments": { "workspace_id": "ws_harbor", "label": "Harbor Quayside, Instagram reconnect" }
}
L'account manager inoltra il link. Il responsabile della caffetteria accede a Instagram tramite il link, senza un account Shager, e in giornata l'account torna a comparire in list_channels.
Fase 3: caricare i file multimediali
Tre chiamate, una per ogni file. Il video porta con sé dimensioni e durata, così la verifica per Reel e Shorts può avvenire subito invece che al momento della pubblicazione.
{
"tool": "upload_media_from_url",
"arguments": {
"workspace_id": "ws_harbor",
"url": "https://cdn.harbor-coffee.example/autumn/launch.mp4",
"file_name": "autumn-launch.mp4",
"width": 1080, "height": 1920, "duration_ms": 25000
}
}
Le due foto vengono caricate allo stesso modo, senza i campi del video.
Fase 4: pianificare, poi aspettare
Invece di mettersi subito a scrivere, l'agente propone un piano:
| Giorno | Post | Formato | Destinazione |
|---|---|---|---|
| Mar | Foto teaser | FEED | All cafes FB, All cafes IG |
| Gio | Video di lancio | REEL / SHORT | All cafes FB, All cafes IG, Brand YouTube |
| Sab | Foto promemoria dello sconto | FEED | All cafes FB, All cafes IG |
L'account manager risponde «vai» e sposta il post del sabato al venerdì pomeriggio. Un solo messaggio, e un piano debole non si trasforma mai in 85 testi da scrivere account per account.
Fase 5: bozze con un testo per ogni account
Ogni post pianificato diventa una chiamata create_post senza schedule_at, che salva una bozza. Il post di lancio mostra la struttura completa:
{
"tool": "create_post",
"arguments": {
"workspace_id": "ws_harbor",
"group_ids": ["grp_all_fb", "grp_all_ig", "grp_brand_yt"],
"media_ids": ["med_launch"],
"caption": "The autumn drink is here. 20% off this weekend.",
"youtube_title": "Harbor Coffee autumn drink, first pour",
"youtube_privacy": "public",
"cta_url": "https://harbor-coffee.example/autumn",
"campaign": "autumn-launch",
"label": "Harbor autumn launch video",
"first_comment": "Find your nearest Harbor and the weekend offer: https://harbor-coffee.example/autumn",
"per_channel": [
{ "channel_id": "ch_fb_quayside", "format": "REEL",
"caption": "Quayside regulars, it's here. Autumn's first pour, 20% off this weekend." },
{ "channel_id": "ch_ig_quayside", "format": "REEL",
"caption": "First pour at Quayside. 20% off all weekend, details in bio." },
{ "channel_id": "ch_yt_brand", "format": "SHORT",
"caption": "The new Harbor autumn drink, poured for the first time." }
]
}
}
Nella chiamata reale per_channel ha 29 voci, ognuna con un testo ancorato a quella caffetteria. Al momento della pubblicazione ogni URL nei testi e nei commenti diventa un link breve unico per quell'account, con utm_content che identifica l'account, quindi l'agente scrive URL normali. L'arte di variare i testi è spiegata in variare i testi per ogni account con l'IA.
Fase 6: revisione in un passaggio separato
Una seconda sessione, con un prompt da revisore e tool in sola lettura, chiama list_posts con status impostato su DRAFT e get_post su ciascun post. Cerca testi duplicati, fatti che non sono nel brief, link messi dove non saranno cliccabili e formati video applicati a file non verticali. Questa volta segnala due testi Instagram che dicono «link qui sotto» quando il link è in bio. L'agente di scrittura li corregge creando nuove bozze corrette, e quelle vecchie restano fuori dalla programmazione.
Fase 7: approvazione del cliente
Nell'area di lavoro di Harbor Coffee è impostato approval_required, quindi non si può programmare nulla finché il cliente non approva. L'agente invia ogni bozza per l'approvazione:
{
"tool": "request_approval",
"arguments": {
"workspace_id": "ws_harbor",
"post_id": "pst_launch",
"reviewer_name": "Dana, Harbor Coffee marketing",
"reviewer_email": "dana@harbor-coffee.example",
"send_email": true
}
}
Il cliente apre il link, controlla il post e lo approva senza dover accedere. Lo stato del post passa da IN_REVIEW ad APPROVED, oppure a CHANGES_REQUESTED: in quel caso l'agente lo rivede e lo invia di nuovo. Come impostare buone regole di approvazione è spiegato in approvazione umana per i post degli agenti.
Fase 8: programmare e verificare
Una volta arrivata l'approvazione, la programmazione avviene con una chiave che ha l'ambito publish. L'agente calcola ogni orario nel fuso dell'area di lavoro, con lo scostamento valido in quella data:
{
"tool": "schedule_post",
"arguments": {
"workspace_id": "ws_harbor",
"post_id": "pst_launch",
"schedule_at": "2026-10-15T08:30:00+01:00"
}
}
Con 14 account sia su Facebook sia su Instagram e l'intervallo predefinito tra un invio e l'altro di 30-90 secondi, la tornata di ogni social dura circa 13 minuti, e i due social procedono in parallelo. Giovedì alle 9:15 l'agente chiama get_post. Ventotto account risultano pubblicati, con gli URL attivi. Uno mostra un errore di permessi. L'agente segnala l'account per nome e suggerisce un nuovo link di collegamento; non riprova alla cieca.
Il lunedì successivo: il report
La settimana si chiude con il report: list_posts per ciò che è uscito, get_post per gli esiti account per account e get_analytics per i clic per account e per post nell'arco della settimana, incrociati con i contatti del CRM su utm_content quando il cliente li condivide. La configurazione completa, compresa l'esecuzione senza supervisione, è in il report settimanale per il cliente preparato dall'agente.
Chi ha fatto cosa
| Fase | Agente | Persona |
|---|---|---|
| Accesso e area di lavoro | Verifica e riferisce | |
| Account | Trova quello scollegato, crea il link | Inoltra il link |
| File e piano | Carica, propone | Dice «vai» |
| Bozze e revisione | Scrive 85 testi, li rivede | |
| Approvazione | Invia i link | Il cliente approva |
| Programmazione | Calcola gli orari, programma | Concede publish una volta |
| Consegna e report | Verifica, riferisce | Legge il report |
Domande frequenti
Quanto tempo richiede a una persona una settimana del genere?
In questo esempio le decisioni umane si riducono a qualche messaggio e un'approvazione. Il tempo esatto dipende dal cliente e da quanto avanti e indietro serve sul piano. Quello che cambia è il tipo di lavoro: rivedere e decidere, invece di scrivere testi e costruire link.
L'agente può saltare l'approvazione del cliente per i post di routine?
Solo se l'area di lavoro non la richiede. approval_required si imposta per area di lavoro: un cliente che approva un piano mensile può tenerla disattivata, mentre un cliente prudente la lascia attiva. L'agente non può cambiare da solo questa impostazione per un'area di lavoro esistente.
E se il cliente chiede modifiche dopo l'approvazione?
Se la pubblicazione del post non è ancora iniziata, l'agente chiama cancel_post, che lo riporta a bozza approvata, poi crea una versione corretta e la rimanda in approvazione. Se la pubblicazione è già partita, le modifiche sui social vanno fatte a mano.
Da dove partire
Prova questa sequenza su un cliente con un piccolo gruppo di account prima di estenderla a tutto. Se il tuo agente non è ancora collegato, la pagina dedicata agli agenti spiega il server MCP, l'API REST e la registrazione autonoma.
