Mokapen-guiden

WhatsApp Business

Integrationen WhatsApp Business forbinder et WhatsApp Business-nummer for jeres organisation til Mokapen: I kan sende og — i modsætning til SMS — også modtage beskeder fra jeres kontakter og administrere samtaler direkte fra kontaktkortet eller fra den samlede indbakke Messages sammen med SMS og chat.

Vigtigt: kanalen bruger den officielle Meta WhatsApp Business-platform. For at forbinde den skal I have en Meta Business-konto og en Meta Developer-app med WhatsApp-produktet konfigureret (se afsnittet Krav): det er ikke en direkte forbindelse med WhatsApp-appen på jeres private telefon.

Generelt overblik over integrationer: Integrationer.

Krav

• En Mokapen-plan, der inkluderer WhatsApp Business-integrationen (Premium — medaljeikon på siden, hvis den ikke er tilgængelig på din plan).
• En verificeret Meta Business-portfolio.
• En Meta Developer-app linket til det portfolio med WhatsApp-produktet konfigureret.
• Et telefonnummer ikke allerede linket til personlig WhatsApp-app, WhatsApp Business-app eller en anden WhatsApp Business API-udbyder/tjeneste. Hvis nummeret allerede er registreret andetsteds, skal det først migreres til Mokapen-opsætningen efter Metas migrationsproces: kontakt Mokapen-support, hvis I har brug for hjælp til migration.
• Kredit tilgængelig i organisationens wallet: hver sendt besked trækker kredit baseret på destinationsland og beskedkategori (se afsnittet Kredit og priser).

Forbind WhatsApp Business-kontoen

Forbindelsen sker via Metas Embedded Signup, dvs. et Meta/Facebook-loginvindue, der guider jer gennem valg af Business-portfolio, WhatsApp Business-konto (WABA) og nummeret der skal forbindes — det er ikke en simpel QR-kode at scanne.

1. Brugermenu → Integrationer → WhatsApp Business.
2. Klik Connect WhatsApp Business (kræver passende Premium-plan).
3. Log ind med jeres Meta-konto i vinduet, der åbnes, og følg de guidede trin: vælg Business-portfolio, WhatsApp Business-konto og telefonnummeret der skal forbindes.
4. Bekræft: Mokapen modtager de nødvendige tilladelser og abonnerer automatisk på notifikationer (webhook) for den konto.

Hvis Meta under forbindelsen rapporterer, at nummeret allerede er hos en anden WhatsApp Business API-udbyder, vælg den foreslåede migration og bekræft, at nummeret allerede er på WhatsApp Business API; hvis nummeret stadig er på personlig WhatsApp-app, skal kontoen for den telefon først slettes, vent ca. 15 minutter, og prøv igen. Hvis totrinsverifikation er aktiv på nummeret, skal den deaktiveres før forbindelse (i WhatsApp Manager eller via nuværende udbyder).

Aktivering af nummeret

Efter Embedded Signup skal nummeret aktiveres, før I kan sende beskeder:

1. På siden Integrationer → WhatsApp Business klik Activate number.
2. Hvis du bliver bedt om det, anmod om en verifikationskode via SMS eller taleopkald til det forbundne nummer, og indtast den, når den ankommer.
3. Indtast en 6-cifret PIN: hvis totrinsverifikation allerede findes på nummeret, brug den eksisterende PIN; ellers bliver dette den nye PIN, Meta vil kræve fremover ved operationer på nummeret.
4. Valgfrit: vælg en data localization region. Når den er aktiveret, kan den kun ændres ved afregistrering og genregistrering af nummeret.
5. Bekræft: hvis alt er korrekt, skifter nummeret til status active, og I kan begynde at bruge integrationen.

Meta tillader maksimalt 10 registreringsanmodninger for samme telefonnummer inden for 72 timer: hvis grænsen overskrides, vent før næste forsøg. Hvis PIN er forkert, tjek den i WhatsApp Manager, eller nulstil med tidligere udbyder, hvis I lige har migreret nummeret.

Kredit og priser

Afsendelse af WhatsApp-beskeder er pay-as-you-go: den bruger samme organisations-wallet (forudbetalt kredit) som andre pay-per-use-funktioner i Mokapen, fx SMS — det er ikke separat kredit.

• Omkostning pr. besked afhænger af destinationsland for nummeret og beskedens kategori (marketing, utility, authentication eller gratis samtalebesked inden for 24-timers vinduet — se næste afsnit).
• Siden Integrationer → WhatsApp Business viser altid organisationens tilgængelige kredit med direkte link til opfyldning af wallet.
• Kredit trækkes ved afsendelse, ikke før.
• Hvis kredit ikke er nok, blokeres afsendelse, og Mokapen viser en advarsel — «Insufficient WhatsApp Business credits. Please top up your credits to send messages.» — med direkte link til opfyldningssiden.

Wallet-opfyldning er synlig for Owner og for medlemmer med tilladelse i organisationen; tjek saldo før kampagner eller masseafsendelse af marketing-skabeloner.

Send besked manuelt

WhatsApp-send-knappen er tilgængelig på kontaktkortet. Når du trykker på WhatsApp-ikonet:

1. Vælg kontaktens telefonnummer at skrive til (blandt dem på kortet).
2. Hvis du har mere end én WhatsApp Business-konto linket, vælg hvilken der skal bruges.
3. Hvis du er inden for 24-timers vinduet (kontakten skrev for nylig til dig, se næste afsnit), kan du skrive en fritekstbesked som på almindelig WhatsApp. Hvis du er uden for vinduet, eller det er første kontakt, skal du vælge en godkendt skabelon fra Meta: kun skabeloner med status Approved kan vælges i menuen.
4. Hvis skabelonen har placeholders ({{1}}, {{2}}…), udfyld de påkrævede værdier før du fortsætter: uden værdier forbliver skabelonen deaktiveret.
5. Tjek beskedforhåndsvisning (vist som WhatsApp-boble), og tryk Send. Ved succes vises bekræftelsen «WhatsApp Business message sent successfully.», og beskeden kommer i kontaktens historik.

Hvis du endnu ikke har en aktiv WhatsApp Business-integration, omdirigerer knappen dig til siden Integrationer → WhatsApp Business for at fuldføre linket først.

24-timers vinduet

WhatsApp Business håndhæver en regel, der gælder alle virksomheder på platformen, ikke kun Mokapen: du kan skrive fritekst (uden skabelon) til en kontakt kun inden for 24 timer efter den sidste besked, kontakten sendte dig — det såkaldte customer care window.

• Hvis kontakten skriver til dig, åbnes (eller fornyes) vinduet, og i 24 timer kan du svare frit med tekst eller vedhæftninger.
• Når 24 timer er gået uden ny indgående besked, eller hvis du aldrig har modtaget besked fra det nummer, skal du bruge en godkendt skabelon fra Meta for at skrive (se næste afsnit): sådan starter eller genoptager du en forretningssamtale uden for vinduet.
• Hvis du prøver at sende fritekst uden for vinduet, blokeres afsendelse: vælg en passende skabelon (typisk kategori Utility) i stedet for fritekst.

WhatsApp Business-skabeloner

Message templates er forhåndsgodkendte formater fra Meta, påkrævet for at starte en samtale eller skrive uden for 24-timers vinduet. Du kan administrere dem på to måder:

• Sync templates that already exist on Meta — fra siden Integrationer → WhatsApp Business, brug Sync templates: Mokapen importerer skabeloner med status Approved, der endnu ikke er linket, så du kan bruge dem med det samme ved manuel afsendelse.
• Create or edit templates in Mokapen — i Settings → Templates, type WhatsApp Business: oprettelse, redigering eller sletning sker direkte på Meta via den linkede app, og godkendelsesstatus opdateres automatisk, når Meta rapporterer det.

Vigtige regler ved oprettelse af skabelon:

• Category — Utility (transaktionelle opdateringer brugeren forventer: ordrestatus, aftalepåmindelser, kontoadvarsler), Marketing (kampagner, tilbud, nyhedsbreve: kræver at modtageren udtrykkeligt har givet samtykke til WhatsApp-beskeder fra jeres virksomhed) eller Authentication (OTP eller verifikationskoder med dedikerede knapper). Kategorien skal matche det faktiske indhold: fejlkategorisering kan give afvisning eller lavere kvalitetsscore.
• Structure — valgfri header (tekst, billede, video, dokument eller lokation), påkrævet body, valgfri footer, op til 3 knapper (quick reply, URL-link eller telefonnummer).
• Name — kun små bogstaver, tal og understreg (order_confirmation), unikt pr. konto og sprog.
• Placeholders — brug {{1}}, {{2}}, {{3}} i rækkefølge uden huller; angiv eksempelværdier ved oprettelse.
• Character limits — body op til 1.024 tegn, tekst-header og footer op til 60 tegn hver, knaplabel op til 20 tegn, op til 3 knapper pr. skabelon.

Hver skabelon gennemgås af Meta før brug: godkendelse tager typisk få minutter, nogle gange op til 24 timer. En afvist skabelon viser afvisningsårsag; lav kvalitetsscore eller for mange blokeringer/rapporter fra modtagere kan begrænse WhatsApp Business-kontoen.

Historik, samtaler og modtagelse

I modsætning til SMS er WhatsApp Business tovejs: en kontakt kan skrive til dig frit, og beskeden ankommer som ny samtale i Mokapen.

• Kontaktkort — historik/tidslinje viser både sendte og modtagne beskeder med tekstforhåndsvisning.
• Messages inbox — WhatsApp-tråde vises sammen med SMS og chat i samme samlede indbakke med tekstsøgning. I modsætning til SMS opdaterer Mokapen for WhatsApp automatisk leverings- og læsestatus (sent, delivered, read), når Meta rapporterer hændelserne.
• En kontakt kan sende tekst, billeder, dokumenter, lyd, video og stickers, også som svar på en specifik besked: alt ankommer i samme tråd i Messages inbox.

Grænser at kende

• Ikke tilgængelig i automations — i dag tilbyder Automations-modulet Send Email og Send SMS, men ikke en WhatsApp Business-handling: afsendelse er kun mulig manuelt fra kontaktkortet.
• Fritekst kun inden for 24 timer — uden for customer care window skal du altid bruge godkendt skabelon fra Meta.
• Én kanal på kontakt i dag — send-knappen er på Contacts; for Companies eller andre kort er WhatsApp-afsendelse endnu ikke eksponeret i grænsefladen.
• Nummer kan ikke deles med andre formål — et nummer linket til Mokapen via WhatsApp Business API kan ikke samtidig være aktivt på personlig WhatsApp-app eller hos en anden API-udbyder.
• Registreringsgrænse — maksimalt 10 aktiveringsforsøg pr. nummer hver 72. time, pålagt af Meta, ikke Mokapen.

Almindelige problemer

• Kan ikke fuldføre forbindelsen — tjek at I har verificeret Meta Business-portfolio, linked Developer-app med WhatsApp-produkt konfigureret, og prøv Embedded Signup igen.
• Nummer stadig på personlig WhatsApp-app — slet WhatsApp-kontoen for det nummer på telefonen, vent ca. 15 minutter, og prøv at forbinde igen.
• Nummer allerede hos anden API-udbyder — vælg migrationsmulighed under forbindelse, og bekræft; hvis totrinsverifikation er aktiv på nummeret, deaktiver den først i WhatsApp Manager eller via nuværende udbyder.
• Forkert verifikations-PIN — tjek 6-cifret totrinsverifikations-PIN i WhatsApp Manager, eller nulstil med tidligere udbyder, hvis I lige har migreret.
• WhatsApp er forbundet, men webhook-abonnement fejlede — indgående beskeder vises måske ikke: kontakt Mokapen-support, hvis problemet fortsætter efter genforsøg på forbindelse.
• Fritekstbesked sendes ikke — du er sandsynligvis uden for 24-timers vinduet: vælg godkendt skabelon i stedet for fritekst.
• Skabelon afvist af Meta — tjek den angivne afvisningsårsag: kategori matcher ikke indhold, placeholders nummereret forkert eller med huller, ulovligt indhold (spam, falsk hast, følsomme data) eller format, der ikke overholder strukturregler.
• Insufficient credits — fyld organisationens wallet op via link på siden Integrationer → WhatsApp Business eller fra Billing-sektionen.

Afbryd forbindelse

Fra siden Integrationer → WhatsApp Business klik Disconnect: et vindue åbnes med sektionen Keep.

• Afkrydsningsfeltet Messages & Templates er som standard afkrydset: hvis det forbliver afkrydset, forbliver beskedhistorik og synkroniserede skabeloner synlige i Mokapen efter afbrydelse.
• Hvis du fjerner afkrydsning, sletter Mokapen de synkroniserede skabeloner, WhatsApp-tråde og beskeder knyttet til denne integration plus relaterede mediefiler.

Link til Meta-konto og webhook-abonnement fjernes altid. Hvis du er bruger, integrationen var shared med (ikke owner), fjerner afbrydelse kun din adgang: integrationen forbliver aktiv for organisationen. For at bekræfte skriv DISCONNECT i det påkrævede felt.

Use cases

• Ordre- eller aftalebekræftelse — brug godkendt Utility-skabelon til at bekræfte en ordre, der lige er lukket, eller en aftale, der er sat: kunden modtager notifikationen, selv om de endnu ikke har skrevet til dig, uden at vente på, at de åbner mail.
• Kundesupport i realtid — en kunde skriver på WhatsApp med et spørgsmål: beskeden ankommer på kontaktkortet og i Messages inbox, og de næste 24 timer kan du svare med fritekst, billeder eller dokumenter uden skabelon.
• Opdatering af leveringsstatus — Utility-skabelon med placeholders til ordrenummer og forventet dato, sendt manuelt fra kontaktkortet, når leveringsstatus ændres.
• Verifikationskode — skabelon i kategori Authentication med dedikeret OTP-knap, nyttig når du skal sende sikkerhedskode til kontakt pålideligt med spor i historikken.
• Kampagne med udtrykkeligt samtykke — Marketing-skabelon sendt kun til kontakter, der udtrykkeligt har givet samtykke til WhatsApp-beskeder fra virksomheden, fx for at annoncere sæsonkampagne.

Ofte stillede spørgsmål

Q: Kan jeg modtage beskeder fra mine kunder i Mokapen, i modsætning til SMS?

A: Ja. WhatsApp Business er tovejs: hvis en kontakt skriver til dig, vises beskeden som ny samtale på kontaktkortet og i Messages inbox, og inden for 24 timer kan du svare med fritekst.

Q: Skal jeg virkelig have Meta Business-konto for at forbinde WhatsApp?

A: Ja. I skal have verificeret Meta Business-portfolio og Meta Developer-app med WhatsApp-produkt konfigureret: forbindelsen sker via Metas Embedded Signup, ikke direkte login på telefonens WhatsApp-app.

Q: Mit nummer er allerede på almindelig WhatsApp eller hos anden udbyder: kan jeg stadig forbinde det?

A: Ja, men det skal først frigøres eller migreres: hvis det er på personlig WhatsApp-app, slet kontoen for den telefon, og vent ca. 15 minutter; hvis det allerede er hos anden WhatsApp Business API-udbyder, vælg migrationsmulighed under forbindelse, og bekræft.

Q: Kan jeg skrive frit til en kunde når som helst?

A: Nej. Du kan skrive fritekst kun inden for 24 timer efter kundens sidste besked. Uden for det vindue, eller ved første kontakt, skal du bruge skabelon godkendt af Meta.

Q: Hvordan opretter eller opdaterer jeg en beskedskabelon?

A: I Settings → Templates, type WhatsApp Business: du opretter eller redigerer skabelonen, som gemmes og indsendes til godkendelse direkte på Meta. Alternativt, hvis du allerede har godkendte skabeloner på Meta, brug Sync templates fra siden Integrationer → WhatsApp Business for at importere dem.

Q: Hvad koster det at sende en WhatsApp-besked?

A: Omkostning afhænger af destinationsland og beskedkategori (marketing, utility, authentication eller gratis samtale inden for 24-timers vinduet). Kredit trækkes fra organisationens wallet ved afsendelse: tjek tilgængelig saldo på siden Integrationer → WhatsApp Business.

Q: Er WhatsApp Business tilgængelig som handling i automations, som Email eller SMS?

A: Endnu ikke: i dag tilbyder Automations-modulet kun Send Email og Send SMS. Afsendelse af WhatsApp-beskeder er kun mulig manuelt fra kontaktkortet.

Q: Hvorfor blev min skabelon afvist af Meta?

A: De hyppigste årsager er: kategori matcher ikke det faktiske indhold, placeholders nummereret forkert eller med huller, ulovligt indhold (spam, falsk hast, anmodning om følsomme data) eller format, der ikke overholder strukturregler. Den præcise afvisningsårsag vises af Meta på skabelonen.

Q: Hvad sker der med data, hvis jeg afbryder integrationen?

A: Med afkrydsningsfeltet «Messages & Templates» afkrydset (standard) forbliver beskedhistorik og synkroniserede skabeloner synlige i Mokapen. Uden afkrydsning sletter Mokapen skabeloner, tråde, beskeder og mediefiler knyttet til den integration. Link til Meta-konto fjernes altid uanset valg.

Q: Kan jeg bruge mere end ét WhatsApp Business-nummer i samme organisation?

A: Ja, hvis jeres WhatsApp Business-konto (WABA) har mere end ét nummer linket, eller hvis I linker mere end én konto: i composer vælger du, hvilket der skal bruges som afsender, hvis mere end én mulighed er tilgængelig.