Tengingar
Samþættingar og API
Tengdu Spjallbox við vefverslunina, CRM-kerfið, bókhaldið og eigin hugbúnað — með vefkrókum, opnu API eða tilbúnum samþættingum.
Lestrartími · 7 mín lestur
Auk tölvupósts og samfélagsmiðla (sem eru útskýrð á sér síðum) býður Spjallbox upp á samþættingar sem sækja gögn inn í samtalsgluggann eða senda gögn út úr kerfinu. Þær eru undir Stillingar → Samþættingar, en API-lyklar og vefkrókar eru undir Stillingar → Þróun.
Vefverslanir og CRM
Shopify
Verslunarlén (t.d. verslun.myshopify.com) og Admin API Access Token — sýnir nýlegar pantanir viðskiptavinar beint í samtalinu.
WooCommerce
Verslunarslóð (HTTPS), Consumer Key og Consumer Secret — sama virkni og Shopify, en fyrir WordPress/WooCommerce-verslanir.
HubSpot
Private App Access Token — sýnir CRM-upplýsingar tengiliðar meðan fulltrúi svarar máli.
Salesforce
Instance URL og Connected App Access Token — sækir tengiliða- og fyrirtækjaupplýsingar úr Salesforce.
Flestar samþættingar eru settar upp á sama hátt: límdu inn lykla eða aðgangstákn á viðeigandi flipa, smelltu á „Prófa tengingu“ til að staðfesta að samband náist og vistaðu svo.
Bókhald: Payday
Tengdu Payday með API-lykli (Bearer Token) og fyrirtækjanúmeri (valfrjálst) til að sjá reikninga viðskiptavinar beint í samtalinu. Þetta er gagnlegt þegar viðskiptavinur spyr um ógreiddan reikning og fulltrúi þarf annars að fletta upp í öðru kerfi.
Payday hér er bókhaldssamþætting sem birtir upplýsingar í samtalsglugganum. Þetta er ekki það sama og Teya, sem sér um greiðslur fyrir Spjallbox-áskriftina á Reikningar-síðunni.
Vefkrókar — senda gögn út
Undir Stillingar → Þróun → Vefkrókar (Webhooks) getur þú skráð eina eða fleiri slóðir sem fá POST-beiðni í hvert sinn sem eitthvað gerist í Spjallbox. Þú velur hvaða atburðir eiga að senda vefkrókinn:
- Samskipti stofnuð
- Samskipti uppfærð
- Samskipti lokið
- Samskipti leyst
- Samskipti úthlutað
- Ný skilaboð
- 1
Bættu við vefkrók
Settu inn slóðina þína (t.d. https://kerfid-thitt.is/webhooks/spjallbox) og hakaðu við þá atburði sem þú vilt fá.
- 2
Prófaðu vefkrókinn
Smelltu á „Prófa“ til að senda prófun strax og staðfesta að endapunkturinn þinn svari.
- 3
Staðfestu undirritun (mælt með)
Spjallbox undirritar hverja sendingu svo þú getir staðfest þín megin að hún komi örugglega frá Spjallbox.
API-rás — sendu mál inn frá öðrum kerfum
Undir Stillingar → Þróun → API-rás finnurðu leynilykil fyrirtækisins (byrjar á sk_…). Notaðu hann til að senda erindi beint úr ykkar eigin bakenda inn í Spjallbox, án þess að fara í gegnum tölvupóst eða vefviðmót:
Sendu POST-beiðni á /api/ingest með x-api-key haus og JSON-gögnum sem innihalda nafn, netfang, efni og skilaboð — nýtt mál birtist samstundis í innhólfinu.
Farðu vel með leynilykilinn
API-lykillinn veitir aðgang að innhólfinu ykkar — geymið hann eingöngu á ykkar netþjóni, aldrei í kóða sem keyrir í vafra viðskiptavinar.
Zapier, Make og n8n
Sömu API-rás má nota sem „HTTP request“-skref í Zapier, Make eða n8n. Þannig er hægt að tengja Spjallbox við nánast hvaða kerfi sem er án sérsniðins kóða — t.d. senda öll ný erindi úr eyðublaði á vefsíðunni í Spjallbox, eða kveikja á aðgerð annars staðar þegar máli er lokað.
Þarf forritara til að setja upp samþættingarnar?+
Fyrir vefverslana- og CRM-samþættingarnar (Shopify, WooCommerce, HubSpot, Salesforce, Payday) þarf yfirleitt bara að líma inn lykla — engin forritun. Vefkrókar og API-rásin henta best þeim sem hafa aðgang að forritara.
Get ég endurnýjað API-lykilinn ef hann lekur?+
Hafið samband við þjónustuver ef lykillinn gæti hafa lekið; þá gefum við út nýjan lykil.
Er til opinber API-skjölun?+
API-rásin og vefkrókarnir eru skjalfestir beint á Þróun-síðunni með dæmum sem hægt er að keyra — það þarf ekki ytri skjöl til að byrja.