Ocoya
Desarrolladores

Publica en todo lo que sea tuyo.

Un destino personalizado es una red que Ocoya no necesita conocer. Dale una URL y recibe tu publicación terminada como JSON, igual que una publicación va a Instagram, solo que el otro extremo es tuyo.

Para qué sirve

El destino para todo lo demás.

La mayor parte de lo que publicas va a una red con logo. Esto es para el resto.

Sintonizar
Tu propio blog

Los artículos escritos en Ocoya llegan a tu propia web o CMS, sea cual sea la tecnología.

Conectarlo

Una URL, un nombre y normalmente un encabezado.

Los dos extremos son tuyos, así que no hay pantalla de inicio de sesión. Pega la dirección, añade el encabezado que espera tu endpoint y el destino aparece en el compositor junto a tus otros canales.

  • Cualquier URL pública que acepte un POST
  • Hasta 10 encabezados, para una clave de API o un token
  • Aparece en el compositor como cualquier otro canal
NombreOpcional
Mi blog

Cómo se llama este destino en tu lista de canales.

URL de publicaciónObligatorio
https://example.com/hooks/content

Cada publicación programada se envía aquí como un POST con cuerpo JSON.

URL de borradoOpcional
https://example.com/hooks/content/delete

Solo se llama cuando borras una publicación en Ocoya. Déjala vacía para conservar tu copia.

EncabezadosOpcional
Authorization: Bearer ••••••

Se envían con cada petición, para un endpoint que espera una clave de API o un token.

Conectar destino
Los datos

Un POST, con justo lo que un blog necesita.

El cuerpo es JSON: el título, el texto tal como lo escribiste (Markdown si es un artículo), una imagen de portada y, en un artículo, el slug, el extracto, las etiquetas y los campos SEO cuando los tiene. Nada más, así que no hay nada que ignorar.

POSTContent-Type: application/json
{
"event": "post.published",
"publishedAt": "2026-11-04T09:00:00.000Z",
"post": {
"id": "cm4x2k9a0001",
"title": "Why your content is not converting",
"caption": "## The three pillars\n\n…",
"image": "https://…/cover.png",
"options": {
"markdownMode": true,
"slug": "why-your-content-is-not-converting",
"excerpt": "…",
"seoTitle": "…",
"seoDescription": "…",
"tags": ["content", "strategy"],
"readingMinutes": 6
}
}
}
Leer la referencia de datos

La vista previa del compositor muestra este cuerpo exacto antes de programar, salvo el id y la hora.

Tu respuesta

Responde 2xx con un id y una url.

Ocoya espera hasta 30 segundos la respuesta. Una publicación cuenta como publicada cuando respondes con un estado 2xx y un JSON que tenga id y url. La url pasa a ser el enlace de la publicación, y el id es lo que Ocoya te devuelve si borras la publicación.

POSTtu endpoint
200 { "id": "a1b2c3", "url": "https://…" }
Publicado
POSTtu endpoint
200 { }
Falló: sin id o url. Puede que ya exista, así que compruébalo primero.
POSTtu endpoint
400 { "error": "title is missing" }
Falló. Ocoya te muestra el mensaje que envió tu endpoint.
POSTtu endpoint
sin respuesta en 30 s
Falló. No se reintenta, para que nada se envíe dos veces.
24 hintento 1+5 min+30 min+2 h+6 h+12 h{ }503, esperando200 OK
Cuando está ocupado

Un endpoint ocupado tiene otra oportunidad.

Si tu endpoint responde 429, 502, 503 o 504, Ocoya espera y lo intenta de nuevo por sí solo: a los 5 minutos, luego a los 30 minutos, 2 horas, 6 horas y 12 horas. Mientras espera, la publicación sigue programada.

  • Se detiene cuando una publicación saldría con más de 24 horas de retraso.
  • Otros errores y los tiempos de espera agotados no se reintentan. Un tiempo agotado puede haber publicado ya, y un segundo intento podría publicarlo dos veces.
  • El id de la publicación es el mismo en cada intento.
Borrar

Bórralo allí cuando lo borres aquí.

Añade una URL de borrado opcional. Cuando borras una publicación en Ocoya, envía allí una petición post.deleted con el id que tu endpoint te dio al publicar. Si la dejas vacía, tu copia se queda.

Al publicar, tu respuesta{ "id": "a1b2c3", "url": "https://…" }
Borras la publicación en Ocoya
La petición a tu URL de borrado
POST /hooks/content/delete
{
  "event": "post.deleted",
  "id": "a1b2c3",
  "deletedAt": "2026-11-04T10:12:00.000Z",
  "post": { … }
}
Tu copia
Seguridad

Es tu endpoint, llamado con cuidado.

Un destino es una dirección a la que Ocoya se conecta desde su propia red, así que se trata como tal.

192.168.0.12localhostapi.yourshop.comRechazadaPermitida
  • Las direcciones privadas e internas se rechazan.
  • La conexión se fija a la dirección pública a la que resolvió tu host.
  • Una redirección solo se sigue cuando la nueva dirección pasa la misma comprobación, hasta 3 veces.
  • Los valores de los encabezados se quedan en nuestros servidores. El navegador solo ve sus nombres.
En el compositor

Está en el compositor como cualquier otro canal.

Tu destino aparece junto a Instagram y LinkedIn. Elígelo, fija el día y la hora, y se envía en el minuto que elegiste, junto con el resto.

  • Prográmalo
  • Velo en el calendario
  • Apunta una campaña de blog hacia él

La vista previa del compositor muestra antes el cuerpo exacto de la petición.

Preguntas

Conviene saber antes de conectar.

RXAceptar un POST con cuerpo JSON y responder con un estado 2xx y un JSON que tenga id y url. Debe ser accesible desde internet, porque Ocoya lo llama desde sus propios servidores.

RXAñade un encabezado como Authorization o X-API-Key en Opciones avanzadas y compruébalo en tu código. Ocoya lo envía con cada petición. Las peticiones no están firmadas.

RXSi responde 429, 502, 503 o 504, Ocoya lo intenta de nuevo a los 5 minutos, 30 minutos, 2 horas, 6 horas y 12 horas, siempre que la publicación no saliera con más de 24 horas de retraso. Otros errores fallan al instante y te muestran el estado y el mensaje de tu endpoint.

RXNo. Ocoya solo se conecta a direcciones públicas. Las direcciones privadas e internas se rechazan.

RXEnvía una imagen, la primera imagen fija de la publicación, como enlace. El vídeo no se envía.

Publícalo donde debe estar.

Conecta un destino en un minuto y apunta tu próxima campaña hacia él.