Logg inn

Prøv gratis

Registrere Viber-maler

Transaksjonelle Viber-meldinger sendes via maler som Viber har godkjent på forhånd. Du registrerer en mal direkte i portalen: du fyller inn ordlyden og variablene, portalen sender malen til Viber for godkjenning, og når den er godkjent, kan du bruke den i moduler og i API-et. Hvordan maler faktureres, står på siden Typer Viber-meldinger.

Før du begynner

En mal registreres alltid under en bestemt Viber-avsender, så først trenger du en registrert Viber-avsender. Før du har det, viser seksjonen for maler bare et varsel i stedet for skjemaet.

Opprette en mal

Åpne SMS og Viber-meldinger → Viber templates i portalen.
Klikk på New template.
Fyll inn skjemaet etter tabellen nedenfor, og legg til variabler ved behov.
Klikk på Skape. Portalen sender malen til Viber for godkjenning.

Felt	Hva du fyller inn
Template key	Din egen betegnelse på malen, maks. 64 tegn. Portalen lagrer den med små bokstaver, uten diakritiske tegn, og erstatter mellomrom og andre tegn med bindestrek. Den nøyaktige formen ser du i mallisten under navnet, med `@` foran – det er slik du kaller opp malen fra API-et
Name	Navnet på malen, maks. 64 tegn. Bare bokstaver, sifre og mellomrom er tillatt – andre tegn fjerner portalen
Avsender	Viber-avsenderen som malen godkjennes under, og som meldingene deretter sendes fra
Type	`Transactional` for varsler, `OTP` for engangskoder til bekreftelse
Språk	Språket i malens ordlyd. Det forhåndsutfylles med språket du bruker portalen på
Meldingstekst	Ordlyden i malen, maks. 875 tegn

For én avsender kan samme nøkkel ikke ha to maler på samme språk. Et annet språk legger du til i samme mal som en språkversjon.

Variabler

En variabel er et sted i teksten som erstattes med en konkret verdi når meldingen sendes, for eksempel et ordrenummer.

Du legger til en variabel med knappen Add variable. En mal kan ha høyst 8.
For hver av dem fyller du inn Variabelt navn (maks. 50 tegn) og Example value (maks. 125 tegn). Eksempelet er obligatorisk – det sendes til Viber sammen med malen for godkjenning.
I teksten skrives en variabel som {{navn}}. Du kan skrive den for hånd eller sette den inn med knappen {} ved siden av variabelen – den settes inn på slutten av teksten.

Eksempeltekst med de to variablene number og date:

Bestillingen din {{number}} er sendt, og vi leverer den {{date}}. Takk for handelen.

Regler for variabler

Hver variabel i listen må brukes i teksten.
Teksten kan ikke inneholde {{…}} med et navn som ikke finnes i listen over variabler.
En variabel kan ikke stå helt i begynnelsen av teksten. For typen Transactional kan den heller ikke stå helt på slutten.

Tips

Når en variabel står i begynnelsen eller på slutten av teksten, viser portalen ingen melding – knappen Skape forblir bare inaktiv. Hvis malen ikke kan opprettes og ingen feil vises, bør du først sjekke begynnelsen og slutten av teksten.

OTP-mal

For typen OTP legger portalen selv til variabelen pin med eksempelverdien 0451. Bekreftelseskoden fylles inn i den når meldingen sendes. Variabelen pin kan ikke gis nytt navn eller fjernes, og den må brukes i teksten. I motsetning til i en transaksjonsmal kan den også stå på slutten av teksten.

Godkjenning av malen

Når malen er opprettet, vises den i listen. For hver språkversjon ser du teksten, statusen og, ved siden av statusen, malens ID hos Viber.

I påvente av – Viber vurderer fortsatt malen.
Approved – du kan bruke malen.
En avvist mal ble ikke godkjent av Viber og kan ikke brukes.

Statusen i listen endres av seg selv så snart Viber har vurdert malen.

Viktig

Før en mal har statusen Approved, sender ikke portalen meldinger via den og tilbyr den ikke i moduler.

Verken en godkjent eller en avvist mal kan redigeres i portalen. For å endre ordlyden sletter du språkversjonen og oppretter den på nytt med samme nøkkel – den nye ordlyden går gjennom godkjenning igjen.

Merk

En mal som er opprettet for avsenderen din hos Viber utenfor portalen, legges automatisk til i listen og får en generert nøkkel.

Språkversjoner

Én mal kan ha ordlyd på flere språk. Et nytt språk legger du til med ikonet ⊕ Add language version ved siden av malen i listen. Nøkkel, navn, avsender og type forblir de samme – du velger bare språket, skriver teksten og fyller inn variablene.

Hver språkversjon godkjennes separat og har sin egen status. Når du sender, velger du alltid en bestemt språkversjon.

En språkversjon sletter du med søppelbøtteikonet ved siden av den. Etter bekreftelse slettes den både i portalen og hos Viber.

Bruke en mal

I moduler

I seksjonen Moduler og APIer åpner du innstillingene for varsler, og for Viber-kanalen bytter du meldingsteksten fra fritekst til en registrert mal. Velg den deretter fra listen – bare godkjente maler fra avsenderen som er valgt for varselet, tilbys, hver språkversjon for seg.

For hver variabel i malen vises et felt der du kan sette inn modulvariabler. Hvis du lar feltet stå tomt, brukes verdien av modulvariabelen med samme navn. Resultatet ser du i forhåndsvisningen under feltene.

Via API-et

I Advanced transactional API sendes en mal i objektet viber med disse parameterne:

Parameter	Verdi
`template_id`	Malnøkkelen med `@` foran, f.eks. `@order-confirmation`, eller malens ID hos Viber fra mallisten
`template_language`	Koden for språkversjonen du vil sende. Hvis den utelates, brukes `en`
`template_parameters`	Verdiene for alle variablene i malen under navnene deres, f.eks. `{"number": "12345", "date": "på fredag"}`. Hver kortes ned til 125 tegn

De fleste språk har en tobokstavskode (cs, sk, en, de…). Unntakene er fransk fr_FR, spansk es_ES, portugisisk pt_BR og pt_PT, og kinesisk zh-Hans og zh-Hant.

API-et sender ikke meldingen via malen når malen ikke finnes, ikke har den forespurte språkversjonen, ikke er godkjent eller ikke får alle variablene sine.

Var denne siden nyttig?

Spør AI Kopiert