Mikä on n8n-integraatio Task Managerissa?
Task Managerin n8n-integraatio siirtää tietoja tehtävien ja muiden järjestelmien välillä. Lomakkeella tehty ilmoitus voidaan muuttaa tehtäväksi ilman tietojen uudelleenkirjoittamista. Tehtävän luominen voi käynnistää merkinnän lisäämisen Google Sheetsiin tai ilmoituksen lähettämisen Slackiin. Tiimi jatkaa työskentelyä Task Managerissa tavalliseen tapaan.
n8n-integraatio kuuluu Pro-versioon. Se on kokeellinen ominaisuus, joka on oletuksena pois käytöstä. Pääkäyttäjä ottaa sen käyttöön kohdassa Asetukset → Lisäasetukset → Muut. Kun ominaisuus on pois käytöstä, n8n-välilehti ei näy käyttöliittymässä, ja /api/n8n/*-päätepisteet hylkäävät pyynnöt koodilla 503. Myös n8n:ää koskeva ohjeluku katoaa AI-avustajan kontekstista.
n8n on erillinen alusta sovellusten välisten työnkulkujen rakentamiseen. Task Manager lähettää sille tapahtumia ja vastaanottaa siltä kutsuja.
Miten se toimii?
Task Manager lähettää tiedot n8n:ään webhookin kautta. Annat sille nimen, syötät n8n:n *Webhook*-solmun URL-osoitteen ja valitset tapahtumat. Voit myös lisätä salaisuuden pyyntöjen allekirjoittamista varten (HMAC). Valittavana on 26 tapahtumaa, kuten task.created, task.status_changed, task.completed ja chat.message_sent. Järjestelmätapahtumat (system.daily_summary ja muut system.*-tapahtumat) sekä user.created lähetetään kuitenkin vain ylläpitäjän luomiin yleisiin webhooks-kohteisiin. Jokainen pyyntö sisältää tapahtuman nimen, aikaleiman ja kontekstuaaliset tiedot. Voit lähettää testipingin ennen koko työnkulun rakentamista.
Toiseen suuntaan käytetään API-avainta. Muodossa tm_live_<32hex> oleva tunniste näytetään vain kerran. Anna se n8n:ssä otsakkeessa Authorization: Bearer. Käytettävissä olevat päätepisteet ovat ping.php, workspaces.php, users.php, tasks.php ja messages.php. POST /api/n8n/tasks.php luo tehtävän, jossa on aihe, kuvaus, prioriteetti, määräaika ja tehtävään liitettyjen henkilöiden luettelo. PATCH päivittää olemassa olevan tehtävän. Se edellyttää task_id-arvoa; muut kentät ovat valinnaisia. Jos HTTP-node ei tue PATCH-pyyntöä, voit lähettää rungon POST-pyynnöllä. task_id-arvon mukanaolo vaihtaa päätepisteen päivitystilaan.
n8n:stä tehty tilanmuutos kulkee samaa reittiä kuin sovelluksessa tehty muutos. Tehtävän viestiketjuun ilmestyy merkintä ”muutti tilaksi…”, tehtävään määritetyt henkilöt saavat sähköpostin ja Task Manager lähettää tapahtuman task.status_changed (tilan done yhteydessä myös task.completed). Saman tilan asettaminen uudelleen ei lähetä uutta tapahtumaa. Epäonnistunut webhook siirtyy jonoon. Jonossa on määritetty 60, 300 ja 1800 sekunnin välit sekä enintään neljä yritystä, mutta uudelleenyritykset suorittaa cron retry tai jonon käsittely joidenkin sovellukseen tulevien pyyntöjen yhteydessä. Ilman cronia ja sovelluksen käyttöä uudelleenyritys ei tapahdu näiden aikavälien mukaisesti. Integraatiovirhe ei estä työskentelyä ohjelmassa.
Avain toimii sen luoneen käyttäjän oikeuksilla ja hänen Työtilat-käyttöoikeuksillaan. users.php on käytettävissä vain yleisen järjestelmänvalvojan avaimilla. Yksityisiin ja varattuihin IP-osoitealueisiin kuuluvat webhook-osoitteet estetään; käytäntö n8n_private_network_policy voi saada arvot off, admin ja all, ja virheellisellä arvolla käytetään asetusta off.
Mitä hyödyt?
Asiakkaan lomakkeella lähettämää ilmoitusta ei tarvitse siirtää tehtäväksi. Voit aloittaa aamun ilmoituksen käsittelyllä sen sijaan, että siirtelisit tietoja ikkunasta toiseen.
Sinun ei myöskään tarvitse muistaa päivittää kahta järjestelmää työn valmistuttua. Kun tehtävä suljetaan, tieto voi kulkea eteenpäin valmiiksi määritetyn työnkulun kautta. Asiakkaan ei tarvitse odottaa, että joku kirjaa muutoksen manuaalisesti toiseen järjestelmään.
Tiimisi ei tarvitse opetella n8n:n käyttöä voidakseen hyödyntää valmista integraatiota. Kun ulkoinen työnkulku sulkee tehtävän, tehtävään määritetyt henkilöt saavat sähköpostin ja viestiketjuun jää merkintä muutoksesta. Integraation häiriö ei keskeytä tehtävien parissa työskentelyä.
Esimerkki arjen työstä
Huoltoyritys vastaanottaa ilmoituksia ulkoisessa tikettijärjestelmässä. n8n-työnkulku vastaanottaa uuden tiketin ja lähettää POST /api/n8n/tasks.php. Tuloksena syntyy tehtävä, jonka kuvauksessa on osoite, prioriteetti high ja määräaika kentässä deadline_date - työtilaan, johon avaimen omistajalla on pääsy, ja niiden assignees-listalla olevien henkilöiden kanssa, joilla on myös pääsy siihen.
Kun teknikko sulkee tehtävän, Task Manager lähettää tapahtuman task.completed webhookiin, jossa kyseinen tapahtuma on valittuna, ja työnkulku päivittää tilan asiakkaan järjestelmään. Erillinen webhook tapahtumalle task.deadline_approaching (tapahtuman lähettää toistuva ”deadline”-tehtävä, joten se edellyttää cronin käyttöönottoa) voi käynnistää tekstiviestimuistutuksen lähestyvästä määräajasta. Teknikon ei tarvitse käyttää n8n:ää.
Usein kysytyt kysymykset
Kuuluuko n8n-integraatio Standard-versioon?
Ei, se on Pro-version ominaisuus. Standard-versiossa integraation kytkintä ei ole Asetuksissa, joten sitä ei voi ottaa käyttöön.
Toimiiko n8n-integraatio heti asennuksen jälkeen?
Ei. Tämä on kokeellinen toiminto, joka on oletusarvoisesti poissa käytöstä. Järjestelmänvalvoja ottaa sen käyttöön kohdassa Asetukset → Lisäasetukset → Muut. Siihen asti n8n-välilehti on piilotettu ja endpointit /api/n8n/* palauttavat koodin 503.
Vaativatko integraatiot ohjelmoijaa?
Tekninen osaaja on hyödyksi n8n-työnkulun rakentamisessa. Sinun on kopioitava webhookin osoite, annettava tunniste ja laadittava JSON-runko. Valmiin työnkulun käyttäminen ei edellytä tätä osaamista.
Voinko muuttaa tehtävän tilaa ulkoisesta järjestelmästä?
Kyllä. Lähetä PATCH-pyyntö osoitteeseen /api/n8n/tasks.php ja anna parametreiksi task_id ja tila none, in_progress, done tai cancelled. Muutos lisää merkinnän tehtävän viestiketjuun, lähettää sähköpostin tehtävään määritetyille henkilöille ja käynnistää lähtevän webhookin.
Mitä tapahtuu, jos n8n ei vastaa?
Epäonnistunut webhook siirtyy jonoon. Jonossa on määritetty 60, 300 ja 1800 sekunnin välit sekä enintään neljä yritystä, mutta uudelleenyritykset suorittaa cron retry tai jonon käsittely joidenkin sovellukseen tulevien pyyntöjen yhteydessä. Ilman cronia ja sovelluksen käyttöä uudelleenyritys ei tapahdu näiden aikavälien mukaisesti. Integraatiovirhe ei estä työskentelyä ohjelmassa.
Poistaako integraation käytöstä poistaminen määritykset?
Ei. Webhookit ja API-avaimet säilyvät tietokannassa, ja ne tulevat takaisin käyttöön, kun integraatio otetaan uudelleen käyttöön.