- Make → Social media studio: o módulo HTTP → Make a request chama a API REST para criar ou agendar uma publicação.
- Social media studio → Make: o gatilho Webhooks → Custom webhook recebe os eventos que o Social media studio envia (publicação publicada, publicação com falha, novo comentário e mais).
A API REST exige um plano Standard, Advanced ou Lifetime (o Lite não a inclui). O número de endpoints de webhook que você pode criar depende do seu plano; veja a Visão geral de webhooks.
Antes de começar
1
Crie uma chave de API
No Social media studio, abra Configurações → API (app.so-me.studio/settings?tab=api) e crie uma chave. Ela começa com
sk_live_ e é exibida uma única vez. Veja Autenticação.2
Encontre os IDs das suas contas (opcional)
Se você conectou mais de uma conta na mesma plataforma, toda publicação precisa indicar qual usar. Liste suas contas uma vez e anote o Com exatamente uma conta em uma plataforma, você pode omitir o
id de cada uma:accountId.Crie ou agende uma publicação a partir de um cenário
1
Monte o corpo com um módulo JSON
Adicione JSON → Create JSON. Defina uma estrutura de dados com os campos abaixo e mapeie os valores dos módulos anteriores. O Make escapa aspas e quebras de linha por você, o que um corpo JSON digitado à mão não faz.
2
Envie com o módulo HTTP
Adicione HTTP → Make a request:
O corpo que o módulo HTTP envia é assim:
201 com a publicação, incluindo o id e postStatus: "SCHEDULED". Para publicar em várias plataformas, use um módulo HTTP por plataforma ou um Iterator sobre uma lista de plataformas.
Erros
Erros
Adicione uma rota de tratamento de erros ao módulo HTTP se um cenário deve continuar depois de uma publicação com falha.
Inicie um cenário a partir de um evento do Social media studio
1
Crie o webhook no Make
Inicie o cenário com Webhooks → Custom webhook, clique em Add e copie o endereço que o Make fornece.
2
Assine esse endereço no Social media studio
Abra Configurações → Webhooks (app.so-me.studio/settings?tab=webhooks), adicione um endpoint com o endereço do Make e escolha os eventos. Ou crie-o pela API:A resposta inclui o
secret de assinatura da assinatura de webhook.3
Deixe o Make aprender a estrutura
Com o módulo Custom webhook escutando (Run once), clique em Testar na assinatura em Configurações → Webhooks. O Make registra os campos da entrega de exemplo.
POST JSON com este envelope:
event quando um webhook receber vários tipos de evento. O bloco data traz IDs em vez do conteúdo completo; para uma publicação, adicione um módulo HTTP com GET https://api.so-me.studio/v1/posts/{{data.postId}} e o cabeçalho X-API-Key para ler o texto, o link publicado (shareUrl) ou o failureReason.
Eventos úteis incluem post.published, post.failed, post.scheduled, inbox.message_received, inbox.comment_received, social.account_disconnected e quota.limit_reached. Veja a Visão geral de webhooks para a lista completa e o Formato do payload para exemplos de payload.
O Social media studio espera 10 segundos por uma resposta e tenta novamente uma entrega com falha até 4 vezes. Uma assinatura que falha 10 vezes seguidas é desativada; reative-a em Configurações → Webhooks.