Meldingen per mail en Slack¶

Artific meldt de beheerders van een organisatie wat ze moeten oppakken: een budget dat bijna op is, een webhook die geen events meer ontvangt, een koppeling die niet meer werkt, wat er het afgelopen kwartier mislukte, wat de vorige maand kostte, en een model dat wordt uitgefaseerd terwijl de organisatie het nog gebruikt. Dat gaat per mail, in een Slack-kanaal, of allebei.

Je stelt dit in op de kaart Meldingen, op het tabblad Limieten & meldingen van de instellingen van de organisatie. Alles wat je op de kaart verandert, sla je op met Opslaan in de balk onderaan.

Meldingsadressen¶

Een organisatie heeft een lijst van hoogstens tien adressen.

1. Vul onder Meldingsadressen een adres in en kies Adres toevoegen. Herhaal dat voor elk volgend adres.
2. Haal een adres weg met het prullenbakje erachter.
3. Kies Opslaan in de balk onderaan.

Elk adres is goed: een gedeelde teammailbox, of iemand die geen account in de console heeft. Een nieuw adres krijgt geen bevestigingsmail en hoeft niets te bevestigen; het ontvangt meldingen zodra je hebt opgeslagen. Controleer het adres dus zelf.

Een melding is één mail met alle adressen van de lijst in het veld Aan. De ontvangers zien elkaars adres.

Een eigen lijst, of die van boven¶

Een organisatie met een eigen lijst wordt daar gemaild en nergens anders. Een organisatie zonder eigen adressen neemt de hele lijst over van de dichtstbijzijnde organisatie erboven die er een heeft. Lijsten worden nooit samengevoegd: zodra je hier één adres instelt, vervalt voor deze organisatie de hele lijst van boven.

Een reseller die zijn adressen één keer instelt, hoort zo over al zijn klantorganisaties, en een klant die eigen mail wil, stelt een eigen lijst in. Heeft niemand op weg naar boven een adres, dan gaat er geen mail uit.

Onder de lijst staat achter Mail gaat naar waar de mail van deze organisatie echt heen gaat. Is de lijst overgenomen van een organisatie die je beheert, dan staat erbij van welke; hoort ze bij een organisatie buiten je bereik, dan zie je alleen de adressen.

Verwijder je al je eigen adressen, dan geldt weer de lijst van boven.

Een Slack-kanaal¶

Artific kan dezelfde meldingen in een Slack-kanaal plaatsen. Daarvoor plak je het adres van een inkomende webhook van Slack: een adres dat Slack je geeft en waarmee berichten in één kanaal geplaatst kunnen worden.

Slack wordt in de Verenigde Staten gehost. Een bericht in Slack bevat hetzelfde als de mail: de naam van de organisatie, de naam van een sleutel, bedragen in euro, de naam van een connector of index en het id van een webhook, en een link naar de console. Bepaal of die gegevens voor jouw organisatie de EU mogen verlaten voordat je een webhook instelt.

Slack is alleen beschikbaar als de operator van je omgeving het heeft aangezet. Staat het uit, dan zegt de kaart dat onder Slack, legt ze uit dat er geen webhook kan worden opgeslagen en niets wordt geplaatst, en is er geen veld. Vraag je operator het aan te zetten.

Zo stel je het kanaal in:

1. Maak in Slack één inkomende webhook voor het ene kanaal waar de meldingen moeten komen. De documentatie van Slack over inkomende webhooks beschrijft de stappen.
2. Kopieer het adres dat Slack je geeft. Het begint met https://hooks.slack.com/services/; een ander adres weigert Artific.
3. Plak het in de console in het veld Slack-webhookadres en kies Opslaan in de balk onderaan. Het veld verbergt wat je plakt.
4. Sta de host van Slack toe. Een organisatie bereikt geen enkele host tot haar eigen beleid die toestaat, en dat geldt ook voor hooks.slack.com. Open het tabblad Toegang & policy, kies Host toevoegen op de kaart Toegestane hosts, vul hooks.slack.com in en kies Host toestaan. Een organisatie waarvan het beleid al elke host toestaat, slaat deze stap over. Heeft de organisatie erboven het sleutelbeheer aan zichzelf voorbehouden (Wat de organisatie erboven voorbehoudt), dan kun je deze kaart niet wijzigen: vraag haar beheerder de host toe te staan.

Zolang de host niet is toegestaan, staat de webhook als ingesteld op de kaart en wordt er niets geplaatst. De kaart zegt dat onder de Slack-status: "hooks.slack.com is niet toegestaan in het beleid van deze organisatie, dus er wordt niets in Slack geplaatst zolang dat zo blijft." De link Toestaan naast die regel opent de kaart Toegestane hosts. Is de host toegestaan, dan staat er "hooks.slack.com is toegestaan. Een organisatie die haar regio's beperkt, moet ook de regio van de host toelaten."

Die tweede zin is bedoeld voor een organisatie waarvan het beleid de hostingregio's beperkt (Aanroepen binnen je regio's houden). Slack wordt in de Verenigde Staten gehost, dus voor zo'n organisatie wordt alleen iets geplaatst als haar beleid de host in policy.settings.host_regions als us opgeeft en us toelaat in policy.settings.regions_allow, of host:hooks.slack.com noemt bij haar regio-uitzonderingen (policy.settings.region_exceptions). Een organisatie die zich aan eu houdt, gebruikt de uitzondering. De regel op de kaart weegt de regio's niet mee: er kan staan dat de host is toegestaan terwijl er om deze reden niets wordt geplaatst.

De operator van je omgeving kan een host voor elke organisatie blokkeren. De regel "De operator van deze omgeving blokkeert hooks.slack.com, dus er wordt niets in Slack geplaatst." staat dan op de kaart van de organisatie die de webhook heeft opgeslagen, en op die van een overnemende organisatie waarvan de beheerder daar ook bij kan. De host zelf toestaan verandert daar niets aan. Vraag het je operator.

Wie het adres heeft, kan in je kanaal schrijven. Artific slaat het daarom versleuteld op en toont het nooit meer: na het opslaan is het veld leeg en staat erboven "Voor deze organisatie is een Slack-webhook ingesteld." Bewaar het adres zelf als je het nog nodig hebt.

• Vervangen: plak een nieuw adres in het veld en sla op.
• Verwijderen: kies Webhook verwijderen en sla op. Tot je opslaat, maak je dat ongedaan met Webhook houden.

Een organisatie zonder eigen webhook gebruikt die van de dichtstbijzijnde organisatie erboven die er een heeft, net als bij de adressen. De twee staan los van elkaar: een organisatie met eigen adressen maar zonder eigen webhook wordt op haar eigen adressen gemaild en verschijnt toch in het Slack-kanaal van de organisatie erboven. De kaart zegt of deze organisatie een eigen webhook heeft, er een overneemt, of dat er hier noch erboven een is ingesteld.

Bij een overgenomen kanaal staat de organisatie die de webhook heeft opgeslagen de host toe, niet de organisatie die het kanaal overneemt: een reseller staat hooks.slack.com één keer toe, en zijn klanten hoeven dat niet te doen. Heeft die organisatie de host niet toegestaan, dan wordt er niets geplaatst. Een beheerder van de overnemende organisatie die ook bij de organisatie erboven kan, ziet op de kaart: "hooks.slack.com is niet toegestaan in het beleid van de organisatie erboven die deze webhook heeft opgeslagen, dus er wordt niets in Slack geplaatst zolang dat zo blijft." Een beheerder die dat niet kan, ziet geen regel over de host.

De regioregel hierboven geldt wel voor de overnemende organisatie zelf: beperkt ze haar hostingregio's, dan gaan haar meldingen alleen naar het overgenomen kanaal als haar eigen beleid hooks.slack.com in policy.settings.host_regions als us opgeeft en us toelaat, of host:hooks.slack.com noemt bij haar eigen regio-uitzonderingen.

De organisaties boven de organisatie waarover een melding gaat, begrenzen het bericht ook, bij een overgenomen kanaal en bij een eigen webhook. Twee dingen in hun beleid tellen (Policy):

• Een organisatie erboven waarvan het beleid een regel over Bestemmingen bevat, moet hooks.slack.com toestaan. Haar beheerder voegt de host toe op haar kaart Toegestane hosts.
• Een organisatie erboven die haar hostingregio's beperkt, moet hooks.slack.com in policy.settings.host_regions als us opgeven en us toelaten, of host:hooks.slack.com noemen bij haar regio-uitzonderingen.

Zolang niet elke organisatie erboven dat doet, wordt er niets geplaatst, en vanuit deze organisatie kun je dat niet wijzigen: vraag het de beheerder van de organisatie erboven. De kaart toont het eerste geval en niet het tweede. Staat een organisatie erboven de host niet toe, dan staat onder de Slack-status de regel "hooks.slack.com is niet toegestaan in het beleid van deze organisatie, dus er wordt niets in Slack geplaatst zolang dat zo blijft.", ook als de host op de eigen lijst Toegestane hosts van deze organisatie staat; bij een overgenomen kanaal is het de regel over de organisatie erboven die de webhook heeft opgeslagen. Staat de host op je lijst en blijft die regel staan, dan weigert een organisatie erboven. Een regiobeperking erboven weegt de kaart niet mee: er staat dan dat de host is toegestaan terwijl er niets wordt geplaatst.

Komen er geen berichten meer in het kanaal, controleer dan in Slack of de webhook nog bestaat en of het kanaal niet is gearchiveerd. Artific meldt niet dat een webhook is ingetrokken; stel in dat geval een nieuwe in.

Mail, Slack of beide¶

Onder Waarheen meldingen gaan staan twee schakelaars, Mail en Slack. Beide staan aan tot je er een uitzet.

De schakelaars gaan over de meldingen van deze organisatie zelf, niet over die van de organisaties eronder. Neemt een organisatie het Slack-kanaal van boven over en wil ze haar meldingen daar niet hebben, dan zet ze Slack uit.

Een kanaal dat aanstaat, verstuurt alleen als er ook een bestemming is: een adres voor mail, een webhook voor Slack, van de organisatie zelf of overgenomen. Voor Slack gelden nog drie voorwaarden: de operator heeft het aangezet, de organisatie die de webhook heeft opgeslagen staat hooks.slack.com toe en de operator blokkeert die host niet, en een organisatie die haar hostingregio's beperkt, laat de host toe (Een Slack-kanaal). Zolang de operator Slack uit heeft staan, is de schakelaar Slack op de kaart uitgeschakeld.

Wat er gemeld wordt¶

Een falende webhook of koppeling wordt hoogstens één keer per dag gemeld voor dezelfde webhook, connector, index of tool, zodat een reeks fouten één melding is. Een budgetgrens wordt één keer per maand gemeld. Een uitgefaseerd model wordt één keer gemeld per model en datum, met de datum, de vervanger, hoeveel configuraties het nog noemen, en wat er vanaf die datum gebeurt; welke het zijn, staat op Nog in gebruik. Verschuift je operator de datum, dan volgt een nieuwe melding. Een bron die wacht omdat de maandlimiet is bereikt, wacht en faalt niet, en wordt niet gemeld.

Een melding noemt de organisatie, de sleutel of koppeling waar het om gaat en de bedragen in euro, met een link naar de console. Ze bevat nooit je verzoeken of gesprekken. Ze bevat ook nooit de fouttekst van een externe dienst, behalve in de analyse van een foutenoverzicht, die een organisatie zelf aanzet. Meldingen zijn geschreven in de taal van de organisatie, in beide kanalen.

Een mail toont het logo van Artific en de naam van de organisatie in een blauwe kop. Het logo zit in de mail zelf, dus je mailprogramma haalt niets op om het te tonen; waar afbeeldingen geblokkeerd zijn, staat in de kop "Artific".

Het foutenoverzicht¶

Het Foutenoverzicht is één melding die zegt wat er in de organisatie mislukte, hoeveel dat ook was: hoogstens één per organisatie per kwartier, tenzij de operator een ander interval heeft ingesteld. Mislukte er niets, dan wordt er niets verstuurd.

Het overzicht is er alleen als de operator van je omgeving foutmeldingen heeft aangezet (hieronder). Is dat zo, dan staat de soort voor elke organisatie aan tot de organisatie hem uitzet.

Wat als fout telt¶

Dit zijn geen fouten en ze worden niet geteld:

• een antwoord dat is geannuleerd of onvolledig eindigde, en een run die wacht op een tool die je eigen applicatie uitvoert;
• een run die is gestopt omdat de organisatie is opgeschort. Een opgeschorte organisatie krijgt geen overzicht;
• een toolaanroep die het beleid of de adresregel weigerde, een aanroep van een tool die niet bestaat, en een geannuleerde aanroep;
• een evaluatierun die met waarschuwingen slaagde, en een schema dat is overgeslagen;
• een tool die buiten een beurt is aangeroepen, rechtstreeks via de API of via het eigen MCP-endpoint van een toolset: de aanroeper krijgt daar zelf het antwoord;
• een aanroep binnen de beurt van een agent die door een andere agent is aangeroepen.

Een falende webhook en een mislukte koppeling houden hun eigen melding (Wat er gemeld wordt) en staan niet in het overzicht.

Een organisatie krijgt geen overzicht als er voor haar geen adres en geen Slack-webhook geldt, eigen of overgenomen, op een kanaal dat ze aan heeft staan: er is dan niemand om het naartoe te sturen.

Wat er in een overzicht staat¶

Een overzicht geeft het aantal fouten en het eerste en het laatste tijdstip, en daarna één regel per groep van dezelfde fout: hoeveel, wat er mislukte, de tool, het model of de agent die het noemt, en de eigen code van Artific voor de fout. Elke regel linkt naar de nieuwste fout van de groep in de console:

De links openen de console in de taal van de organisatie. Een overzicht noemt hoogstens twintig groepen; een laatste regel geeft het aantal fouten dat niet is genoemd.

Subject: [Artific] Acme Care: 131 storingen

Er zijn 131 storingen vastgelegd voor Acme Care tussen 12:01 en 12:15 UTC op 7 oktober 2026.

- 2 x antwoord mislukt (model_error), agent Intake
  https://console.example.nl/nl/organisations/ten_1/traces?response=resp_2
- 1 x schema kon niet starten (key_revoked)
  https://console.example.nl/nl/organisations/ten_1/schedules/sch_1
- 3 x toolaanroep mislukt: crm__lookup (timeout), agent Intake
  https://console.example.nl/nl/organisations/ten_1/traces?response=resp_3

En nog 125 die hier niet staan.

Een overzicht bevat nooit een callbackadres, een webhookadres, een verzoek, een gesprek of een prompt, en nooit de tekst van een fout. De enige uitzondering is de analyse hieronder, als de organisatie die heeft aangezet.

Analyse door het hulpmodel¶

Onder Foutenoverzicht staat op de kaart een tweede schakelaar, Analyse door het hulpmodel. Die staat uit tot je hem aanzet. Staat hij aan, dan eindigt elk overzicht met een korte analyse: een samenvatting, waarschijnlijke oorzaken en wat je kunt controleren.

Analysis, written by this organisation's helper model from the failures above:

The CRM lookup tool timed out on most calls, which failed two responses.

Likely causes:
- The CRM endpoint is slow or unreachable.
- The provider's error said: sign in again at https[:]//evil[.]example/login

What to check:
- Check the CRM connector's endpoint.
- Raise the tool's timeout if the endpoint is slow by design.

Aanzetten betekent het volgende. Bepaal eerst of je organisatie dit toestaat.

• Een model leest foutteksten. Het hulpmodel van de organisatie leest de gegevens van het overzicht zelf en, voor hoogstens vijf van de nieuwste mislukte modelaanroepen, de fout die de modelaanbieder teruggaf, uit de trace van de aanroep en ingekort tot duizend tekens. In die tekst kan een deel staan van wat een aanroeper stuurde. De tekst gaat naar de aanbieder van dat model, onder het eigen beleid en de eigen regio's van de organisatie, zoals bij elke aanroep van het hulpmodel. Verder wordt er niets van een trace gelezen: niet het verzoek en niet het antwoord. Tekst die verzegeld is gedeeld, zoals de instructies of prompts van een andere organisatie, wordt nooit gelezen: een fout waarin die staat, wordt in zijn geheel overgeslagen. Elke trace die de analyse opent, staat als trace.read op het auditspoor van de organisatie, ook als er niets uit gelezen kon worden. Van een mislukte toolaanroep worden alleen de naam en de code gelezen. Staat tracing uit, dan is er geen trace en wordt de analyse alleen uit de aantallen, codes en namen gemaakt.
• Wat het schrijft gaat overal heen waar meldingen heen gaan. De analyse staat in de mail aan elk adres en in het Slack-bericht. Slack wordt in de Verenigde Staten gehost (Een Slack-kanaal).
• De organisatie betaalt de aanroep. Hij telt mee in het verbruik van de organisatie en voor haar maandlimiet, één keer per overzicht. De analyse wordt gemaakt en geteld zodra er een adres of een webhook geldt, ook als het afleveren daarna mislukt: een mailrelay die ontbreekt, of de host van Slack die niet is toegestaan.
• Adressen in een analyse zijn niet aanklikbaar. Een adres dat het model herhaalt, wordt gebroken geschreven, zoals https[:]//example[.]com of ops[@]example[.]com, zodat niemand een link volgt die uit een fout komt. Een bestandsnaam zoals report[.]pdf wordt op dezelfde manier gebroken.

Een overzicht wacht nooit op zijn analyse. Heeft de organisatie geen hulpmodel beschikbaar, weigert haar beleid dat model, is haar maandlimiet bereikt, of mislukt de aanroep of wordt hij onderbroken, dan komt het overzicht zonder analyse, met één regel die begint met "No analysis was added:" en de reden geeft. Wordt de analyse of de soort uitgezet, of de organisatie opgeschort, tussen het overzicht en de analyse, dan komt het overzicht zonder regel over een analyse.

Een analyse wordt hoogstens een week bewaard, en korter als het venster voor gegevensbewaring van de organisatie korter is.

Budgetgrenzen¶

Vul in het veld Budgetgrenzen (procent van de limiet) tot vijf percentages van de maandlimiet in, van 1 tot en met 100, gescheiden door komma's. Standaard zijn dat 80 en 100. Dezelfde percentages gelden voor de limiet van de organisatie en voor de limiet van elk van haar sleutels.

Een grens wordt om de paar minuten gecontroleerd, dus een melding kan een paar minuten na het bereiken aankomen. Worden meerdere grenzen tegelijk gepasseerd, dan noemt één melding de hoogste. Een organisatie zonder limiet, of met een limiet van 0, krijgt geen melding over een budgetgrens; haar sleutels met een eigen limiet wel.

Elke bereikte grens is ook een gebeurtenis, usage.threshold_reached, op de gebeurtenisstroom en webhooks van de organisatie, met wiens limiet het was en welke grens, nooit de bedragen. De gebeurtenis komt of de mail nu aanstaat of niet: Budgetgrens bereikt uitzetten stopt alleen de mail en het Slack-bericht, zodat een platform dat op de gebeurtenis reageert die blijft krijgen.

Taal¶

Kies onder Taal van de meldingen Nederlands of Engels en kies Opslaan in de balk onderaan. Elke mail en elk Slack-bericht over deze organisatie wordt in die taal geschreven, het onderwerp ook, ook als de adressen of het Slack-kanaal van een organisatie erboven komen: de taal is altijd die van de organisatie waar de melding over gaat. Een nieuwe organisatie begint in het Nederlands.

Bedragen, maanden en datums volgen de taal: € 2.042,30 en oktober 2026 in het Nederlands, €2,042.30 en October 2026 in het Engels. De analyse in een foutenoverzicht staat er zoals het hulpmodel haar schreef.

Een soort uitzetten¶

Onder Soorten meldingen staat één schakelaar per soort melding. Een soort die uitstaat, wordt niet gemaild en ook niet in Slack geplaatst. Dat geldt alleen voor de meldingen van de organisatie zelf: een organisatie eronder die dezelfde adressen of hetzelfde kanaal gebruikt, blijft die soort krijgen tot ze hem zelf uitzet.

Taak afgerond werkt andersom: die staat uit tot je hem aanzet. De melding gaat naar de meldingsadressen en het Slack-kanaal van de organisatie, niet naar degene die de taak startte, en er worden hooguit 20 per uur verstuurd; de rest lees je in de console. Zet je de soort aan en ook uit, dan wordt hij niet verstuurd.

Analyse door het hulpmodel staat onder Foutenoverzicht en hoort daarbij. Zolang het overzicht uitstaat, is de schakelaar voor de analyse uitgeschakeld, met de toelichting "Zet het foutenoverzicht aan om dit te gebruiken."

Voor het foutenoverzicht is ook de operator van je omgeving nodig. Heeft de operator foutmeldingen niet aangezet, dan staat op de kaart "De operator van deze omgeving heeft foutmeldingen niet aangezet, dus er wordt geen foutenoverzicht verstuurd." en zijn beide schakelaars uitgeschakeld. Vraag je operator ze aan te zetten.

Wie dit mag wijzigen¶

De eigen beheerders van de organisatie, de beheerders van de organisaties erboven, en Artific.

Met een sleutel¶

Een sleutel met management wijzigt dezelfde instellingen via PATCH /organisation. Een veld dat je weglaat, blijft zoals het is.

curl -s -X PATCH "$CORE_URL/organisation" \
    -H "Authorization: Bearer $CORE_KEY" -H "Content-Type: application/json" \
    -d '{"notification_emails": ["ops@example.com", "finance@example.com"]}'

GET /organisation geeft het webhookadres nooit terug. notification_slack_set zegt of de organisatie er zelf een heeft, notification_slack_effective of er voor haar een webhook geldt, eigen of overgenomen, notification_slack_available of Slack in deze omgeving aanstaat, en notification_emails_effective naar welke adressen de mail echt gaat.

notification_failures_available zegt of de operator foutmeldingen heeft aangezet. Zolang het false is, wordt er geen foutenoverzicht verstuurd en heeft notification_failure_analysis geen effect; beide instellingen worden wel opgeslagen en gelden zodra de operator het aanzet.

notification_slack_egress zegt of de host van Slack bereikt mag worden voor de webhook die geldt:

De host is alleen open als allowed true is en blocked false. Voor het plaatsen zijn ook de schakelaar van de operator (notification_slack_available) en slack in notification_channels nodig. Regio's wegen in het veld niet mee: een organisatie die haar regio's beperkt, kan allowed: true lezen terwijl er niets wordt geplaatst tot ze de host toelaat.

Op GET /organisation is het veld null als er geen webhook geldt en als de webhook is overgenomen: een sleutel kan bij haar eigen organisatie en bij de organisaties eronder, nooit bij die erboven. Lees je een organisatie onder de jouwe met GET /organisations/{id}, dan is het veld gevuld als de webhook die ze gebruikt van haarzelf is, van jouw organisatie, of van een organisatie daartussen.