Criar uma publicação nas redes sociais

Cria uma publicação para uma marca em uma ou mais de suas contas conectadas nas redes sociais. A mesma chamada abrange os três ciclos de vida: salvar um DRAFT, colocar um SCHEDULE na fila ou PUBLISH imediatamente.

Caso de uso: agendar uma campanha a partir do seu próprio calendário. Seu aplicativo já sabe o que um cliente quer dizer e quando. Para cada horário, chame este endpoint com action: "SCHEDULE" e com scheduledAt ou scheduleDate + scheduleTime e passe seu próprio identificador de horário como clientReference para que você possa fazer a conciliação sem armazenar o UUID retornado. Exiba a entrada como pendente até que GET /social/posts/{postId} informe que a publicação está disponível em todos os canais e ofereça um botão de cancelamento vinculado a POST /social/posts/cancel.

A publicação é assíncrona

action: "PUBLISH" não publica antes de responder. A chamada aceita a publicação, retorna um socialPostId e a encaminha para o fluxo de publicação. Para descobrir o que realmente aconteceu, consulte GET /social/posts/{postId} periodicamente e leia o array channels[] por canal: o status de cada entrada é o resultado daquela plataforma específica. Uma publicação pode ter sucesso no Instagram e falhar no LinkedIn na mesma solicitação, portanto, channels[] é a fonte de verdade e o status no nível da publicação é um resumo.

Escolher um agendamento

action: "SCHEDULE" exige exatamente uma de duas formas, nunca ambas:

Enviar ambas as formas, enviar scheduleDate sem scheduleTime ou enviar um scheduledAt sem deslocamento de fuso horário resulta em rejeição com SY95046. DRAFT e PUBLISH não devem conter nenhum agendamento.

Observações.

• O corpo da solicitação deve estar encapsulado em um objeto input.
• Verifique success, não o status HTTP. Falhas de validação são retornadas como HTTP 200 com success: false e uma entrada no array error para cada problema. Nada é criado quando success é false.
• A marca é identificada no corpo como socialProfileId. brandId é sempre apenas um token no caminho da URL, nunca um campo do corpo.
• Toda plataforma em platforms já deve ter uma conexão na marca. Uma plataforma sem um canal ativo falha com SY95045; consulte primeiro as conexões da marca e encaminhe o usuário a um link de conexão para qualquer conexão ausente.
• Os valores de plataforma são os nomes de enum em letras maiúsculas FACEBOOK, INSTAGRAM, TWITTER, LINKEDIN, PINTEREST. TWITTER é o X; o valor manteve seu nome antigo, e um valor em letras minúsculas é rejeitado.
• O Instagram e o Pinterest não aceitam publicações contendo apenas texto: forneça pelo menos uma entrada em mediaUrls quando qualquer um deles estiver em platforms.
• Os IDs de publicações são UUIDs simples, não os IDs de relay em Base64 usados pelas publicações de locais.
• Para mais do que algumas publicações de uma só vez, use POST /social/bulk-posts, que aceita a mesma estrutura de linha e valida todo o lote antecipadamente.

Operação de escrita: não executada na conta real. A solicitação e a resposta exibidas são construídas a partir do esquema da API; esta operação publica em contas reais de redes sociais quando executada.