Opsæt integration mellem GatewayAPI og Cicero
Efter flere efterspørgsler fra brugere af Cicero Library Management System har vi udviklet en integration, der gør det nemt for Cicero-brugere at sende SMS’er til låntagere samt modtage SMS’er via GatewayAPI. Denne opsætning kan bruges af alle biblioteker, der bruger Cicero – både store og små.
Integrationen er enkel, og kræver kun følgende:
- En GatewayAPI-konto
- SYSADMIN adgang til Cicero
Afsendelse af SMS’er
For at kunne sende SMS’er skal du først oprette en GatewayAPI konto. Naviger derefter til Settings → API-keys og klik på det lille nøgleikon for at se listen over legitimationsoplysninger. Her skal du bruge den, der hedder API Token.
I Cicero skal du gøre følgende:
- Naviger til F7 SYSADMIN og derefter til Serveropsætning, og rul derefter ned til kategorien notifikation
- Dobbeltklik på SMS-notifikation, og indstil den til sand
- Dobbeltklik på SMS service login kodeord i Cicero, og indsæt API-token kopieret fra GatewayAPI
- Dobbeltklik på SMS-service-URL og indsæt URL: https://gatewayapi.com/cicero/sendsms
- Gem dine indstillinger ved at klikke på gem
Når du er færdig, skal det se sådan ud. Vi har udfyldt SMS service login brugernavn feltet med teksten “bruger”. Dette felt bruges dog ikke af GatewayAPI, så du kan lade det stå tomt.
Kontrol af afsender-id vist på telefoner
I GatewayAPI dashboardet under Settings → SMS-defaults kan du indstille et standardafsender-ID, f.eks. 1204, dette er hvad der vises som afsenderen på låntagerens telefon. Det kan også være et alfanumerisk navn, f.eks. “Bibliotek”. Brug af 1204 som afsender-ID vil typisk gøre det lettere for kunder at holde styr på de SMS-beskeder, de har modtaget fra dig og sendt til dig.
Håndtering af landekoder
Hvis låntagerne har udfyldt deres telefonnumre uden landekode, kan du indstille en standardlandekode under Settings → SMS defaults. Dette fungerer for danske modtagere, men ikke uden for Danmark. Hvis du har ikke-danske låntagere, skal du tilføje landekoden til låntagerernes telefonnumre i Cicero.
Lad os se, om det fungerer
Test opsætningen ved at låne en eller flere bøger og afkryds feltet send kvittering ved siden af afslut udlån. En SMS burde gerne blive leveret kort tid efter. Du burde derudover kunne se SMS’en i GatewayAPI-backend’en under trafikloggen.
Modtagelse af beskeder
For at give låntagere mulighed for at forny lån via SMS skal du gøre følgende:
- Navigerer til F7 SYSADMIN Serveropsætning . Find Forny via sms-integration og indstil den til sand.
- Gå til Ekstern adgang i F7 SYSADMIN, klik på Andre integrationer, og klik derefter på Opret integrationsbruger, vælg kategorien SMS-bruger, og indtast derefter et brugernavn og en adgangskode. Husk at skrive brugernavnet og adgangskoden ned, da du har brug for dem senere.
I serveropsætning skal feltet Forny via SMS-integration nu indstilles til sand.
Og under Ekstern adgang skal det gerne se sådan her ud:
- Gå nu til GatewayAPI, og naviger til Subscriptions → Keywords / Numbers, og klik på Get Keyword. Vælg derefter dit keyword, f.eks. “Bibliotek”. Se vores side om virtuelle numre og keywords for mere information.
- Naviger til Indstillinger → Webhooks, og klik på fanen Cicero og derefter på Add new webhook. Den URL, du indsætter, skal se sådan ud https://www.cicero-fbs.com/rest/DK-XXXXX/smsgateway?user=user&password=password (XXXXXX = dit kundenummer). Brugeren og adgangskoden er det brugernavn og den adgangskode, du valgte tidligere – se trin 2.
Hvis du ikke er medlem af FBS, skal URL’en se sådan her ud: https://www.cicero-lms.com/rest/DK-XXXXX/smsgateway?user=user&password=password
Du er nu helt i mål med din GatewayAPI-integration med Cicero. Tillykke!
Hvis du ikke kunne få det til at fungere, er du altid velkommen til at kontakte os på supportchatten eller på support@gatewayapi.com
Global SMS Gateway
GatewayAPI har nogle af de laveste priser i størstedelen af verden kombineret med en intuitiv brugergrænseflade, support i verdensklasse og en solid oppetid på over 99,99 % i gennemsnit. Hvis du ikke har en konto endnu, kan du oprette en gratis konto på mindre end to minutter her: Gå til GatewayAPI eller skriv til sales@gatewayapi.com.