Nesta matéria
Onde: Configurações → Avançado → Conectar outros apps
Abra esta página: admin.<your-site>/settings/integrations/webhooks (troque <your-site> pelo endereço do seu site). Se não encontrar no menu, ative a opção Mostrar todas as configurações na página de Configurações.
Antes de começar
- Apenas o dono do site pode adicionar webhooks.
- O endereço de destino precisa começar com https:// e estar disponível na internet pública.
Passo a passo
- Abra Configurações → Avançado → Conectar outros apps → Webhooks.
- Toque em Adicionar webhook.
- Digite um Nome, como Zapier, e a Endereço que recebe as mensagens.
- Em Enviar uma mensagem quando, marque os eventos: Uma matéria entra no ar, Uma matéria no ar é alterada, Uma matéria é retirada do ar, Uma correção é adicionada, Uma matéria é retratada, Um novo comentário, Uma assinatura muda.
- Toque em Adicionar webhook.
- Copie o segredo de assinatura. Ele só aparece uma vez. Toque em Já salvei.
- Teste com Enviar evento de teste.
Importante saber
- Cada mensagem é assinada. Confira o cabeçalho "Keynate-Signature" para ter certeza de que ela veio do seu site.
- O seu sistema deve responder com qualquer status 2xx para confirmar o recebimento.
- Mensagens com falha são reenviadas por até 24 horas. Um webhook com falhas contínuas por 3 dias é desativado. Corrija o sistema de destino e toque em Retomar.
- Você pode Pausar, Retomar ou criar uma Novo segredo. O segredo antigo continua assinando pelo tempo que você definir.
- A lista exibe o status de cada webhook: Funcionando, Ainda não usado, Com problema, Pausado, Desativado.
- Abra uma mensagem enviada para conferir as tentativas e toque em Enviar de novo.
Problemas comuns
- "O endereço precisa começar com https://."
- "Dê um nome ao webhook."
- "Escolha pelo menos um evento."
- "Você atingiu o limite de webhooks permitidos. Exclua um que não usa mais antes de continuar."
Dúvidas frequentes
Perguntas frequentes
Como é o formato da mensagem?
É um texto simples em JSON com o tipo de evento e as informações do post relacionado.
E se o meu sistema estiver fora do ar?
As mensagens que falharem serão reenviadas por até 24 horas.