Adicione publicação ao seu produto.

Guia passo a passo

1. 01

   Projete a confirmação do produto antes da chamada de API

   Abra esta área no SosoAPI

   • No app SosoAPI, selecione o Workspace desejado e revise a conta conectada. No protótipo do seu produto, exiba esse mesmo Workspace e essa conta escolhidos pelo usuário em vez de selecioná-los silenciosamente.

   • Mostre legenda exata, conta, horário local e fuso em uma etapa de confirmação. Exija que a pessoa escolha Agendar; abrir o formulário não deve enviar nada.

   O que esperar

   Uma pessoa pode ver destino e horário antes da gravação. O protótipo do produto fictício é um exercício de design, não uma integração instalada em cliente.

2. 02

   Consulte os Scheduled Posts atuais pelo servidor

   • Substitua <workspace-uuid> pelo ID do Workspace selecionado e execute esta requisição somente de leitura no servidor:

   • const apiKey = process.env.SOSOAPI_API_KEY;
     if (!apiKey) throw new Error("Configure a SosoAPI API key on your server");
     const response = await fetch(
       "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/list",
       {
         method: "POST",
         headers: {
           "Authorization": "Bearer " + apiKey,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({"workspace_id":"<workspace-uuid>"})
       }
     );
     const result = await response.json();
     if (!response.ok) throw new Error("SosoAPI request failed: " + response.status);
     // Use result in your server response; never return or log the API key.

   • Use os dados retornados para atualizar a lista do seu produto. Mantenha a confirmação do usuário separada desta consulta.

   O que esperar

   Você recebe os posts atuais do Workspace ou um erro de autorização/validação. Esta requisição somente de leitura não cria posts.

3. 03

   Envie somente após confirmação explícita do usuário

   • Abra o Calendar e escolha Novo post para comparar a etapa de revisão com a mesma ação no app.

   • Substitua todos os placeholders por seus IDs autorizados, um timestamp ISO futuro com deslocamento de fuso e uma chave de idempotência única. Revise conta, texto e horário antes de executar esta requisição no servidor.

   • const apiKey = process.env.SOSOAPI_API_KEY;
     if (!apiKey) throw new Error("Configure a SosoAPI API key on your server");
     const response = await fetch(
       "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/create",
       {
         method: "POST",
         headers: {
           "Authorization": "Bearer " + apiKey,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({
       "workspace_id": "<workspace-uuid>",
       "social_account_id": "<threads-social-account-uuid>",
       "caption": "A small note for later: Harborlight Journal is making room for shorter daily reflections. Keep one thought; leave the rest for tomorrow.",
       "hashtags": [],
       "media": [],
       "provider_payload": {"platform": "threads", "publish_options": {"post_type": "TEXT"}},
       "scheduled_at": "<future ISO-8601 instant with offset>",
       "display_timezone": "Asia/Hong_Kong",
       "idempotency_key": "<unique-stable-key-for-this-intent>"
     })
       }
     );
     const result = await response.json();
     if (!response.ok) throw new Error("SosoAPI request failed: " + response.status);
     // Use result in your server response; never return or log the API key.

   • Executar esta requisição cria um agendamento real. Envie somente após a confirmação do usuário e nunca exponha a API key ao navegador.

   O que esperar

   Uma resposta aceita válida identifica o Scheduled Post resultante; não comprova que um provedor o publicou. Capacidade negada, escopo/conta inválidos, payload incompatível ou agendamento rejeitado devem ser exibidos como erro, sem informar sucesso.

4. 04

   Exiba o estado retornado e ofereça um acompanhamento seguro ao usuário

   Abra esta área no SosoAPI

   • Armazene o ID retornado do Scheduled Post e exiba seu estado atual, destino e agendamento no produto.

   • Direcione o usuário ao detalhe do Scheduled Post correspondente. Se a entrega exigir uma pessoa, vincule o item de Atenção necessária em vez de reenviar silenciosamente.

   • Não classifique a requisição como publicada até o status final confirmado pelo provedor estar registrado.

   O que esperar

   O produto distingue um comprovante de requisição das observações agendado, publicando, publicado, falhou e desconhecido. Resultados desconhecidos são reconciliados com o post existente antes de uma nova gravação.