# Arifa za Mchunguzi, webhooks, Copilot na API

Source: https://help.didit.me/sw/investigations/investigator-alerts-and-integrations
Updated: 2026-10-23

Arifiwa kundi likiwa tayari kukubaliwa, tuma arifa kwenye Slack au Teams, pokea matukio ya Mchunguzi kwenye webhooks, na umwendeshe kwa MCP kwa idhini yako.

Katika **Mchunguzi → Mipangilio → Arifa za Slack na Teams**, bandika URL ya incoming webhook ya chaneli ya Slack au Microsoft Teams na ubonyeze **Tuma jaribio**. Sajili vituo vyako vya webhook kwa matukio ya `investigator` katika **Webhooks**. Mwombe Didit Copilot afungue au akubali ripoti: daima huomba idhini yako kabla ya kuamua chochote.

> **Note:** Vipengele hivi vinatolewa kimoja kimoja na huenda bado havijawashwa kwa programu yako. Unaweza kuongeza chaneli ya Slack au Teams kabla arifa hazijawashwa: hakuna kinachotumwa hadi ziwashwe.

## Arifa za kundi lililo tayari

Mapendekezo 5 au zaidi yenye uhakika wa juu yanaposubiri kukubaliwa, Mchunguzi huiarifu timu yako kwa barua pepe na kwenye dashibodi, si zaidi ya mara moja kila saa 4, pamoja na kiungo kinachofungua foleni kwenye kundi hilo. Arifa huenda kwa watu wanaoonyeshwa chini ya **Nani anaarifiwa** katika hatua ya **Kagua na uwashe** ya usanidi. Orodha hiyo ni ya kusoma tu kwenye dashibodi: kwa chaguo la mwanzo kila mwanachama wa shirika lako huarifiwa, na ni wanachama pekee wanaoarifiwa. Mapendeleo ya arifa na saa za utulivu za kila mtu hutumika kama kawaida.

## Arifa za Slack na Teams

Ongeza chaneli moja kwa kila programu: bandika URL ya incoming webhook ya chaneli, bonyeza **Ongeza chaneli**, kisha **Tuma jaribio** ili kuhakikisha ujumbe unafika. URL lazima iwe kiungo cha https cha chaneli ya Slack au Microsoft Teams. Huhifadhiwa ikiwa imesimbwa na haionyeshwi tena; bonyeza **Ondoa** ili kuacha kutuma.

Chaneli hupokea ujumbe pale:

| Arifa | Lini |
|---|---|
| **Kundi liko tayari kukubaliwa** | Mapendekezo 5 au zaidi yenye uhakika wa juu yanasubiri, si zaidi ya kila saa 4 |
| **Kushuka kwa uthabiti** | Foleni ilirudia pendekezo lake katika chini ya 90% ya marudio |
| **Mabadiliko ya tabia** | Foleni ilibadilika tabia na kiwango chake kikashushwa |

Arifa hubeba idadi na viungo tu, kamwe data za mtu.

## Matukio ya webhook

Vituo vyako vya webhook vinaweza kupokea matukio ya Mchunguzi, yaliyotiwa saini na kujaribiwa tena kama kila webhook nyingine ya Didit. Jisajili kwao katika **Webhooks**:

| Tukio | Hutumwa pale |
|---|---|
| `investigator.report.ready` | Ripoti iliandikwa |
| `investigator.decision.automated` | Mchunguzi aliamua rekodi mwenyewe |
| `investigator.decision.overridden` | Mtu alichukua hatua tofauti na ile ya ripoti, au alibatilisha uamuzi wa kiotomatiki |
| `investigator.question.raised` | Mchunguzi aliiuliza timu yako kuhusu sera yake |
| `investigator.automation.paused` | Uendeshaji wa kiotomatiki ulisitishwa, na mtu au kwa kufikia kikomo cha matumizi ya mwezi |
| `investigator.rfi.answered` | Mtu alijibu ombi la taarifa |
| `investigator.rfi.overdue` | Ombi la taarifa lilipita muda wake wa mwisho bila kujibiwa |
| `investigator.decision.contested` | Mtu alipinga uamuzi |
| `investigator.drift.detected` | Foleni ilibadilika tabia na kushuka kiwango kimoja |
| `investigator.sla.breached` | Ripoti ilisubiri kupita kiwango cha huduma cha foleni yake |
| `investigator.qa.failed` | Uamuzi uliofanywa na mtu ulishindwa ukaguzi wa ubora |
| `investigator.external.report.ready` | Ripoti kuhusu rekodi iliyotumwa kutoka nje ya Didit iko tayari |

Matukio hubeba vitambulisho, foleni, pendekezo, hatua na asili tu, kamwe jina la mtu, sababu ya mkaguzi au maelezo ya tukio. Matukio ya hali ya uthibitishaji na uthibitishaji wa kampuni pia husema nani aliamua, katika `decided_by`: `investigator` alipoamua mwenyewe, `human` mtu alipoamua. Maudhui ya matukio yamo katika [nyaraka za wasanidi programu](https://docs.didit.me). Tazama pia [misingi ya webhooks](https://help.didit.me/sw/integration/webhooks-basics).

## Didit Copilot

Didit Copilot anaweza kukuendeshea Mchunguzi: kuorodhesha foleni, kufungua ripoti na kuieleza, kujibu swali, kuanzisha jaribio la historia au kusoma utendaji. Unapomwomba akubali, abatilishe au akubali kwa kundi, huonyesha kadi ya idhini yenye hatua kamili, na hakuna kinachoamuliwa hadi uidhinishe. Maamuzi yanayofanywa kwa njia hii huwekwa alama **kupitia Copilot** katika **Shughuli**. Anaweza pia kuongeza dokezo kwenye rekodi na, baada ya wewe kuidhinisha kwenye kadi ya aina hiyo, kumwomba Mchunguzi aipitie rekodi hiyo upya. Pia hufikia vichupo vingine: kusitisha otomatiki, uhuru wa kufanya kazi, mipangilio, sera na SOP, na ukaguzi anaouanzisha, kila kimoja kwenye kadi ya aina hiyo. Tazama [tumia Didit Copilot katika Mchunguzi](https://help.didit.me/sw/didit-copilot/copilot-in-the-investigator).

## MCP

Seva ya Didit MCP humpa msaidizi wako wa AI zana zilezile za Mchunguzi: foleni, ripoti, maswali, majaribio ya historia, dashibodi, utendaji na Shughuli, pamoja na kuongeza dokezo kwenye rekodi na kuomba ipitiwe upya. Kukubali, kubatilisha na kukubali kwa kundi huwekwa alama kuwa hatua zenye athari zisizorudishwa na hukataa kuendeshwa hadi msaidizi wako athibitishe kwamba uliidhinisha hatua hiyo hasa. Maamuzi yanayofanywa kwa njia hii huwekwa alama **kupitia MCP** katika **Shughuli**. Zana hufanya kazi kwa niaba yako, kwa ruhusa za jukumu lako: kuamua rekodi kunahitaji ruhusa ya kuandika kwenye rekodi hiyo.

## Tuma rekodi kutoka nje ya Didit

Ikiwa sehemu ya ukaguzi wako hufanyika nje ya Didit, kwa mfano uthibitishaji kutoka kwa mtoa huduma mwingine au arifa kutoka kwenye ufuatiliaji wako mwenyewe wa miamala, unaweza kumtumia Mchunguzi rekodi hizo kupitia API. Hukagua kila moja dhidi ya kanuni zako za uthibitishaji au miamala na huandika ripoti unayoisoma kupitia API au kuipokea kama webhook ya `investigator.external.report.ready`. Rekodi hizi kamwe haziamuliwi na Didit na kamwe hazitozwi. Nyaraka za wasanidi programu zinaeleza muundo.

Kwenye dashibodi, weka kichujio cha **Chanzo** cha foleni kuwa **Ya nje (API)** ili kuziona chini ya **Vipengee vya nje**. Kila rekodi huonyesha kama ni rekodi ya **Utambulisho** au ya **Muamala**, hali yake (**Kwenye foleni**, **Kinakaguliwa**, **Kimekaguliwa** au **Kimeshindwa**) au, ikishakaguliwa, pendekezo lake, kile ambacho mfumo mwingine uliwekea alama, na kile sera yako inachosema pamoja na kanuni ilizotumia. Ripoti yake ni pendekezo tu, kamwe si uamuzi. **Jinsi ya kutuma vipengee kwa API** hufungua nyaraka za wasanidi programu.

## API

Kila kitu kwenye kurasa za Mchunguzi kinapatikana pia kupitia API ya Mchunguzi, kwa ufunguo wa API wenye ruhusa ya maamuzi (kusoma na kuamua rekodi) au ya programu (kubadili usanidi). Tazama [nyaraka za wasanidi programu](https://docs.didit.me).
