DesarrolladoresPublica en cualquier cosa que sea tuya.
Un destino personalizado es una red que Ocoya no necesita conocer. Dale una URL y recibirá tu contenido terminado como JSON, igual que una publicación va a Instagram, solo que el otro extremo es tuyo.
El destino para todo lo demás.
Casi todo lo que se publica va a una red con logo. Esto es para el resto.
Tu propio blog
Los artículos escritos en Ocoya llegan al CMS que ya usas: Ghost, Strapi, Sanity o algo que hayas creado tú.
Una red que no admitimos
Recibe la publicación y reenvíala tú mismo. Cualquier cosa con API está al alcance de tu propio código.
Tu propio paso de aprobación
Envía el contenido publicado a una cola de revisión, un canal de Slack o una hoja de cálculo antes de que vaya a ningún otro sitio.
Tus propios registros
Guarda una copia de todo lo publicado en tu almacén de datos, sin tener que consultar ninguna API para ello.
Una URL, un nombre y, normalmente, una cabecera.
No hay baile de OAuth, porque los dos extremos son tuyos. Pega la dirección, añade la cabecera con la que se autentica tu endpoint y aparecerá en el editor junto a tus perfiles sociales.
- Cualquier URL que acepte un POST y responda 2xx
- Cabeceras para lo que use tu endpoint para autenticarse
- Aparece en el editor como cualquier otro perfil
Conectar un destino personalizado
Nombre
URL del webhook
Opciones avanzadas
Cuatro pasos, y ninguno es una semana de desarrollo.
Ten un sitio donde recibirlo
Cualquier URL que acepte un POST con un cuerpo JSON y responda 2xx. Tiene que ser accesible desde internet: Ocoya la llama desde nuestros servidores, no desde tu navegador.
Añade el destino
Integraciones → Personalizado. Dale un nombre que reconozcas en el editor y pega la URL.
Añade una cabecera, si la necesita
En Opciones avanzadas, añade la cabecera con la que se autentica tu endpoint, normalmente Authorization o X-API-Key. Se guarda cifrada y nunca se vuelve a mostrar en el navegador.
Publica en él como en una red
Aparece en el editor junto a tus perfiles sociales. Programa una publicación, o apunta una campaña de blog a él, y recibirá todo lo que guardó el editor.
Un POST, con justo lo que necesita un blog.
El cuerpo es JSON: el título, el texto exactamente como se escribió (en Markdown si es un artículo), una imagen de portada y el slug, el extracto, las etiquetas y los campos SEO del artículo cuando los tiene. Nada más, así que no hay nada que ignorar.
- Content-Type: application/json, más las cabeceras que hayas añadido
- caption es el cuerpo tal como se escribió; title e image van aparte
- post.id se mantiene entre reintentos, así que puedes actualizar en lugar de duplicar
Responde con un 2xx y Ocoya marca la publicación como publicada. Cualquier otra respuesta se te muestra con el cuerpo que devolvió tu endpoint.
Cada campo, con su tipo
El slug, el extracto, los campos SEO, las etiquetas y el tiempo de lectura que lleva un artículo: qué es cada uno y cuáles omite una publicación social.
Es tu endpoint, y lo llamamos con cuidado.
Un destino es una dirección a la que nos conectamos desde nuestra propia red, así que se trata como tal.
Las direcciones privadas e internas se rechazan, y la conexión queda fijada a la dirección que se resolvió.
Una redirección solo se sigue si la nueva dirección pasa la misma comprobación.
Tus cabeceras se guardan cifradas y nunca se devuelven al navegador.
Lo que responda tu endpoint se muestra en el registro de actividad, cuerpo incluido.
Publícalo donde le corresponda.
Conecta un destino en un minuto y apunta tu próxima campaña a él.