Custom (webhook)

Le canal Custom ne publie sur aucun réseau. Il envoie chaque publication programmée, en JSON, à une URL dont vous êtes propriétaire, et la suite dépend de votre code.

Utilisez-le pour un CMS auquel Ocoya ne se connecte pas, un générateur de site statique, une file de relecture interne, ou tout ce que vous préférez construire plutôt qu’attendre.

​

Connecter un endpoint

​

Ce que reçoit votre endpoint

Un POST avec Content-Type: application/json. Il contient ce dont un blog a besoin, et rien d’autre :

{
  "event": "post.published",
  "publishedAt": "2026-09-17T09:00:00.000Z",
  "post": {
    "id": "clx…",
    "title": "Three labels, one warmer palette",
    "caption": "Testing a softer set of creams…",
    "image": "https://…/image.jpg"
  }
}

​

Contenu de post.options

Seul un article en a — un article rédigé par une campagne de blog. Une publication faite à la main n’en a aucun, et options est tout simplement omis. Considérez chaque champ comme facultatif.

Un article arrive sous cette forme :

{
  "event": "post.published",
  "publishedAt": "2026-09-22T09:00:00.000Z",
  "post": {
    "id": "clx…",
    "title": "Why your content is not converting",
    "caption": "You're posting every day and still refreshing an empty inbox.\n\n## The three pillars\n\n- A clear offer, repeated\n- One place to send people\n",
    "image": "https://…/cover.png",
    "options": {
      "markdownMode": true,
      "slug": "why-your-content-is-not-converting",
      "excerpt": "Volume is rarely the problem. Nothing you publish asks anybody to do anything.",
      "seoTitle": "Why your content is not converting",
      "seoDescription": "Volume is rarely the problem. Here is the system that fixes it.",
      "tags": ["content-marketing"],
      "readingMinutes": 7
    }
  }
}

​

Supprimer une publication

Supprimer une publication dans Ocoya la supprime sur les réseaux où elle a été publiée. Une destination personnalisée est votre système : Ocoya ne peut donc que l’en informer — ce qu’il fait par un POST vers l’URL de suppression, si vous en avez fourni une.

Le corps est de nouveau la publication publiée, avec trois ajouts : le nom de l’événement, les horodatages et — le seul champ dont vous avez besoin — l’id que votre endpoint a renvoyé lors de la publication.

{
  "event": "post.deleted",
  "id": "9f2c1a",
  "publishedAt": "2026-09-22T09:00:00.000Z",
  "deletedAt": "2026-09-28T14:12:00.000Z",
  "post": {
    "id": "clx…",
    "title": "Why your content is not converting",
    "caption": "…",
    "image": null,
    "options": { "slug": "why-your-content-is-not-converting" }
  }
}

Supprimez par id — l’identifiant que votre endpoint a renvoyé lors de la publication, rendu tel quel au premier niveau pour qu’il n’y ait rien à extraire d’une adresse. L’url que vous avez renvoyée n’est pas envoyée : un endpoint qui supprime avec son propre id n’a aucun besoin d’une adresse qu’il connaît déjà.

Répondez par n’importe quel code 2xx, comme pour une publication. Si la publication a déjà disparu de votre côté, répondez 404 ou 410 et Ocoya l’enregistre comme déjà supprimée plutôt que comme un échec. Toute autre réponse est signalée sur la publication, et la publication est de toute façon supprimée dans Ocoya : une destination qui refuse n’est jamais une raison de conserver une publication que vous avez demandé de supprimer.

​

Ce qu’Ocoya attend en retour

Répondez avec n’importe quel statut 2xx. Tout le reste est enregistré comme une publication échouée, et le statut ainsi que le corps de la réponse s’affichent sur la publication pour que vous voyiez ce que votre endpoint a répondu.

​

Renvoyer un id et une url

Votre endpoint doit répondre avec les deux, en JSON :

{
  "id": "9f2c1a",
  "url": "https://yourblog.com/post"
}

Les deux sont obligatoires. Un 2xx sans eux est enregistré comme une publication échouée, et le message l’indique sur la publication — y compris que le contenu existe peut-être déjà à votre destination, de sorte que republier à l’aveugle créerait une seconde copie.

url est la seule clé lue pour l’adresse — permalink était accepté comme synonyme dans les versions précédentes et ne l’est plus.

Renvoyez les deux dans la même réponse. Ocoya les lit une seule fois, quand votre endpoint répond ; il n’y a pas de callback pour les envoyer ensuite, donc un endpoint qui met le travail en file d’attente doit connaître son id et son adresse finale avant de répondre, pas après.

Votre endpoint dispose de 30 secondes pour répondre. Faites le travail lent après avoir répondu plutôt qu’avant : accusez réception de la requête, puis traitez-la.

Une redirection est suivie plutôt que traitée comme un échec, tant que l’adresse visée passe la même vérification que l’originale — accessible publiquement, et épinglée sur ce vers quoi elle se résout. La méthode est conservée : votre endpoint reçoit donc toujours un POST avec le corps. La limite est de trois sauts.

​

Limites

Aucun fournisseur ne se trouve derrière un webhook, il n’y a donc rien de réel à valider : vous possédez la partie réceptrice et décidez de ce qu’elle accepte. Ce sont des garde-fous plutôt que des limites : assez larges pour un long article avec ses médias, assez étroits pour qu’une génération qui s’emballe soit arrêtée dans le composer plutôt qu’à votre endpoint.

​

Problèmes fréquents

“A destination URL must start with http:// or https://.” L’URL n’a pas de schéma. Ajoutez-le.

“”Content-Type” is set by Ocoya and cannot be overridden.” Quelques en-têtes décrivent la requête elle-même au lieu de l’authentifier — les en-têtes de contenu, Host, Connection, Transfer-Encoding. Ocoya les définit, vos propres en-têtes ne peuvent donc pas les remplacer.

“”…” is not a valid header name.” Un nom d’en-tête est composé de lettres, de chiffres et de tirets. Un espace ou deux-points dans le champ du nom signifie généralement que toute la ligne Name: value y a été collée — le nom va dans le champ de gauche, la valeur dans celui de droite.

“That is not a valid URL.” L’adresse n’a pas pu être analysée. Vérifiez les fautes de frappe et les espaces parasites.

“Your endpoint could not be reached. Check the URL is correct and publicly accessible.” Le DNS n’a pas résolu l’adresse ou la connexion a été refusée. Un endpoint sur localhost ou sur un réseau privé n’est pas accessible depuis Ocoya.

“Your endpoint answered 200 but did not return id or url.” La requête a atteint votre endpoint et il l’a acceptée, mais la réponse ne contenait pas l’un des champs obligatoires, ou les deux. Ocoya l’enregistre comme une publication échouée car, sans id, il n’y aura rien à utiliser pour supprimer plus tard.

Notez que le contenu existe peut-être déjà à votre destination — l’endpoint a bien répondu avec succès. Vérifiez avant de republier, sinon vous aurez deux copies.

“This destination has no delete endpoint.” Une publication a été supprimée dans Ocoya et ce canal n’a pas d’URL de suppression : rien n’a été envoyé et la copie à votre destination est toujours là. Reconnectez la destination avec une URL de suppression pour changer cela.

“Your endpoint did not respond in time.” Il a mis plus de 30 secondes. Accusez réception d’abord, traitez ensuite.

“Your endpoint redirected to https://…” La redirection est sortie de l’adresse que vous avez donnée — un autre hôte ou un autre schéma qu’Ocoya n’a pas pu revérifier, ou une adresse qui se résolvait vers un réseau privé. Utilisez l’adresse qui répond directement. Une redirection qui reste sur une adresse publiquement accessible est suivie pour vous, jusqu’à trois sauts.

“Your endpoint returned 500: …” Votre code a levé une erreur. Le détail après le statut est ce que votre endpoint a renvoyé, tronqué.

​

À lire aussi