Webhooks

Não tem uma integração nativa do Sorank para o seu CMS? O conector Webhook permite enviar seus artigos gerados para qualquer URL, Zapier, Make, n8n ou um endpoint personalizado no seu próprio site, para que você possa publicar seu conteúdo onde precisar.

Como funciona

Quando você publica um artigo no Sorank, enviamos uma requisição POST com um payload JSON estruturado para a URL que você configurou. Seu endpoint ou ferramenta de automação pode então processar o payload e criar a publicação no seu blog, site personalizado ou qualquer outra ferramenta que aceite requisições HTTP.

Passo 1: Abrir a integração Webhook

1. Clique na sua foto de perfil no canto superior direito e selecione Configurações.
2. Abra a aba Integrações.
3. Role até o cartão Webhook e clique em Conectar seu site.

Passo 2: Configurar seu endpoint

1. Cole a URL de destino no campo URL do webhook.
2. Opcionalmente, adicione um Token secreto se o seu endpoint requer autenticação.
3. Clique em Testar para enviar um payload de exemplo.
4. Clique em Salvar webhook para ativar a integração.

Estrutura do payload do webhook

O Sorank emite dois tipos de eventos webhook: article.published e webhook.test.

Evento: article.published

Disparado toda vez que você publica um artigo pelo Sorank.

Campos do payload

• event: Tipo de evento.
• delivery_id: UUID único para cada tentativa de entrega.
• timestamp: Timestamp UTC ISO 8601.
• article.id: Identificador único do artigo no Sorank.
• article.title: O H1 / título do artigo.
• article.slug: Slug compatível com URL.
• article.meta_description: Meta descrição de SEO.
• article.content: Corpo completo do artigo em HTML.
• article.language: Tag de idioma BCP 47.