Odoslanie webhooku z automatizácie

Krok Odoslať webhook pošle vybrané údaje do iného systému presne vtedy, keď to potrebujete. Pracovný postup rozhodne, kedy sa to stane, napríklad len pri vyhratom obchodnom prípade, a v kroku vyberiete, aké údaje druhý systém dostane.

Než začnete

V časti Nastavenia, Integrácie, Webhooky pridajte webhook so spúšťačom Automatizácia (návod Nastavenie webhooku). V kroku pracovného postupu sa ponúkajú len webhooky s týmto spúšťačom. Ak taký ešte nemáte, krok zobrazí upozornenie, že webhook pre automatizáciu zatiaľ nie je nastavený.

Pridanie kroku Odoslať webhook

1. V časti Automatizácia otvorte pracovný postup alebo vytvorte nový.
2. Na mieste, kde sa majú údaje odoslať, pridajte krok Odoslať webhook.
3. Na karte Webhook vyberte webhook nastavený v Nastaveniach.
4. Na karte Parametre vyberte údaje, ktoré sa odošlú. Každý riadok má názov a hodnotu. Do hodnoty môžete vložiť pole záznamu, napríklad názov obchodného prípadu alebo sumu, a Gram pri odoslaní doplní jeho aktuálny obsah.
5. Pracovný postup uložte.

Názvy parametrov dohodnite s dodávateľom druhého systému. Musia byť zapísané presne tak, ako ich druhý systém očakáva, vrátane veľkých a malých písmen.

Príklad: vyhratý obchodný prípad založí projekt

Keď obchodník označí obchodný prípad ako vyhratý, interná aplikácia na riadenie projektov má založiť nový projekt s názvom zákazky, klientom a sumou.

1. V Nastaveniach pridajte webhook Nové projekty so spúšťačom Automatizácia, adresou internej aplikácie a autorizáciou, ktorú vám dá jej dodávateľ.
2. V Automatizácii vytvorte pracovný postup, ktorý sa spustí po úprave obchodného prípadu.
3. Pridajte podmienku, že obchodný prípad je vyhratý.
4. Za podmienku pridajte krok Odoslať webhook, vyberte webhook Nové projekty a na karte Parametre vyplňte riadky podľa tabuľky.

Názov	Hodnota
dealId	pole Id obchodného prípadu
name	pole Názov
client	pole Klient
amount	pole Suma
source	text Gram CRM

Interná aplikácia potom pri každom vyhratom obchodnom prípade dostane takúto správu:

{
  "Data": {
    "dealId": "3f2c8a51-7d0e-4b6a-9c41-2e5f8d7a1b90",
    "name": "Klimatizácia skladu a servis",
    "client": "Harsby s.r.o.",
    "amount": "12480.00",
    "source": "Gram CRM"
  }
}

Ako takú správu spracovať, je pre dodávateľa druhého systému opísané v návode Spracovanie webhooku vo vašom systéme.

Na čo myslieť

• Všetky hodnoty webhooku sa odosielajú ako text, vrátane čísel a dátumov. Druhý systém si ich prevedie sám.
• Riadok bez názvu sa neodošle.
• Odpoveď druhého systému sa do pracovného postupu nevracia. Krok len odošle údaje, postup s výsledkom druhého systému ďalej nepracuje.
• Krok nemôžete použiť v postupe, ktorý beží pred uložením záznamu. Údaje sa odosielajú až o uloženom zázname.
• Keď je druhý systém nedostupný, Gram doručovanie opakuje. Ak výpadok trvá dlho, doručovanie sa zruší a krok potom končí chybou, kým webhook znova neuložíte. Podrobnosti sú v návode Výpadky a doručovanie webhooku.

Mohlo by vás tiež zaujímať:

• Webhooky
• Nastavenie webhooku
• Obchodné prípady