Webhooks ehk teavitused

Alates 2024 aasta versioonidest on Standard Booksis standard funktsionaalsuse hulgas Webhookid ehk andmete muutmise teavitused.

Antud dokumendis kirjeldame tevaituste loomist make.com keskkonda kasutades.

Suures pildis saadab Webhook veebipäringu koos väikese JSON formaadis andmehulgaga ette antud välisele aadressile, kui vastavas registris on toimunud muudatus. Allpool me vaatame, mis registrite kohta on webhookid tehtud ning milliseid kitsendusi me saame kasutada.

Open

“Automaatne API päring” registri kaardi näidis

Registrid

Aasta 2024 lõpu seisuga on teostatud järgmiste registrite webhookid:

• Artiklid

• Laoseis

• Tegevused

• Ostutellimused

• Müügitellimused

• Kontaktid

• Pakkumised

• Arved

• Ostuarved

• Müüdud kinkekaardid

“Automaatsed API päringud” register asub Integratsiooni mooduli seadistuste all.

Üldised filtrid ja valikud

• Kui seadistuses märkida valik “Aktiveeri kõikidele sündmusele”, siis tuleb teavitus mitu korda ühe registri kaardi kohta. Kui seda valikut mitte märkida, siis tuleb tavitus ainult 1 kord.

  • See määrang on rangelt soovituslik näiteks Laoseisu või Artikli kaardi puhul - kui seda märgitud pole, siis saate näiteks ühe artikli laoseisu muutuse kohta ainult ühel korral.

  • See määrang on loogiline peale panna, kui soovite infot näiteks mõne konkreetse tegevuse tekkimise kohta, kuid ei soovi enam teavitust, kui see tegevus Tehtuks märgitakse.

  • Kui kahtled, märgi see valik aktiivseks.

• Jälgi sündmusi: “Kõik” või “Valitud sündmused”.

  • Siin saate teha vastavad valikud, kui soovite teavitusi ainult Uute kaartide kohta, Muutuste kohta või kaartide Kustutamise kohta.

  • Kui kahtled, jäta Jälgi sündmusi = Kõik.

• Maatriksi osas - Välja Nimi ja Välja Väärtus.

  • Siin saab teha filtreid kõikide kaardi väljade. Näiteks soovin ma ainult teavitusi ainult 1 artikliklassis olevate artiklite kohta. Siis saan ma kasutada filtrit selliselt:
    
    

    Open

    

    Nii saan teavitusi ainult artiklite kohta, millel on väljal “Group” väärtus “AUDIO”

    • Enamike Standard Booksi kaartide väljade kirjeldused on siin.

• Liidestus: Make.com, Zapier ja TikaTaka.

  • make.com - webhooki link saabub otse make.com keskkonnast. Selle liidestusega kaarti käsitsi tekitada ei saa

  • Zapier - väga sarnane make.com liidesele, kuid siin saab kasutada ka täiesti enda loodud linke.

  • TikaTaka - ei ole eestis kasutusel (Lätis arendatud kaardimaksete- ja POS seadmete liidestus)

• “Aktiivne” valik - kui ei ole märgitud, siis on Webhook mitteaktiivne.

Eri registrite erinevad filtrid

Artiklid

Töötab filtritest ainult “Artikliklass”, kuhu saab siestada artikliklassifikaatori, mille omamisel artikli webhook aktiveeritakse.

Laoseis

Võimalikud filtrid on:

• Lao kood,

• Lao klassifikaator (kui soovitakse jälgida mitmeid ladusid, kuid mitte kõiki)

• artikliklassifikaator.

Tegevused

Võimalikud filtrid on:

• Tegevuse tüüp

• Tegevuse klass

• Isik, kes on tegevusel Isik.

Ostutellimused

Võimalikud filtrid on:

• Ostutellimuse klass

Müügitellimused

Võimalikud filtrid on:

• Müügitellimuse klass

Kontaktid

Võimalikud filtrid on:

• Kliendiklass

Pakkumised

Võimalikud filtrid on:

• Pakkumise klass

Müügiarve

Võimalikud filtrid on:

• Lao kood

• Tasumisviis

Ostuarved

Võimalikud filtrid on:

• Tarnija kood

• Tasumisviis

Müüdud kinkekaardid

Filtrid puuduvad

Make.com keskkonnas aktiveerimine

Make.com keskkonnas alusta Scenario loomist.

On loogiline, et webhooki sisaldav moodul on alati andmete voos esimesel kohal.

Uuel scenariumil moodulit lisades valige “Excellent” ning seejärel ilmuvad kõik “instant” tüüpi moodulis, mis 1) loovad Standard Booksi webhooki seadistused ja 2) Loovad webhooki kuulava rakenduse.

Open

• Valides endale sobiva mooduli, avaneb uus aken, kus saate valida webhooki valiku akna juures “Add”

• Olles Webhooki lisamise aknas, saate valida ka Connectionit. Vajadusel looge uus. Selleks on Teil vaja MyStandardis ligipääsu oma serverile, seal omakorda saate luua Developer Credentialid, mida saab kasutada make.com-is ühenduse loomiseks (kohustuslik on kasutada OAuth2 autoriseerimist). Täpsemate juhiste saamiseks pidage nõu Excellenti kasutajatoe või Standard Booksi litsentsi omanikuga.

• Webhooki luues on Teil kasutada sama hulk filtreid, mis Standard Booksis “Automaatne API päring” registris. Tehke sobivad valikud ja valige Save

• Selle liigutuse peale tekitaski make.com Standard Booksi uue Webhooki (ehk “Automaatne API päring” registri)kaardi.

• Sealt edasi valite juba endale sobiliku make.com mooduli ja teete väljade mappingu. See on juba make.com keskkonna kasutamise loogika.

Vajadusel aitab Teid webhooki loomisel Excellenti konsultant. Samuti saame vähesel määral aidata ka make.com edasise kasutamisega, kuid antud teemal puuduvad meil ametliku väljaõppe saanud inimesed. Seega sõltub palju Teie vajadusest ja eesmärgist.