Crea un post sui social

Crea un post per un brand su uno o più dei suoi account social collegati. La stessa chiamata copre tutti e tre i cicli di vita: salvare un DRAFT, mettere in coda un SCHEDULE o PUBLISH immediatamente.

Caso d'uso: programmare una campagna dal tuo calendario. La tua app sa già cosa vuole comunicare un cliente e quando. Per ogni fascia oraria, chiama questo endpoint con action: "SCHEDULE" e con scheduledAt oppure scheduleDate + scheduleTime, e passa il tuo identificatore della fascia oraria come clientReference, così puoi effettuare la riconciliazione senza memorizzare l'UUID restituito. Mostra la voce come in attesa finché GET /social/posts/{postId} non segnala che il post è pubblicato su ogni canale e offri un pulsante di annullamento collegato a POST /social/posts/cancel.

La pubblicazione è asincrona

action: "PUBLISH" non pubblica prima di rispondere. La chiamata accetta il post, restituisce un socialPostId e lo passa alla pipeline di pubblicazione. Per sapere cosa è effettivamente successo, interroga periodicamente GET /social/posts/{postId} e leggi l'array channels[] con i risultati per canale: il valore status di ogni voce è l'esito per quella singola piattaforma. Nella stessa richiesta, un post può essere pubblicato correttamente su Instagram e non essere pubblicato su LinkedIn, quindi channels[] è la fonte attendibile e status a livello di post è un riepilogo.

Scegliere una programmazione

action: "SCHEDULE" richiede esattamente una delle due forme, mai entrambe:

L'invio di entrambe le forme, di scheduleDate senza scheduleTime o di un scheduledAt senza offset viene rifiutato con SY95046. DRAFT e PUBLISH non devono includere alcuna programmazione.

Note.

• Il corpo della richiesta deve essere racchiuso in un oggetto input.
• Controlla success, non lo stato HTTP. Gli errori di validazione vengono restituiti come HTTP 200 con success: false e una voce nell'array error per ogni problema. Non viene creato nulla quando success è false.
• Il brand è identificato nel corpo come socialProfileId. brandId è sempre e solo un token nel percorso dell'URL, mai un campo del corpo.
• Ogni piattaforma in platforms deve già avere una connessione sul brand. Per una piattaforma senza un canale attivo, l'operazione fallisce con SY95045; leggi prima le connessioni del brand e indirizza l'utente a un link di connessione per ogni connessione mancante.
• I valori delle piattaforme sono i nomi dell'enum in maiuscolo FACEBOOK, INSTAGRAM, TWITTER, LINKEDIN, PINTEREST. TWITTER corrisponde a X; il valore ha mantenuto il vecchio nome e un valore in minuscolo viene rifiutato.
• Instagram e Pinterest non accettano post di solo testo: fornisci almeno una voce mediaUrls quando una delle due piattaforme è presente in platforms.
• Gli ID dei post sono semplici UUID, non gli ID relay in Base64 usati dai post delle sedi.
• Per inviare più di qualche post in una sola volta, usa POST /social/bulk-posts, che accetta la stessa struttura delle righe e convalida l'intero lotto prima di elaborarlo.

Operazione di scrittura: non eseguita sull'account reale. La richiesta e la risposta mostrate sono costruite a partire dallo schema dell'API; quando viene eseguita, questa operazione pubblica su account social reali.