4notify dokumentatsioon
Mida saad 4notifyga teha lisaks paneelile: API sinu enda taustasüsteemile, webhook'id ja kanaliteülene automatiseerimine.
Alustamine
Kontost esimese API kaudu saadetud sõnumini
Loo konto aadressil panel.4notify.net ja genereeri API-mandaatide lehel paar client_id/client_secret. Kasuta neid, et küsida juurdepääsutunnus otspunktist POST /api/v1/auth/token (OAuth2 client_credentials) — tunnus on lühiajaline ja sinu integratsioon küsib lihtsalt uue alati, kui seda vaja on.
API kirjeldus
Kolm saatmise otspunkti, üks konveier
Otspunktid POST /api/v1/sms, /api/v1/whatsapp ja /api/v1/push võtavad päringu vastu koos päisega Authorization: Bearer <token> ja vastavad 202 Accepted — sõnum satub samasse järjekorda ning läbib sama töötleja ja sama teenusepakkuja nagu paneelist saadetud sõnumid, olles sisemiselt märgitud "source: api". Igal kliendil on oma päringupiirang ja kvoot; kummagi ületamisel tuleb selge veateade, mitte sõnumite vaikne kadumine.
Webhook'id ja sissetulevad sündmused
WhatsAppi ringi sulgemine
WhatsAppis võtame kohaletoimetamise sündmused ja klientide vastused tagasi vastu webhook'i kaudu, mis on kinnitatud sinu Meta kontrolltunnusega. Me ei paku üldisi kolmandate osapoolte konnektoreid (ei ole WooCommerce'i, Shopify ega Zapieri pluginat) — pakume just seda webhook'i ja ülalkirjeldatud saatmis-API-t, mille ühendad oma CRM-i või taustasüsteemiga.
Mallid ja automatiseeritud töövood
Korduvkasutatav sisu ja sündmusepõhised käivitajad
Sõnumimallid määratakse kanali kohta üks kord ja neid kasutatakse nii paneelist kui ka API kaudu. Töövood seovad käivitava sündmuse kanaliteülese saatmiste jadaga — näiteks SMS, millele järgneb WhatsApp, kui esimest sõnumit ei loeta. API-mandaatidel on eraldi õigused, need saab paneelist ühekaupa kehtetuks tunnistada ja need näitavad viimase kasutamise kuupäeva.