Guia de integração

Publique artigos em qualquer ferramenta com um webhook

Quando o seu site roda numa plataforma à qual o Rank Prompt não se conecta, um destino webhook envia cada artigo, inteiro e assinado, para uma URL que você controla: Zapier, Make, n8n ou o seu próprio código.

Comece grátis Conheça o recurso
Destino webhook

A Rank Prompt lê

  • Código de status do seu endpoint
  • published_url
  • post_id

A Rank Prompt envia

  • Título e slug
  • HTML e Markdown
  • Título SEO e descrição
  • Tags e imagens
  • JSON-LD
  • Cabeçalho de assinatura
Rank Prompt

O que faz

  • Envia o artigo inteiro numa só requisição: título, slug, HTML, Markdown, título SEO e descrição, tags, imagens, JSON-LD e a marca.
  • Envia article.published ao publicar, article.updated com o mesmo post_id ao publicar de novo e article.unpublished ao remover o artigo.
  • Publica agora ou na data que você agendar.
  • Assina cada requisição com X-RP-Signature e pode adicionar um cabeçalho personalizado para catch hooks que conferem um.
  • Registra o published_url que o seu endpoint responde, então o acompanhamento de páginas e os relatórios de citações seguem o artigo.

O que ela não faz

  • Rascunhos não são enviados: um webhook não tem onde guardá-los.
  • Uma requisição leva no máximo 4 MB.
  • O Rank Prompt não escreve no site: o que acontece depois da requisição depende do seu fluxo.

Antes de começar

Plano A partir do Starter

  • Uma URL https que responda 2xx a um POST: um catch hook do Zapier, Make ou n8n, ou o seu próprio endpoint.
  • Um lugar para guardar o segredo de assinatura, se o seu endpoint confere a assinatura.
Configuração

Destino webhook: configuração em 5 passos

  1. Passo 1

    Abra Integrações, Publicar conteúdo

    No Rank Prompt, abra Integrações e a aba Publicar conteúdo. No card Mais plataformas clique em +, escolha Webhook e clique em Continuar.

    A janela Conectar uma plataforma com Ghost, Shopify, Webflow, Wix e Webhook.

  2. Passo 2

    Cole a URL e guarde o segredo

    Cole a URL do webhook. Mantenha o Segredo de assinatura que o Rank Prompt gerou, ou crie outro, e copie para o seu endpoint. Adicione um Cabeçalho personalizado se o seu catch hook conferir um; o valor fica criptografado e não aparece de novo.

    A janela Conectar um webhook com a URL, o segredo de assinatura, o cabeçalho personalizado e as opções de formato.

  3. Passo 3

    Escolha o formato

    Em Formato, JSON-LD dentro do HTML adiciona os dados estruturados ao corpo HTML, e Front matter no Markdown começa o Markdown com YAML (título, slug, data, tags, imagem) para geradores de sites estáticos.

  4. Passo 4

    Conecte e mapeie o artigo de teste

    Clique em Conectar webhook. O Rank Prompt envia antes um article.test assinado, então a URL precisa responder, e a sua ferramenta no-code pode mapear os campos a partir dele.

  5. Passo 5

    Responda onde o artigo foi ao ar

    Quando o seu endpoint responde 2xx com um JSON que tenha published_url (e opcionalmente post_id), essa URL fica registrada como o endereço do artigo. Sem ela, o artigo fica publicado sem URL.

Solução de problemas

Destino webhook: erros e soluções

Estas são as mensagens que o app mostra, palavra por palavra, e o que resolve cada uma.

  • A URL do webhook precisa começar com https://, porque o artigo e a assinatura viajam por ela.

    Use o endereço https do seu endpoint.

  • Essa URL não é resolvida para um endereço público.

    Use um endereço acessível pela internet, não um local ou privado.

  • Nada respondeu nesta URL (404). Confira o endereço e se o fluxo por trás dela está ativado.

    Confira o endereço e se o Zap, o cenário ou o workflow está ativado.

  • O webhook respondeu 500 a um artigo de teste.

    O seu endpoint recusou o teste. Corrija e conecte de novo.

  • Um cabeçalho personalizado precisa de um nome e de um valor.

    Preencha os dois ou deixe os dois vazios.

  • A URL do webhook agora aponta para outro host, então o valor do cabeçalho personalizado precisa ser informado de novo: ele nunca é enviado a um host para o qual não foi informado.

    Digite o valor do cabeçalho de novo, ou deixe os dois campos vazios.

  • Um webhook só recebe artigos publicados, então não guarda rascunhos. Publique o artigo ou agende.

    Publique o artigo agora ou escolha uma data.

  • Este artigo passa dos 4 MB que uma requisição de webhook suporta. Remova os arquivos incorporados no texto e tente de novo.

    Remova os arquivos incorporados no texto do artigo e publique de novo.

Todas as integrações

Perguntas frequentes

Perguntas frequentes: Destino webhook

Ainda tem dúvidas? Fale com nossa equipe

Qual a diferença para os webhooks do Rank Prompt?

Um destino webhook é um lugar para publicar artigos. Os webhooks de Developers avisam as suas ferramentas quando relatórios e execuções agendadas terminam, e podem postar no Slack ou no Discord.

Como confiro que uma requisição veio do Rank Prompt?

O X-RP-Signature traz t, um timestamp, e v1, um HMAC-SHA256 do timestamp, um ponto e o corpo bruto, feito com o seu segredo de assinatura. Recalcule e compare. O X-RP-Event nomeia o evento.

Posso publicar assim no Framer ou em outro CMS?

Sim, com qualquer ferramenta que receba um webhook e escreva nesse CMS, como Zapier, Make ou n8n, ou com o seu próprio endpoint.

Qual plano eu preciso?

Os destinos webhook começam no Starter, por $49 ao mês, e enviar um artigo para um deles não custa créditos. A geração do artigo custa 10 créditos por artigo.

Funcionando em poucos minutos

Crie uma conta grátis, siga os passos acima e veja o que a conexão soma à sua visibilidade em IA.

Comece grátis Ver preços