Guide d’intégration

Publiez des articles vers n’importe quel outil avec un webhook

Quand votre site tourne sur une plateforme à laquelle Rank Prompt ne se connecte pas, une destination webhook envoie chaque article, complet et signé, vers une URL que vous contrôlez : Zapier, Make, n8n ou votre propre code.

Commencer gratuitement Découvrir la fonctionnalité
Destination webhook

Rank Prompt lit

  • Code de statut de votre endpoint
  • published_url
  • post_id

Rank Prompt envoie

  • Titre et slug
  • HTML et Markdown
  • Titre SEO et description
  • Tags et images
  • JSON-LD
  • En-tête de signature
Rank Prompt

Ce que ça fait

  • Envoie l’article entier en une seule requête : titre, slug, HTML, Markdown, titre SEO et description, tags, images, JSON-LD et la marque.
  • Envoie article.published à la publication, article.updated avec le même post_id quand vous republiez et article.unpublished quand vous retirez l’article.
  • Publie tout de suite ou à la date que vous programmez.
  • Signe chaque requête avec X-RP-Signature et peut ajouter un en-tête personnalisé pour les catch hooks qui en vérifient un.
  • Enregistre le published_url que répond votre endpoint, pour que le suivi des pages et les rapports de citations suivent l’article.

Ce qu’elle ne fait pas

  • Les brouillons ne sont pas envoyés : un webhook n’a nulle part où les garder.
  • Une requête transporte au maximum 4 Mo.
  • Rank Prompt n’écrit pas lui-même sur le site : la suite dépend de votre workflow.

Avant de commencer

Forfait Dès Starter

  • Une URL https qui répond 2xx à un POST : un catch hook Zapier, Make ou n8n, ou votre propre endpoint.
  • Un endroit où garder le secret de signature, si votre endpoint vérifie la signature.
Configuration

Destination webhook : configuration en 5 étapes

  1. Étape 1

    Ouvrez Intégrations, Publier du contenu

    Dans Rank Prompt, ouvrez Intégrations puis l’onglet Publier du contenu. Sur la carte Autres plateformes, cliquez sur +, choisissez Webhook et cliquez sur Continuer.

    La fenêtre Connecter une plateforme avec Ghost, Shopify, Webflow, Wix et Webhook.

  2. Étape 2

    Collez l’URL et gardez le secret

    Collez l’URL du webhook. Gardez le Secret de signature créé par Rank Prompt, ou générez-en un nouveau, et copiez-le dans votre endpoint. Ajoutez un En-tête personnalisé si votre catch hook en vérifie un ; sa valeur est stockée chiffrée et n’est plus jamais affichée.

    La fenêtre Connecter un webhook avec l’URL, le secret de signature, l’en-tête personnalisé et les options de format.

  3. Étape 3

    Choisissez le format

    Sous Format, JSON-LD dans le HTML ajoute les données structurées au corps HTML, et Front matter dans le Markdown commence le Markdown par du YAML (titre, slug, date, tags, image) pour les générateurs de sites statiques.

  4. Étape 4

    Connectez et associez l’article de test

    Cliquez sur Connecter le webhook. Rank Prompt envoie d’abord un article.test signé, l’URL doit donc répondre, et votre outil no-code peut associer les champs à partir de lui.

  5. Étape 5

    Répondez où l’article est en ligne

    Quand votre endpoint répond 2xx avec un JSON contenant published_url (et en option post_id), cette URL est enregistrée comme adresse de l’article. Sans elle, l’article est marqué publié sans URL.

Dépannage

Destination webhook : erreurs et solutions

Voici les messages que l’app affiche, mot pour mot, et ce qui résout chacun d’eux.

  • L’URL du webhook doit commencer par https://, car l’article et sa signature y transitent.

    Utilisez l’adresse https de votre endpoint.

  • Cette URL ne pointe pas vers une adresse publique.

    Utilisez une adresse joignable depuis internet, pas une adresse locale ou privée.

  • Rien n’a répondu à cette URL (404). Vérifiez l’adresse et que le workflow derrière est activé.

    Vérifiez l’adresse et que le Zap, le scénario ou le workflow est activé.

  • Le webhook a répondu 500 à un article de test.

    Votre endpoint a refusé le test. Corrigez-le et reconnectez.

  • Un en-tête personnalisé a besoin d’un nom et d’une valeur.

    Remplissez les deux ou laissez les deux vides.

  • L'URL du webhook pointe désormais vers un autre hôte : la valeur de l'en-tête personnalisé doit être saisie à nouveau, car elle n'est jamais envoyée à un hôte pour lequel elle n'a pas été saisie.

    Saisissez de nouveau la valeur de l’en-tête, ou laissez les deux champs vides.

  • Un webhook ne reçoit que des articles publiés, il ne peut donc pas garder de brouillon. Publiez l’article ou programmez-le.

    Publiez l’article tout de suite ou choisissez une date.

  • Cet article dépasse les 4 Mo qu’une requête de webhook peut transporter. Retirez les fichiers intégrés à son texte et réessayez.

    Retirez les fichiers intégrés au texte de l’article et publiez de nouveau.

Toutes les intégrations

FAQ

Questions fréquentes : Destination webhook

Encore des questions ? Contactez notre équipe

Quelle différence avec les webhooks de Rank Prompt ?

Une destination webhook est un endroit où publier des articles. Les webhooks de Developers préviennent vos outils quand les rapports et les exécutions programmées se terminent, et peuvent publier dans Slack ou Discord.

Comment vérifier qu’une requête vient de Rank Prompt ?

X-RP-Signature porte t, un horodatage, et v1, un HMAC-SHA256 de l’horodatage, d’un point et du corps brut, calculé avec votre secret de signature. Recalculez-le et comparez. X-RP-Event nomme l’événement.

Puis-je publier ainsi sur Framer ou un autre CMS ?

Oui, avec tout outil qui reçoit un webhook et écrit dans ce CMS, comme Zapier, Make ou n8n, ou avec votre propre endpoint.

Quelle offre me faut-il ?

Les destinations webhook commencent avec Starter, à 49 $ par mois, et envoyer un article vers l’une d’elles ne coûte aucun crédit. La génération de l’article coûte 10 crédits par article.

Opérationnel en quelques minutes

Créez un compte gratuit, suivez les étapes ci-dessus et voyez ce que la connexion apporte à votre visibilité IA.

Commencer gratuitement Voir les tarifs