Hoe stuur ik Altrady-alerts naar Discord of Telegram?

Altrady heeft geen Discord-knop en geen Telegram-schakelaar. In plaats daarvan heeft elke prijs-, tijd- of trendlijn alert een optie Webhook waarmee je een bericht rechtstreeks naar een Discord-kanaal of naar elke publieke URL die je zelf beheert kunt sturen. Het instellen kost ongeveer vijf minuten, en het detail waar de meeste mensen over struikelen is het formaat van het bericht, dus daar beginnen we.

De Webhook-optie vinden bij je alert

Open het handelsterminal en kijk naar de kolom rechts. Naast het tabblad Trading staat een tabblad genaamd Alerts, en daar maak je alerts aan. Dit is onderdeel van de standaardindeling, dus je hoeft niets toe te voegen of in te schakelen.

🔍 Click the image to see a larger version

In het tabblad Alerts kies je een van de drie type-tabbladen bovenaan (Price, Time, of Trend Line), en werk je het formulier van boven naar beneden af: Prijs, Trigger Type, Timeframe, Expires At, Geluid, Webhook en Notitie. De vervolgkeuzelijst Webhook staat net onder Geluid en heeft precies drie opties:

• Disabled: de alert wordt alleen binnen Altrady getoond, er wordt niets verzonden.
• Altrady Signal Bot: stuurt de alert naar het eigen signal-bot-endpoint van Altrady zodat die een bot kan activeren. Dit heeft niets met Discord te maken, dus laat dit staan tenzij je de alert aan een signal bot koppelt.
• External URL: dit is degene die je nodig hebt. Als je deze kiest, verschijnt er een veld Webhook URL waarin je het doel plakt.

Een ding om vooraf te weten: de vervolgkeuzelijst Webhook is uitgeschakeld zolang je in replaymodus zit.

Alerts naar Discord sturen

Hier komt het belangrijkste deel. Wanneer een alert afgaat, stuurt Altrady de ruwe inhoud van het veld Notitie als request body. Als je notitie gewone tekst is, wordt die als platte tekst verstuurd en weigert Discord het bericht. Om ervoor te zorgen dat Discord het bericht accepteert, schrijf je het veld Notitie zelf als JSON:

{"content": "{{symbol}} reached {{close}} on {{exchange}}"}

Met dat op zijn plaats werkt de hele flow zo:

1. Open in Discord de server en het kanaal waar je de alerts wilt ontvangen.
2. Ga naar de instellingen van het kanaal, dan Integrations > Webhooks, en maak een Incoming Webhook aan.
3. Kopieer de webhook-URL die Discord je geeft.
4. Zet in het tabblad Alerts de optie Webhook op External URL en plak die URL in Webhook URL.
5. Schrijf in Notitie de JSON hierboven en pas de tekst binnen "content" naar wens aan.

Er wordt niets verzonden totdat de alert daadwerkelijk afgaat, dus een leeg kanaal vlak na het opslaan is normaal.

Placeholders gebruiken in het bericht

Altrady vervangt deze placeholders door echte waarden op het moment dat de webhook afgaat. Het formulier vermeldt dit onder het veld Notitie: You can use {{exchange}}, {{symbol}}, {{direction}}, {{close}} and {{time}} as values that will be replaced when triggered. Er werken nog twee extra, dus de volledige set is:

{{exchange}}, {{symbol}}, {{direction}}, {{close}}, {{time}}, {{low}}, {{high}}

Bij tijd alerts hebben {{direction}} en {{close}} geen betekenis, omdat er geen prijskruising heeft plaatsgevonden. Laat die weg uit die notities.

En Telegram dan?

Altrady levert geen persoonlijke alerts aan Telegram. Altrady heeft wel een Telegram-bot die je rechtstreeks kunt berichten (die reageert op commando’s zoals /start, /suggest en /backtest, met een dagelijkse limiet op backtests), maar die staat los van je alerts en kan niet aan je account gekoppeld worden.

Om een Telegram-chat te bereiken, gebruik je een dienst die een webhook accepteert en doorstuurt, zoals Zapier, Make, of IFTTT: maak een automatisering die begint met een webhooktrigger, plak die URL in Webhook URL, en voeg een Telegram-actie toe die naar je chat post. Anders is een Discord-webhook of je eigen externe URL de directe route.

Controleren of de webhook is afgeleverd

🔍 Click the image to see a larger version

Elke afgegane alert legt het afleverresultaat vast. In de widget Mijn meldingen toont de kolom Webhook Success of Failed, en het info-icoon ernaast opent een pop-up met de HTTP Code, de Data die verstuurd werd met de placeholders al ingevuld, de Time, het Result dat door de bestemming werd teruggestuurd, en de Status. Een knop Copy webhook info kopieert alles. Die pop-up is de snelste manier om te zien of je Notitie als JSON of als platte tekst is verstuurd.

Twee dingen om verder te weten: aflevering verloopt na 5 seconden, en Altrady controleert de URL bij het opslaan op veiligheid en weigert private, interne en loopback-adressen. Er wordt niet gecontroleerd of het adres bereikbaar is, dus een URL kan probleemloos worden opgeslagen en toch mislukken bij aflevering.

Kom je er niet uit?

Als de kolom Webhook steeds Failed blijft tonen, open dan eerst de payload-pop-up en controleer het formaat van wat verstuurd is. Kom je er nog steeds niet uit, neem dan contact op via de supportchat in de app met de alert en de bestemmingsdienst, dan kan het team achterhalen waar het bericht vastloopt.