Guide: Opret Klaviyo webhook

Sådan laver du et webhook til 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”. Træk elementet ind i dit flow det sted, hvor du vil sende en SMS-besked.
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øgle og indsæt den i slutningen af din API-URL.
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. Vil du bruge personalisering som f.eks. modtagerens fornavn, skal du indsætte den korrekte ’profile property’ fra Klaviyo. Dem finder du lige under dit JSON-script, ved at klikke på ”View profile properties”.
   
   OBS. Det er ikke muligt at lave et linjeskift direkte i dit JSON-script. Skriv i stedet ”/n” det sted i teksten, hvor du vil skifte linje. 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. Det gør du ved at klikke på ”Preview Webhook” nederst i venstre menu.
   
   Nu får du en boks med et preview af din besked. Nederst i denne er det muligt at 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. Ellers modtager du ikke test-beskeden, det gør dine kontakter.
7. Er du tilfreds – så er du færdig
   Er testen tilfredsstillende? Så skal du blot ændre ”to” tilbage til {{ person.phone_number }} eller den custom property, hvor profilens mobilnummer er. Så er dit flow med SMS klar til at gå live.

Er testen tilfredsstillende? Så skal du blot ændre ”to” tilbage til {{ person.phone_number }} eller den custom property, hvor profilens mobilnummer er. Så er dit flow med SMS klar til at gå live.