Veiledning: Opprett Klaviyo webhook

Hvordan lage en webhook for SMS i Klaviyo

1. Log ind på din Klaviyo konto og åbn det flow, hvor du vil indsætte SMS.
2. I venstre-menuen finder du fanen ”Webhook”. Dra elementet inn i flyten på det punktet der du vil sende en SMS-melding.
3. Indsæt din API-URL efterfulgt af din API-nøgle
   Klik på dit webhook-element i flowet, gå til venstre-menuen og find feltet ”Add the destination URL”.
   
   Her skal du indsætte din API-URL og erstatte  [din api-nøgle her]  med din egen, unikke API-nøgle, som du opretter på din inMobile konto.
   
   Din API-URL: https://api.inmobile.com/v4/sms/outgoing?apikey= [din API-nøgle her]
   
   3.1 Opret din unikke API-nøgle i inMobile
   Det gør du på din inMobile konto -> API -> API-nøgler -> Generer API-nøgle. Kopier API-nøkkelen, og lim den inn på slutten av API-URL-en.
4. Indsæt webhook script og tilpas teksten
   Når du har indsat din API-URL og din unikke API-nøgle, scroller du ned til punktet ”JSON BODY”. Her indsætter du følgende JSON-script:
   

             
               {
     "messages": [
      {
       "to": "{{ person.phone_number }}",
       "countryHint": "45",
       "from": "inMobile",
       "text": "Hej {{ person.first_name }}. \nDette er en test-SMS med linjeskift. \nDbh. inMobile \nAfmeld: s.inmobile.com"
      }
     ]
   }
             
           

   Tilpas scriptet, så du får den rigtige afsender, modtager og indhold i beskeden. Gør det gerne i et tekstdokument, da det er mere overskueligt end at rette scriptet direkte i Klaviyo.
   
   Der er 4 elementer i teksten, du skal tilpasse:
   
   1.”to” = modtagerens telefonnummer
   Når du kopierer teksten ovenfor, står der {{ person.phone_number }} – det er Klaviyos standard mobilnummer felt. Beholder du dette, vil beskeden altså blive sendt til det nummer, som er i kontakternes telefonnummer-felt i Klaviyo. Bruger du en custom property til at opsamle telefonnumre, er det i stedet den custom property, du skal indsætte her.
   
   2. ”countryHint” = landekode match
   CountryHint er en fallback for landekode. Har du landekoder på dine kontakters telefonnummer, må de ikke modsige landekoden i countryHint linjen – så leveres beskeden ikke.
   
   Brug countryHint, hvis:
   - dine kontakters telefonnumre er gemt uden landekode
   - du kun sender SMS til ét land per kampagne/flow
   
   Brug ikke countryHint, hvis:
   - du allerede har landekode på alle dine kontakters telefonnumre
   - du vil sende dine SMS’er til flere lande i samme kampagne eller flow.
   
   Vil du ikke bruge countryHints, kan du blot slette denne linje fra dit JSON-script. Vær dog opmærksom på, at er der hverken en landekode i CountryHint eller i kontaktens telefonnummer, vil din besked ikke blive leveret korrekt.
   
   3. ”from” = afsender
   Her indsætter du navnet eller nummeret på afsenderen (maks. 11 karakterer).
   
   4. ”text”= beskedens indhold
   Her indsætter du den tekst, der skal stå i din SMS-besked. Hvis du ønsker å bruke personalisering, for eksempel mottakerens fornavn, setter du inn den riktige "profilegenskapen" fra Klaviyo. Du finner dem rett under JSON-skriptet ditt ved å klikke på "View profile properties".
   
   OBS. Det er ikke mulig å lage et linjeskift direkte i JSON-skriptet. Skriv i stedet "/n" på det punktet i teksten der du vil endre linjen. Ligesom i eksemplet.
5. Når dit script er tilpasset med korrekt modtager, afsender og indhold, kopierer du hele scriptet ind i feltet ”JSON BODY” i dit Klaviyo webhook.
6. Se et preview og send en test til dig selv
   Du bør altid teste din afsendelse, inden flowet går live. Dette gjør du ved å klikke på "Preview Webhook" nederst i menyen til venstre.
   
   Nu får du en boks med et preview af din besked. Nederst på denne er det mulig å sende en test. Laver du en test request, så husk at det er  dit eget  telefonnummer, der skal stå som modtager i JSON-scriptet – og altså ikke Klaviyos telefonnummer felt. Hvis ikke vil du ikke motta testmeldingen, men kontaktene dine vil gjøre det.
7. Er du tilfreds – så er du færdig
   Er testen tilfredsstillende? Deretter endrer du bare "til" tilbake til {{ person.phone_number }} eller den egendefinerte egenskapen der profilens mobilnummer er. Da er SMS-flyten klar til å settes i drift.

Er testen tilfredsstillende? Deretter endrer du bare "til" tilbake til {{ person.phone_number }} eller den egendefinerte egenskapen der profilens mobilnummer er. Da er SMS-flyten klar til å settes i drift.