Neste artigo
Onde: Definições → Avançadas → Associar outras aplicações
Abra esta página: admin.<your-site>/settings/integrations/webhooks (substitua <your-site> pelo endereço do seu site). Se não a vir no menu, ative a opção Mostrar todas as definições na página Definições.
Antes de começar
- Apenas o proprietário do site pode adicionar webhooks.
- O endereço de destino deve começar por https:// e estar acessível na internet pública.
Passo a passo
- Abra Definições → Avançadas → Ligar outras apps → Webhooks.
- Prima Adicionar webhook.
- Introduza um Nome, por exemplo Zapier, e o Endereço que recebe as mensagens.
- Em Enviar-me uma mensagem quando, selecione os eventos: Uma notícia é publicada, Uma notícia ativa é alterada, Uma notícia é retirada, É adicionada uma retificação, Uma notícia é desmentida, Um novo comentário, Uma subscrição é alterada.
- Prima Adicionar webhook.
- Copie a chave secreta de assinatura. Só a verá uma vez. Prima Já guardei.
- Teste em Enviar evento de teste.
Informações úteis
- Todas as mensagens são assinadas. Verifique o cabeçalho "Keynate-Signature" para ter a certeza de que vieram do seu site.
- O seu sistema responde com qualquer código 2xx para confirmar que recebeu a mensagem.
- As mensagens com falha são repetidas durante um máximo de 24 horas. Um webhook com falhas durante 3 dias é desativado. Corrija o sistema de destino e prima Retomar.
- Pode escolher Pausar, Retomar ou criar uma Novo segredo. A chave antiga continuará a assinar pelo período de tempo que definir.
- A lista mostra o estado de cada webhook: A funcionar, Ainda não utilizado, Com problemas, Em pausa, Desativado.
- Abra uma mensagem enviada para ver as tentativas de envio e prima Reenviar.
Problemas comuns
- "O endereço tem de começar por https://."
- "Dê um nome ao webhook."
- "Escolha pelo menos um evento."
- "Atingiu o limite de webhooks disponíveis. Elimine primeiro um que já não utilize."
Perguntas frequentes
Perguntas frequentes
Como é o formato de uma mensagem?
Um pequeno texto em JSON com o tipo de evento e os dados do artigo correspondente.
E se o meu sistema de receção estiver em baixo?
As mensagens com falha são enviadas novamente durante um período de até 24 horas.