4notify-dokumentaatio

Luo tili osoitteessa panel.4notify.net ja muodosta client_id/client_secret-pari rajapintatunnusten sivulla. Pyydä niillä käyttöoikeustunnus kutsulla POST /api/v1/auth/token (OAuth2 client_credentials) — tunnus on lyhytikäinen, ja integraatiosi pyytää yksinkertaisesti uuden aina kun se sitä tarvitsee.

Päätepisteet POST /api/v1/sms, /api/v1/whatsapp ja /api/v1/push ottavat pyynnön vastaan otsakkeella Authorization: Bearer <token> ja vastaavat 202 Accepted — viesti siirtyy samaan jonoon ja kulkee saman työprosessin ja palveluntarjoajan kautta kuin hallintapaneelista lähetetyt viestit, ja se merkitään sisäisesti vain merkinnällä "source: api". Jokaisella asiakkaalla on oma pyyntörajansa ja kiintiönsä; kumman tahansa ylittyessä palautetaan selkeä virhe sen sijaan, että viestejä hiljaisesti hylättäisiin.

WhatsAppissa vastaanotamme toimitustapahtumat ja asiakkaiden vastaukset takaisin webhookin kautta, joka varmennetaan Meta-vahvistustunnuksellasi. Emme tarjoa yleisiä kolmannen osapuolen liittimiä (ei WooCommerce-, Shopify- tai Zapier-lisäosia) — tarjoamme sen sijaan tämän webhookin ja edellä kuvatun lähetysrajapinnan, jotka kytket omaan CRM-järjestelmääsi tai taustajärjestelmääsi.

Viestipohjat määritellään kerran kanavaa kohden ja niitä käytetään uudelleen sekä hallintapaneelista että rajapinnasta. Työnkulut sitovat liipaisevan tapahtuman lähetysten sarjaan eri kanavissa — esimerkiksi SMS-viesti ja sen perään WhatsApp-viesti, jos ensimmäistä viestiä ei lueta. Rajapintatunnuksilla on omat käyttöoikeutensa, ne voidaan mitätöidä yksitellen hallintapaneelista ja niistä näkee viimeisimmän käyttöpäivän.