Ocoya
Desenvolvedores

Publique em tudo o que é seu.

Um destino personalizado é uma rede que o Ocoya não precisa conhecer. Dê-lhe um URL e ele recebe a sua publicação pronta em JSON, como uma publicação vai para o Instagram, só que a outra ponta é sua.

Para que serve

O destino para tudo o resto.

A maior parte do que publica vai para uma rede com logótipo. Isto é para o resto.

Sintonizar
O seu próprio blogue

Os artigos escritos no Ocoya chegam ao seu site ou CMS, seja com que tecnologia for.

Ligá-lo

Um URL, um nome e normalmente um cabeçalho.

As duas pontas são suas, por isso não há ecrã de início de sessão. Cole o endereço, adicione o cabeçalho que o seu endpoint espera e o destino aparece no compositor junto dos seus outros canais.

  • Qualquer URL público que aceite um POST
  • Até 10 cabeçalhos, para uma chave de API ou um token
  • Aparece no compositor como qualquer outro canal
NomeOpcional
O meu blogue

Como este destino é chamado na sua lista de canais.

URL de publicaçãoObrigatório
https://example.com/hooks/content

Cada publicação agendada é enviada para aqui como um POST com corpo JSON.

URL de eliminaçãoOpcional
https://example.com/hooks/content/delete

Só é chamado quando elimina uma publicação no Ocoya. Deixe vazio para manter a sua cópia.

CabeçalhosOpcional
Authorization: Bearer ••••••

Enviados com cada pedido, para um endpoint que espera uma chave de API ou um token.

Ligar destino
Os dados enviados

Um POST, com apenas o que um blogue precisa.

O corpo é JSON: o título, o texto tal como o escreveu (Markdown num artigo), uma imagem de capa e, num artigo, o slug, o resumo, as etiquetas e os campos SEO quando existem. Nada mais, por isso não há nada para 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
}
}
}
Ler a referência dos dados

A pré-visualização do compositor mostra este corpo exato antes de agendar, exceto o id e a hora.

A sua resposta

Responda 2xx com um id e um url.

O Ocoya espera até 30 segundos pela resposta. Uma publicação conta como publicada quando responde com um estado 2xx e um JSON que tenha id e url. O url passa a ser a ligação da publicação, e o id é o que o Ocoya devolve se eliminar a publicação.

POSTo seu endpoint
200 { "id": "a1b2c3", "url": "https://…" }
Publicado
POSTo seu endpoint
200 { }
Falhou: sem id ou url. Pode já existir, por isso verifique primeiro.
POSTo seu endpoint
400 { "error": "title is missing" }
Falhou. O Ocoya mostra-lhe a mensagem que o seu endpoint enviou.
POSTo seu endpoint
sem resposta em 30 s
Falhou. Sem nova tentativa, para que nada seja enviado duas vezes.
24 htentativa 1+5 min+30 min+2 h+6 h+12 h{ }503, a aguardar200 OK
Quando está ocupado

Um endpoint ocupado tem outra oportunidade.

Se o seu endpoint responder 429, 502, 503 ou 504, o Ocoya espera e tenta de novo sozinho: após 5 minutos, depois 30 minutos, 2 horas, 6 horas e 12 horas. Enquanto espera, a publicação continua agendada.

  • Para quando uma publicação sairia com mais de 24 horas de atraso.
  • Outros erros e tempos esgotados não são repetidos. Um tempo esgotado pode já ter publicado, e uma segunda tentativa podia publicar duas vezes.
  • O id da publicação é o mesmo em cada tentativa.
Eliminar

Elimine lá quando elimina aqui.

Adicione um URL de eliminação opcional. Quando elimina uma publicação no Ocoya, ele envia para lá um pedido post.deleted com o id que o seu endpoint lhe deu ao publicar. Deixe vazio e a sua cópia fica.

Ao publicar, a sua resposta{ "id": "a1b2c3", "url": "https://…" }
Elimina a publicação no Ocoya
O pedido ao seu URL de eliminação
POST /hooks/content/delete
{
  "event": "post.deleted",
  "id": "a1b2c3",
  "deletedAt": "2026-11-04T10:12:00.000Z",
  "post": { … }
}
A sua cópia
Segurança

É o seu endpoint, contactado com cuidado.

Um destino é um endereço a que o Ocoya se liga a partir da sua própria rede, por isso é tratado como tal.

192.168.0.12localhostapi.yourshop.comRecusadoPermitido
  • Os endereços privados e internos são recusados.
  • A ligação fica presa ao endereço público a que o seu anfitrião resolveu.
  • Um redirecionamento só é seguido depois de o novo endereço passar a mesma verificação, até 3 vezes.
  • Os valores dos cabeçalhos ficam nos nossos servidores. O navegador só vê os nomes.
No compositor

Está no compositor como qualquer outro canal.

O seu destino aparece junto do Instagram e do LinkedIn. Escolha-o, defina o dia e a hora, e é enviado ao minuto escolhido, com os restantes.

  • Agende-o
  • Veja-o no calendário
  • Aponte uma campanha de blogue para ele

A pré-visualização do compositor mostra primeiro o corpo exato do pedido.

Perguntas

Bom saber antes de ligar.

RXAceitar um POST com corpo JSON e responder com um estado 2xx e um JSON que tenha id e url. Tem de ser acessível a partir da internet, porque o Ocoya chama-o dos seus próprios servidores.

RXAdicione um cabeçalho como Authorization ou X-API-Key em Opções avançadas e verifique-o no seu código. O Ocoya envia-o com cada pedido. Os pedidos não são assinados.

RXSe responder 429, 502, 503 ou 504, o Ocoya tenta de novo após 5 minutos, 30 minutos, 2 horas, 6 horas e 12 horas, desde que a publicação não saia com mais de 24 horas de atraso. Outros erros falham logo e mostram-lhe o estado e a mensagem do seu endpoint.

RXNão. O Ocoya só se liga a endereços públicos. Os endereços privados e internos são recusados.

RXEnvia uma imagem, a primeira imagem fixa da publicação, como ligação. O vídeo não é enviado.

Publique onde deve estar.

Ligue um destino num minuto e aponte a sua próxima campanha para ele.