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 og getur sent tengiliðinn í HubSpot sem lead.
Salesforce
Instance URL og Connected App Access Token — sækir tengiliða- og fyrirtækjaupplýsingar úr Salesforce og getur stofnað Lead úr samtali.
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.
Leads úr samtölum
Þegar HubSpot eða Salesforce er tengt birtist hnappurinn „Senda í HubSpot“ eða „Senda í Salesforce“ á tengiliðaspjaldinu og í samhengisstiku málsins. Tengiliðurinn er þá merktur sem lead í Spjallbox og stofnaður (eða uppfærður) í CRM-kerfinu. Þú getur líka látið sjálfvirknireglu gera þetta — t.d. merkja alla sem spyrja um „tilboð“ sem lead og senda þá beint í HubSpot.
Bókhald: Payday og dk
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.
Tengdu dk með API-tákni úr dkPlus til að sjá stöðu viðskiptamanns, lánamörk, ógreidda og gjaldfallna reikninga og síðustu reikninga við hlið málsins. Flett er upp eftir kennitölu fyrirtækisins, svo kennitölu tengiliðar (t.d. úr Kenni-auðkenningu) og loks netfangi. Táknið þarf lesaðgang að viðskiptamönnum og sölureikningum.
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, dk) þ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.