Recupera un post social

Recupera un post tramite il suo UUID, con il contenuto composto, la pianificazione risultante e una voce per ciascun canale di destinazione che descrive ciò che è effettivamente accaduto su quella piattaforma. Questo è l'endpoint da interrogare periodicamente dopo aver creato un post.

Caso d'uso: verifica dopo la pubblicazione. La pubblicazione è asincrona, quindi POST /social/posts ti indica soltanto che il post è stato accettato. Interroga periodicamente questo endpoint con il valore socialPostId restituito e leggi connectedChannels[]: status: "SUCCESS" con un valore liveLink indica che il post è pubblicato su quel canale, mentre status: "ERROR" con error impostato indica che non lo è e ne spiega il motivo. Smetti di interrogare l'endpoint quando nessun canale è ancora nello stato SCHEDULED.

Caso d'uso: mostrare al cliente dove è stato pubblicato il suo post. Visualizza ogni connectedChannels[].liveLink come link esterno, in modo che l'utente possa aprire il post pubblicato direttamente sulla piattaforma, e mostra error accanto ai canali per cui la pubblicazione non è riuscita, invece di ridurre l'intero post a un unico stato di errore.

Interpretare i campi di stato

Esistono due livelli di stato che rispondono a domande diverse.

Un post può avere lo stato complessivo PUBLISHED mentre un canale si trova nello stato ERROR. Basa sempre la visualizzazione su connectedChannels[]; il campo status a livello di post è un riepilogo.

Note.

• globalPostSchedule è l'istante di pubblicazione risultante in UTC. Se hai pianificato la pubblicazione con scheduleDate + scheduleTime, questo è l'istante ottenuto applicando a quei valori il fuso orario del brand: un controllo utile per verificare che il fuso orario fosse quello previsto.
• error è un messaggio leggibile che puoi mostrare senza rischi a un cliente; reason è l'etichetta interna più breve a esso associata. Nessuno dei due contiene token della piattaforma o ID di tracciamento.
• connectedChannels[].id è l'UUID della connessione presente tra le connessioni del brand ed è il valore che insights richiede come socialConnectedChannelId.
• Un canale con stato archived: true è stato disconnesso dopo la creazione del post. Il post non verrà pubblicato su quel canale; vedi disconnect.
• Un canale bloccato nello stato ERROR dopo la scadenza di un'autorizzazione richiede un nuovo link di connessione, non un nuovo tentativo di pubblicazione del post.
• Per ottenere i dati sul coinvolgimento anziché lo stato di pubblicazione, chiama GET /social/posts/{postId}/insights.
• Per elencare i post di un brand anziché recuperarne uno, usa GET /social/brands/{brandId}/posts.