Guía de integración

Publica artículos en cualquier herramienta con un webhook

Cuando tu sitio corre en una plataforma a la que Rank Prompt no se conecta, un destino webhook envía cada artículo, completo y firmado, a una URL que controlas: Zapier, Make, n8n o tu propio código.

Empieza gratis Conoce la función
Destino webhook

Rank Prompt lee

  • Código de estado de tu endpoint
  • published_url
  • post_id

Rank Prompt envía

  • Título y slug
  • HTML y Markdown
  • Título SEO y descripción
  • Etiquetas e imágenes
  • JSON-LD
  • Encabezado de firma
Rank Prompt

Qué hace

  • Envía el artículo completo en una sola solicitud: título, slug, HTML, Markdown, título SEO y descripción, etiquetas, imágenes, JSON-LD y la marca.
  • Envía article.published al publicar, article.updated con el mismo post_id al volver a publicar y article.unpublished al eliminar el artículo.
  • Publica ahora o en la fecha que programes.
  • Firma cada solicitud con X-RP-Signature y puede sumar un encabezado personalizado para los catch hooks que lo revisan.
  • Registra el published_url que responde tu endpoint, así el seguimiento de páginas y los reportes de citas siguen al artículo.

Lo que no puede hacer

  • Los borradores no se envían: un webhook no tiene dónde guardarlos.
  • Una solicitud lleva como máximo 4 MB.
  • Rank Prompt no escribe en el sitio: lo que pasa después de la solicitud depende de tu flujo.

Antes de empezar

Plan Desde Starter

  • Una URL https que responda 2xx a un POST: un catch hook de Zapier, Make o n8n, o tu propio endpoint.
  • Un lugar donde guardar el secreto de firma, si tu endpoint verifica la firma.
Configuración

Destino webhook: configuración en 5 pasos

  1. Paso 1

    Abre Integraciones, Publicar contenido

    En Rank Prompt, abre Integraciones y la pestaña Publicar contenido. En la tarjeta Más plataformas haz clic en +, elige Webhook y haz clic en Continuar.

    El diálogo Conectar una plataforma con Ghost, Shopify, Webflow, Wix y Webhook.

  2. Paso 2

    Pega la URL y guarda el secreto

    Pega la URL del webhook. Conserva el Secreto de firma que generó Rank Prompt, o crea uno nuevo, y cópialo en tu endpoint. Agrega un Encabezado personalizado si tu catch hook lo revisa; su valor se guarda cifrado y no se vuelve a mostrar.

    El diálogo Conectar un webhook con la URL, el secreto de firma, el encabezado personalizado y las opciones de formato.

  3. Paso 3

    Elige el formato

    En Formato, JSON-LD dentro del HTML agrega los datos estructurados al cuerpo HTML, y Front matter en el Markdown empieza el Markdown con YAML (título, slug, fecha, etiquetas, imagen) para generadores de sitios estáticos.

  4. Paso 4

    Conecta y mapea el artículo de prueba

    Haz clic en Conectar webhook. Rank Prompt envía primero un article.test firmado, así que la URL tiene que responder, y tu herramienta no-code puede mapear los campos con él.

  5. Paso 5

    Responde dónde quedó publicado

    Si tu endpoint responde 2xx con un JSON que tenga published_url (y opcionalmente post_id), esa URL queda registrada como la dirección del artículo. Sin ella, el artículo queda publicado sin URL.

Solución de problemas

Destino webhook: errores y soluciones

Estos son los mensajes que muestra la app, palabra por palabra, y lo que resuelve cada uno.

  • La URL del webhook debe empezar con https://, porque el artículo y su firma viajan por ella.

    Usa la dirección https de tu endpoint.

  • Esa URL no resuelve a una dirección pública.

    Usa una dirección accesible desde internet, no una local o privada.

  • Nada respondió en esta URL (404). Revisa la dirección y que el flujo de trabajo detrás esté activado.

    Revisa la dirección y que el Zap, el escenario o el workflow esté activado.

  • El webhook respondió 500 a un artículo de prueba.

    Tu endpoint rechazó la prueba. Corrígelo y vuelve a conectar.

  • Un encabezado personalizado necesita un nombre y un valor.

    Completa los dos o deja los dos vacíos.

  • La URL del webhook ahora apunta a otro host, así que hay que volver a ingresar el valor del encabezado personalizado: nunca se envía a un host para el que no se ingresó.

    Vuelve a escribir el valor del encabezado, o deja vacíos los dos campos.

  • Un webhook solo recibe artículos publicados, así que no puede guardar un borrador. Publica el artículo o prográmalo.

    Publica el artículo ahora o elige una fecha.

  • Este artículo supera los 4 MB que admite una solicitud de webhook. Quita los archivos incrustados en su texto y vuelve a intentarlo.

    Quita los archivos incrustados en el texto del artículo y vuelve a publicar.

Todas las integraciones

Preguntas frecuentes

Preguntas frecuentes: Destino webhook

¿Todavía tienes preguntas? Escríbenos

¿En qué se diferencia de los webhooks de Rank Prompt?

Un destino webhook es un lugar donde publicar artículos. Los webhooks de Developers avisan a tus herramientas cuando terminan los reportes y las ejecuciones programadas, y pueden publicar en Slack o Discord.

¿Cómo compruebo que una solicitud viene de Rank Prompt?

X-RP-Signature lleva t, una marca de tiempo, y v1, un HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo crudo, hecho con tu secreto de firma. Vuelve a calcularlo y compáralo. X-RP-Event nombra el evento.

¿Puedo publicar así en Framer u otro CMS?

Sí, con cualquier herramienta que reciba un webhook y escriba en ese CMS, como Zapier, Make o n8n, o con tu propio endpoint.

¿Qué plan necesito?

Los destinos webhook empiezan en Starter, a $49 al mes, y enviar un artículo a uno no cuesta créditos. La generación del artículo cuesta 10 créditos por artículo.

En marcha en pocos minutos

Crea una cuenta gratis, sigue los pasos de arriba y mira qué le suma la conexión a tu visibilidad en IA.

Empieza gratis Ver precios