- Zapier → Social media studio: uma ação do Webhooks by Zapier chama a API REST para criar ou agendar uma publicação.
- Social media studio → Zapier: um gatilho do Webhooks by Zapier recebe os eventos que o Social media studio envia (publicação publicada, publicação com falha, novo comentário e mais).
O Webhooks by Zapier pode exigir um plano pago do Zapier. Confira o seu plano do Zapier antes de montar a automação. No lado do Social media studio, 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 Zap
Adicione uma etapa de ação: Webhooks by Zapier → POST.
O Zapier monta e escapa o JSON para você, então textos com aspas ou quebras de linha são seguros.
Para publicar em várias plataformas, adicione uma etapa POST por plataforma.
A requisição equivalente, para testar fora do Zapier:
201 com a publicação, incluindo o id e postStatus: "SCHEDULED". Mapeie o id nas etapas seguintes se quiser atualizar ou excluir a publicação.
Campos aninhados: opções do TikTok e threads
Campos aninhados: opções do TikTok e threads
As publicações do TikTok precisam de O Custom Request envia o corpo exatamente como digitado e não escapa os valores mapeados. Um campo mapeado que contenha aspas duplas ou uma quebra de linha gera um JSON inválido, que a API rejeita com
tiktok.privacyLevel e os encadeamentos (threads) usam um array threadParts. A ação POST envia dados planos de chave-valor, então use Webhooks by Zapier → Custom Request para esses casos, com Method POST, a mesma URL e os mesmos cabeçalhos, mais Content-Type: application/json, e o corpo JSON digitado em Data:400.Erros
Erros
Inicie um Zap a partir de um evento do Social media studio
1
Crie o gatilho no Zapier
Escolha Webhooks by Zapier → Catch Hook como gatilho e copie a URL de webhook que o Zapier fornece.
2
Assine essa URL no Social media studio
Abra Configurações → Webhooks (app.so-me.studio/settings?tab=webhooks), adicione um endpoint com a URL do Zapier e escolha os eventos. Ou crie-o pela API:A resposta inclui o
secret de assinatura da assinatura de webhook.3
Envie um evento de teste
Clique em Testar na assinatura em Configurações → Webhooks e depois em Test trigger no Zapier para ele aprender os campos.
POST JSON com este envelope:
Event, Data Post Id, Data Platform e assim por diante. O bloco data traz IDs em vez do conteúdo completo; para uma publicação, chame GET https://api.so-me.studio/v1/posts/{postId} com uma etapa Webhooks by Zapier → GET para ler o texto, o link publicado (shareUrl) ou o failureReason.
Eventos úteis para Zaps 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.