ProgramadoresPublique em tudo o que é seu.
Um destino personalizado é uma rede que o Ocoya não precisa de conhecer. Indique um URL e ele recebe o seu conteúdo final em JSON — tal como uma publicação vai para o Instagram, só que do outro lado está você.
O destino para tudo o resto.
A maior parte do que se publica vai para uma rede com logótipo. Isto é para o resto.
O seu próprio blogue
Os artigos escritos no Ocoya chegam ao CMS que já usa — Ghost, Strapi, Sanity, algo que construiu.
Uma rede que não suportamos
Receba a publicação e reencaminhe-a você mesmo. Tudo o que tenha uma API pode ser alcançado a partir do seu código.
Um passo de aprovação seu
Encaminhe o conteúdo publicado para uma fila de revisão, um canal do Slack ou uma folha de cálculo antes de seguir para outro lado.
Os seus próprios registos
Guarde uma cópia de tudo o que é publicado, no seu data warehouse, sem consultar uma API para isso.
Um URL, um nome e, normalmente, um cabeçalho.
Não há dança de OAuth, porque as duas pontas são suas. Cole o endereço, adicione o cabeçalho com que o seu endpoint se autentica e ele aparece no editor ao lado dos seus perfis sociais.
- Qualquer URL que aceite um POST e responda 2xx
- Cabeçalhos para o que quer que o seu endpoint use na autenticação
- Aparece no editor como qualquer outro perfil
Ligar um destino personalizado
Nome
URL do webhook
Opções avançadas
Quatro passos, e nenhum é uma semana de programação.
Tenha onde o receber
Qualquer URL que aceite um POST com corpo JSON e responda 2xx. Tem de estar acessível a partir da internet — o Ocoya liga-se a partir do nosso lado, não do seu navegador.
Adicione o destino
Integrações → Custom. Dê-lhe um nome que reconheça no editor e cole o URL.
Adicione um cabeçalho, se for preciso
Em Opções avançadas, adicione o cabeçalho com que o seu endpoint se autentica — normalmente Authorization ou X-API-Key. Fica guardado encriptado e nunca é devolvido ao navegador.
Publique nele como numa rede
Aparece no editor ao lado dos seus perfis sociais. Agende uma publicação, ou aponte uma campanha de blogue para ele, e recebe tudo o que o editor guardou.
Um POST, só com o que um blogue precisa.
O corpo é JSON: o título, a legenda exatamente como foi escrita — em Markdown, se for um artigo —, uma imagem de capa e o slug, o excerto, as etiquetas e os campos de SEO do artigo, quando os tem. Mais nada, por isso não há nada para ignorar.
- Content-Type: application/json, mais os cabeçalhos que adicionou
- caption é o corpo tal como foi escrito; title e image vêm à parte
- post.id mantém-se igual entre novas tentativas, por isso pode atualizar em vez de duplicar
Responda com um 2xx e o Ocoya marca a publicação como publicada. Qualquer outra resposta é-lhe mostrada com o corpo que o seu endpoint devolveu.
Todos os campos, com o respetivo tipo
O slug, o excerto, os campos de SEO, as etiquetas e o tempo de leitura que um artigo traz — o que é cada um, e quais deles uma publicação social deixa de fora.
O endpoint é seu, e ligamo-nos com cuidado.
Um destino é um endereço a que nos ligamos a partir da nossa própria rede, por isso é tratado como tal.
Endereços privados e internos são recusados, e a ligação fica presa ao endereço para o qual foi resolvida.
Um redirecionamento só é seguido depois de o novo endereço passar na mesma verificação.
Os seus cabeçalhos ficam guardados encriptados e nunca são devolvidos ao navegador.
O que quer que o seu endpoint responda aparece no registo de atividade, com o corpo incluído.
Publique onde fizer sentido.
Ligue um destino num minuto e aponte a sua próxima campanha para ele.