Sobre webhooks
Os webhooks permitem enviar uma solicitação POST para um determinado URL toda vez que o alerta é acionado. Esse recurso pode ser ativado quando você cria ou edita um alerta. Adicione o URL correto ao seu aplicativo e enviaremos uma solicitação POST assim que o alerta for acionado, com a mensagem de alerta no corpo da solicitação. Se a mensagem de alerta for JSON válida, enviaremos uma solicitação com um cabeçalho do tipo de conteúdo "application/json". Caso contrário, enviaremos "text/plain" como um cabeçalho do tipo de conteúdo.
Aviso de Segurança Importante: Ao configurar webhooks, certifique-se de não incluir informações confidenciais, como credenciais de login ou senhas, no corpo do webhook. A transmissão de dados confidenciais por meio de webhooks pode expô-los a terceiros não autorizados e levar a vulnerabilidades de segurança. Sempre use endpoints seguros e autenticados e criptografe dados sensíveis para proteger suas informações.
Aqui segue uma lista de endereços IP que usaremos para enviar solicitações POST, caso precisem receber permissão
- 52.89.214.238
- 34.212.75.30
- 54.218.53.128
- 52.32.178.7
Se você deseja enviar uma solicitação para um URL com um número de porta, observe que só aceitamos URLs com os números de porta 80 e 443. A solicitação no URL com qualquer outro número de porta será rejeitada. Se um servidor remoto processar uma solicitação por mais de 3 segundos, a solicitação será cancelada.
Lembre-se de que muitos aplicativos e serviços esperam receber dados de webhooks no formato JSON (e não o texto sem formatação que temos na mensagem de alerta por padrão). Antes de enviar uma solicitação, leia a documentação do aplicativo ou serviço correspondente e formate sua mensagem de alerta corretamente. Você pode descobrir mais sobre o formato JSON no wiki.
Por exemplo, o Slack aguarda uma mensagem formatada em JSON com um "texto" como chave. Você pode digitar em uma caixa de mensagem:
{"text": "BTCUSD maior que 9000"}
Como a mensagem é um JSON válido, enviaremos uma solicitação com um cabeçalho do tipo de conteúdo "application/json". Veja como será a solicitação usando cURL:
curl -H 'Content-Type: application/json; charset=utf-8' -d '{"text": "BTCUSD Greater Than 9000"}' -X POST https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXXSe sua mensagem estiver em texto sem formatação (por exemplo, você estiver usando uma mensagem de alerta padrão), enviaremos uma solicitação com um cabeçalho do tipo de conteúdo "texto sem formatação".
cURL:
curl -H 'Content-Type: text/plain; charset=utf-8' -d 'BTCUSD Greater Than 9000' -X POST https://webhook.site/testPara sua proteção de dados, o uso de webhooks de alerta só é permitido com a autenticação de dois fatores ativada.