--- title: "Kuandika ujumbe wa alert na kutumia webhooks" slug: "webhooks-and-messages" kind: "HELP_ARTICLE" category: "alerts" locale: "sw" canonical: "https://app.forecastcity.com/sw/help/alerts/webhooks-and-messages" published: "2026-09-08T17:58:35.210Z" updated: "2026-10-28T00:14:49.704Z" description: "Ona ujumbe wa alert unavyosema, ongeza maneno yako na variables, na utume alert kwenye programu yako, Discord au Slack kwa webhook." --- # 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. Mfano: alert kwenye EURUSD inayolia bei inapovuka juu ya 1.09 kwenye chati ya 5m. ## 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. ![Safu ya Message ikiwa wazi kwenye kichupo cha Options, ikiwa na kisanduku tupu, mstari chini yake na Available variables.](https://m.forecastcity.com/t/tnt_forecastcity/media/b4/b480142e20ce43cec05e3313cedc9941ceea0b334c3b3dda3ae8680099c0f69b.png) Kisanduku cha Message, kikiwa wazi na bado tupu, kwa hivyo alert inatuma ujumbe wake wa kiotomatiki. 1. **Automatic message**: kisanduku tupu. Andika maneno yako hapa, au kiache tupu. 2. Mstari ulio chini ya kisanduku: "Leave it blank and the alert says what happened and at what price. A message of your own is sent first, with that under it.", yaani ukiacha tupu alert inaeleza kilichotokea na kwa bei gani, na ujumbe wako mwenyewe unatumwa kwanza ukifuatiwa na maelezo hayo chini yake. 3. **Available variables**: thamani za sasa unazoweza kuongeza kwenye ujumbe wako. 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:
MahaliKinachoonyeshwa
Arifa ndani ya programuMstari wa kwanza kwa maandishi mazito, ukiwa na namba chini yake.
Notify my devicesMstari wa kwanza kama kichwa, ukiwa na mistari mingine chini yake.
Send to MetaTraderMstari wa kwanza kama kichwa, ukiwa na mistari mingine chini yake. MetaTrader huonyesha muda wake yenyewe pembeni ya ujumbe.
TelegramUjumbe, muda katika saa za eneo lako na kiungo cha kwenda kwenye chati.
Send emailUjumbe, pamoja na tarehe na muda katika saa za eneo lako.
Webhook URLDiscord 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**:
VariableInachoandikaMfano
{{symbol}}SymbolEURUSD
{{price}} na {{close}}Bei wakati alert ilipolia1.0901
{{condition_text}}Kilichotokea, bila symbolPrice crossed above 1.09
{{condition}}Sharti kama msimbo mfupiCROSSING_UP 1.09
{{timeframe}}Timeframe ya alert5m
{{time_iso}}Tarehe na muda, kwa UTC2026-09-24 10:02 UTC
{{time}}Muda huohuo kama idadi ya sekunde, kwa ajili ya programu1790244120
{{time_now}}Wakati ujumbe ulipotumwa, kama namba1790244121
{{exchange}}Mahali bei zinapotokaTwelveData
{{status}}Kama alert inaendelea kufanya kaziThis alert stays on.
{{alert_url}}Kiungo cha kwenda kwenye chati ya symbol hiyo, pamoja na alert zakoanwani ya wavuti
{{name}}Ujumbe wako ukiwa na kila variable imebadilishwa na thamani yake, au jina linaloonyeshwa kwenye orodha ya AlertsEURUSD 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. ![Safu ya Webhook URL ikiwa imeteuliwa, ikiwa na anwani, kichaguzi cha format kwenye Raw JSON na kisanduku tupu cha body.](https://m.forecastcity.com/t/tnt_forecastcity/media/9e/9e711afc65b24ebfe70a8e091cc4006b5f9d7d57d50d61b67e5ee920f8ab4877.png) Webhook URL ikiwa imeteuliwa, pamoja na anwani na Format ikiwa imewekwa kwenye Raw JSON. Kisanduku tupu cha body hutuma data chaguomsingi. 1. Anwani ambayo mpokeaji wako anasikiliza. Tumia port za kawaida, 80 au 443. 2. **Format**: Raw JSON kwa ajili ya programu yako mwenyewe, au Discord au Slack kwa huduma hizo. 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]()