Obsolens kennisbank Naar het portaal
Kennisbank › Werken met het portaal

Kanalen: e-mail, Teams, webhook en Autotask

Zo stel je de kanalen in waarlangs Obsolens meldingen verstuurt en koppel je klanten aan Autotask voor tickets.

Een kanaal is een manier om meldingen buiten het portaal te krijgen. Je stelt de kanalen één keer in onder Instellingen › Kanalen. Daarna kies je in de meldingsregels per soort melding welke kanalen hij gebruikt. Het tabblad Kanalen is alleen zichtbaar voor een eigenaar.

E-mail

E-mail verstuurt de server zelf. Staat bij E-mail "Nog niet ingesteld op de server (SMTP)", dan bewaart Obsolens de adressen in de regels, maar gaat er nog niets weg.

  1. Vul bij Testmail naar je eigen adres in en kies Testmail sturen.
  2. Kies bij Weekoverzicht op de dag en bij Om het uur van het weekoverzicht.
  3. Kies Opslaan.

Het weekoverzicht bevat alle meldingen van soorten die op Weekoverzicht staan. De tijdzone staat onder het formulier, net als wanneer het laatste weekoverzicht is verstuurd.

Microsoft Teams

  1. Maak in Teams bij het kanaal een workflow "Berichten van een webhook naar een kanaal posten" en kopieer het adres dat Teams geeft.
  2. Plak het bij Webhook-adres en kies Opslaan.
  3. Kies Testbericht om te controleren of het bericht aankomt.

Wil je later een ander adres, vul dan het nieuwe in bij Nieuw adres (laat leeg om te houden). Met Verwijderen haal je de koppeling weg.

Autotask

Met Autotask maakt Obsolens van meldingen tickets bij het juiste bedrijf.

De koppeling instellen

  1. Maak in Autotask een API-gebruiker aan (Admin > Resources > API User). Gebruik als integratiecode "Obsolens" of jullie eigen tracking identifier.
  2. Vul in Obsolens onder Autotask de API-gebruikersnaam, het Secret en de Integratiecode in.
  3. Kies Opslaan en daarna Verbinding testen. Bovenaan het blok staat dan "Verbonden" of de fout van de laatste test.

Secret en integratiecode worden niet meer getoond na het opslaan. Met Verwijderen haal je de koppeling weg.

Elke klant aan een bedrijf koppelen

Een ticket komt bij een Autotask-bedrijf. Daarom koppel je elke klant apart. Dat kan een eigenaar of technicus.

  1. Open de klant en zoek het blok Autotask onderaan de pagina.
  2. Typ minstens twee letters bij Zoek bedrijf in Autotask en kies Zoeken.
  3. Kies Koppelen bij het juiste bedrijf.

Is een klant niet gekoppeld, dan kan er geen ticket worden gemaakt. Bij de melding staat dan onder Waar is deze melding naartoe gestuurd dat het ticket mislukt is, met de reden. Met Ontkoppelen haal je de koppeling weg.

Tickets per soort melding

Vink in een meldingsregel Autotask-ticket aan. Je kunt dan ook kiezen:

  • Wachtrij, Prioriteit, Categorie (issue type) en Subcategorie. Kies je niets, dan gebruikt Autotask zijn standaard.
  • Tickettitel (optioneel), bijvoorbeeld [Obsolens] {soort} bij {klant} ({aantal}). Je kunt {klant}, {locatie}, {soort}, {aantal} en {titel} gebruiken.

Zonder eigen prioriteit volgt het ticket de ernst van de melding. Ook de deadline hangt van de ernst af: 4 uur bij Kritiek, 24 uur bij Hoog, 72 uur bij Middel en een week bij Info. Meldingen van dezelfde locatie en soort die kort na elkaar komen, worden één ticket.

Webhook

Een webhook is voor eigen koppelingen, bijvoorbeeld een ander PSA of een SIEM.

  1. Vul bij Adres (https) het adres van je ontvanger in. Het moet een openbaar adres zijn; interne adressen en doorverwijzingen worden niet gevolgd.
  2. Kies bij Vanaf ernst welke meldingen mee moeten: Kritiek, Hoog, Middel of Alles.
  3. Kies Opslaan. Bij de eerste keer toont het portaal de ondertekeningssleutel. Kopieer hem meteen: hij wordt maar één keer getoond.
  4. Kies Testbericht.

Elk bericht is ondertekend. In de header X-Obsolens-Timestamp staat het tijdstip, in X-Obsolens-Signature de waarde sha256= gevolgd door een HMAC-SHA256 met je sleutel over het tijdstip, een punt en de body. Controleer die handtekening in je ontvanger. Met Nieuwe sleutel maak je een nieuwe sleutel; de oude werkt dan niet meer.

Zonder eigen regels gaan alle meldingen direct naar de webhook, zodra die is ingesteld. Lukt een bericht niet, dan probeert Obsolens het een paar keer opnieuw.

Controleren of het werkt

  • Gebruik de testknop bij elk kanaal.
  • Open een melding en klap Waar is deze melding naartoe gestuurd open. Daar staat per kanaal "verstuurd", "wacht (wordt gebundeld)", "in weekoverzicht", "na het onderhoud" of "mislukt" met de fout.

Zie ook