Kuandika ujumbe wa alert na kutumia webhooks

Kila alert hutuma ujumbe mmoja kwenda kila mahali ulipoteua. Peke yake, ujumbe huo husema kilichotokea, bei ya wakati huo na kama alert inaendelea kufanya kazi. Ongeza maelezo kuhusu mpango wako wa trading ili uone ulichopanga kabla hujafungua chati. Kuweka alert yako na ujumbe wake ni rahisi, haraka na sahihi. Uandike kwenye editor, au mwambie au muulize AI Trading Assistant kwa sauti au kwa maandishi.

Ikiwa unatumia programu yako mwenyewe, Discord au Slack, webhook hutuma kila alert huko pia, bila kunakili chochote kwa mkono. Mwongozo huu unafafanua yote mawili.

Ujumbe wa kiotomatiki unasema nini

Kisanduku cha Message kinapokuwa tupu, alert huandika ujumbe wake yenyewe inapolia. Kwa mfano huu, ujumbe unasomeka:

EURUSD crossed above 1.09
Price 1.0901.
This alert is now off. It was set to fire once.

Mstari wa kwanza unasema kilichotokea, kwa maneno ya editor ya alert. Mstari unaofuata unatoa namba za wakati huo. Mstari wa mwisho unasema kama alert inaendelea kufanya kazi. Mfano huu unatumia Once only, kwa hivyo alert sasa imezimwa. Kwa chaguo nyingine za Trigger, mstari wa mwisho unasomeka "This alert stays on.", yaani alert hii inaendelea kufanya kazi.

Alert nyingine hufuata mpangilio huohuo. Hii hapa ni mistari michache ya kwanza, kila mmoja ukiwa na mstari wa namba chini yake:

• Mstari: "GBPJPY touched 1h Resistance R1" na "Price 210.16, line at 210.20."

• Breakout ya mstari: "GBPJPY broke above 1h Resistance R1" na "The 1h candle closed at 210.32, above the line at 210.20."

• Indicator: "BTCUSD: 1h RSI(14) crossed above 70" na "RSI(14) was 71.4 when the 1h candle closed at 105240.50."

• Mabadiliko ya utabiri: "GBPJPY: 1h forecast turned bearish" na "Before: bullish above 209.80. Now: bearish below 209.40."

Alert yenye masharti kadhaa husema ni mangapi yametimia. Kisha hutoa mstari mmoja kwa kila sharti lililotimia:

BTCUSD: both conditions met
• Price crossed above 105000: the 1h candle closed at 105240.50
• 1h RSI(14) is above 55 (now 58.2)
This alert stays on.

Kukiwa na masharti zaidi, mstari wa kwanza unasomeka, kwa mfano, "all 3 conditions met" (masharti yote 3 yametimia) au "2 of 3 conditions met" (masharti 2 kati ya 3 yametimia). Sharti moja pekee linapotimia, kwa mfano ukitumia kiunganishi cha or, mstari wa kwanza hutaja sharti hilo, na namba zake hufuata.

Kuandika ujumbe

1. Fungua editor ya alert na uende kwenye kichupo cha Options.

2. Bofya safu ya Message. Inaonyesha Auto inapokuwa tupu. Kisanduku cha maandishi hufunguka chini yake.

3. Andika ujumbe wako. Kisanduku hicho kinachukua hadi herufi 400.

4. Ili kuongeza thamani ya sasa, fungua Available variables chini ya kisanduku hicho. Nakili variable kama ilivyo, pamoja na mabano yake mawili ya double curly braces.

Maneno yako yanakuwa mstari wa kwanza, na maandishi ya kiotomatiki yanayafuata. Kwa mfano huu, ujumbe huu:

{{symbol}} on {{timeframe}}: check the 1h trend before entering.

hufika hivi:

EURUSD on 5m: check the 1h trend before entering.
EURUSD crossed above 1.09. Price 1.0901.
This alert is now off. It was set to fire once.

Bei na sharti tayari viko kwenye mistari iliyo chini ya maneno yako. Tumia ujumbe wako kwa mambo ambayo mistari hiyo haiwezi kusema, kama vile mpango wako wa trading.

Ujumbe unaouandika pia huwa jina la alert kwenye orodha ya Alerts. Bila ujumbe huo, orodha huonyesha jina lililoundwa kutokana na sharti. Kwa level ya bei jina ni fupi, kama vile "EURUSD crossing up 1.09". Mstari au masharti kadhaa husomeka kama editor inavyoyaandika, kama vile "GBPJPY: 1h Price touches 1h Resistance R1". Unapobadilisha sharti, jina hili hubadilika pamoja nalo. Unapofungua alert tena, kisanduku cha Message bado kinakuwa tupu. Alert ulizohifadhi awali bila ujumbe huonyesha majina yao kwa muundo huu pia.

Kila mahali pa kufikisha panaonyesha nini

Kila mahali hupata ujumbe uleule, ukiwa umepangwa kwa ajili ya mahali hapo:

Mahali	Kinachoonyeshwa
Arifa ndani ya programu	Mstari wa kwanza kwa maandishi mazito, ukiwa na namba chini yake.
Notify my devices	Mstari wa kwanza kama kichwa, ukiwa na mistari mingine chini yake.
Send to MetaTrader	Mstari wa kwanza kama kichwa, ukiwa na mistari mingine chini yake. MetaTrader huonyesha muda wake yenyewe pembeni ya ujumbe.
Telegram	Ujumbe, muda katika saa za eneo lako na kiungo cha kwenda kwenye chati.
Send email	Ujumbe, pamoja na tarehe na muda katika saa za eneo lako.
Webhook URL	Discord na Slack hupata ujumbe ukiwa na muda katika UTC. Ukitumia Raw JSON, programu yako hupata variables zilizo hapa chini.

Telegram huandika muda hivi: "24 Sep, 11:02 London time". Ikiwa saa za eneo si sahihi, chagua zako chini ya Timezone kwenye ukurasa wa Your profile. ForecastCity isipojua saa za eneo lako, muda huonyeshwa kwa UTC.

Kiungo kilicho kwenye ujumbe wa Telegram, barua pepe, arifa ya simu au dirisha ibukizi la MetaTrader hufungua chati ya symbol hiyo pamoja na paneli ya Alerts. Kwa alert nyingi za 4CM-AI, hufungua chati pamoja na Alert observation ya wakati alert hiyo ilipolia.

Kuongeza thamani za sasa kwa kutumia variables

Variable hubadilishwa na kuwekwa thamani yake wakati alert inapolia. Hizi ndizo variables zilizoko kwenye Available variables:

Variable	Inachoandika	Mfano
{{symbol}}	Symbol	EURUSD
{{price}} na {{close}}	Bei wakati alert ilipolia	1.0901
{{condition_text}}	Kilichotokea, bila symbol	Price crossed above 1.09
{{condition}}	Sharti kama msimbo mfupi	CROSSING_UP 1.09
{{timeframe}}	Timeframe ya alert	5m
{{time_iso}}	Tarehe na muda, kwa UTC	2026-09-24 10:02 UTC
{{time}}	Muda huohuo kama idadi ya sekunde, kwa ajili ya programu	1790244120
{{time_now}}	Wakati ujumbe ulipotumwa, kama namba	1790244121
{{exchange}}	Mahali bei zinapotoka	TwelveData
{{status}}	Kama alert inaendelea kufanya kazi	This alert stays on.
{{alert_url}}	Kiungo cha kwenda kwenye chati ya symbol hiyo, pamoja na alert zako	anwani ya wavuti
{{name}}	Ujumbe wako ukiwa na kila variable imebadilishwa na thamani yake, au jina linaloonyeshwa kwenye orodha ya Alerts	EURUSD crossing up 1.09

Kwa mstari, {{condition_text}} husomeka kama "Price touched 1h Resistance R1". Kukiwa na masharti kadhaa, huunganisha masharti yaliyotimia kwa kutumia neno and. Baada ya alert ya Once only kulia, {{status}} husomeka "This alert is now off. It was set to fire once." Kwa alert yenye masharti kadhaa, mstari au indicator, {{condition}} husomeka TREE. Variable hii ni msimbo kwa ajili ya programu.

Kwa alert za 4CM-AI, {{forecast_summary}} hutoa muhtasari wa kile utabiri ulichofanya na {{forecast_symbol}} hutaja symbol ya utabiri huo. {{forecast_cycle}} ni kihesabu kinachoongezeka kila wakati alert inapoanza kufuatilia tena. Ujumbe ulio na {{forecast_summary}} haupati mistari ya kiotomatiki chini yake, kwa sababu muhtasari huo tayari unasema kilichotokea.

{{price}} na {{close}} hubaki tupu kwa alert nyingi za 4CM-AI, kwa sababu hazina bei moja pekee. {{time_iso}} hutumia UTC, kwa hivyo inaweza kutofautiana na saa iliyo kwenye skrini yako. Variable isiyokuwepo hubaki kama ulivyoichapa: ukikosea kuandika {{prices}} itafika kama {{prices}}.

Kutuma alert kwenye webhook

Webhook hutuma kila alert kwenye anwani ya wavuti, ambapo programu yako mwenyewe, chaneli ya Discord au chaneli ya Slack huipokea. Mpango wako wa usajili lazima uwe unajumuisha webhooks.

1. Kwenye kichupo cha Options, chini ya Notifications, teua Webhook URL. Kisanduku cha anwani, chaguo la Format na kisanduku cha body huonekana.

2. Bandika anwani ambayo mpokeaji wako anasikiliza. Lazima ianze na http:// au https://.

3. Weka Format kwenye Raw JSON na uache kisanduku cha body kikiwa tupu.

4. Bonyeza kitufe cha Create, au Save kwa alert uliyoihariri.

Kisanduku cha body kinapokuwa tupu, mpokeaji wako hupata JSON object yenye kila variable kutoka kwenye jedwali, pamoja na alertId na triggerId. Hizi mbili hutambulisha alert na mlio huu mmoja. Angalia uwasilishaji mmoja halisi kabla ya kuunda chochote kinachotegemea sehemu zake.

Chini ya kisanduku hicho, editor huonyesha anwani ya seva ambako maombi yetu yanatoka. Iongeze kwenye allowlist yako ikiwa mpokeaji wako anakubali tu anwani zinazojulikana.

Anwani inahitaji nini

• Anwani ya umma kwenye port ya kawaida: 80 kwa http, 443 kwa https. Ujumbe kwenda kwenye port nyingine, localhost au anwani ya mtandao wa faragha hautumwi.

• Isiwe na jina la mtumiaji wala nenosiri ndani ya anwani.

• Jibu ndani ya sekunde 3, kutoka kwenye anwani hiyohiyo. Kuelekezwa upya (redirect) kwenda kwenye anwani nyingine huhesabiwa kuwa imeshindikana.

Editor hukagua tu kwamba anwani inaanza na http:// au https://. Mahitaji mengine hukaguliwa wakati ujumbe unapotoka, kwa hivyo jaribu anwani yako kwa alert halisi. Kwa alert za bei na za kiufundi, ikiwa mpokeaji wako ana hitilafu ya muda, ujumbe hujaribiwa tena hadi mara mbili zaidi. Ujumbe wa alert ya 4CM-AI hautumwi tena baada ya muda kuisha (timeout) au hitilafu ya seva, kwa sababu mpokeaji wako anaweza kuwa tayari amechukua hatua.

Kuandika body yako mwenyewe ya webhook

Kisanduku cha body huchukua kiolezo chenye variables zilezile kama za ujumbe. Kinaweza kuchukua hadi herufi 2000. Kisanduku kinakuruhusu kuandika zaidi, lakini body ndefu zaidi hukataliwa unapohifadhi.

Kwa Raw JSON, mpokeaji anayetarajia object ndogo anaweza kupata body hii:

{"symbol":"{{symbol}}","condition":"{{condition_text}}","time":"{{time_iso}}","source":"ForecastCity"}

Variables hujazwa kama maandishi ya kawaida. Thamani iliyo na alama za mnukuo au mstari mpya inaweza kuharibu JSON yako. Body ambayo si JSON halali hutumwa kama maandishi ya kawaida.

Kwa chaneli ya Discord, weka Format kwenye Discord na utumie anwani ya webhook ya chaneli hiyo. Kisha andika mstari mfupi kwenye kisanduku cha body, kwa mfano:

{{symbol}}: {{condition_text}}. Open your alerts: {{alert_url}}

Kwa Slack, chagua Slack na uandike kwa njia hiyohiyo. ForecastCity hufunga maandishi yako katika muundo ambao kila huduma inatarajia. Kisanduku kikiwa tupu, zote mbili hupata ujumbe wa alert, kama ilivyoonyeshwa hapo juu, ukiwa na muda kwa UTC kwenye mstari wake wa mwisho.

Kukagua matokeo

1. Subiri alert ilie, kisha ufungue kichupo cha Log cha paneli ya Alerts.

2. Linganisha alichopata mpokeaji wako na rekodi ya kwenye Log: kilichotokea, symbol na muda.

Log huonyesha kuwa alert ililia. Haionyeshi kama mpokeaji wako aliukubali ujumbe huo, kwa hivyo kagua kumbukumbu za mpokeaji mwenyewe pia. Ukiona mabano kama vile {{prices}}, jina la variable limekosewa kuandikwa. Ikiwa mpokeaji wako anakataa body, kagua JSON.

Vizuri kujua

• Ujumbe huenda kila mahali ulipoteua. Body ya webhook huenda kwenye webhook pekee.

• Discord huonyesha hadi herufi 1900 na Slack hadi 3000. Maandishi marefu zaidi hukatwa.

Miongozo inayohusiana

• Kuchagua mahali alert yako inapofika

• Kujua kwa nini alert haikufika

• Kuunda alert yako ya kwanza ya bei