Sprievodca Mokapenom

WhatsApp Business

Integrácie WhatsApp Business prepojí WhatsApp Business číslo vaší organizácie s Mokapenem: môžete odesílat a — na rozdíl od SMS — tiež přijímat zprávy od kontaktů a spravovat konverzace priamo z karty kontaktu alebo zo sjednocené schránky Zprávy vedle SMS a chatu.

Důležité: kanál používá oficiální Meta WhatsApp Business platformu. K prepojenia potrebujete Meta Business účet a Meta Developer aplikaci s nakonfigurovaným produktem WhatsApp (viz sekce Požiadavky): nie je to přímé prepojenia s aplikací WhatsApp na osobním telefónu.

Obecný prehľad integrácií: Integrácie.

Požiadavky

• Plán Mokapen zahrnující integráciu WhatsApp Business (Premium — ikona medaily na stránke, pokud nie je ve vašem plánu dostupná).
• Ověřené Meta Business portfolio.
• Meta Developer aplikácie prepojená s tímto portfoliem, s nakonfigurovaným produktem WhatsApp.
• Telefonní číslo ne už prepojené s osobní aplikací WhatsApp, aplikací WhatsApp Business alebo jiným poskytovatelem WhatsApp Business API. Je-li číslo registrované jinde, musí byť nejprve migrováno do nastavenia Mokapen podľa migračního procesu Meta: v prípadě potřeby kontaktujte podporu Mokapen.
• Kredit dostupný v peněžence organizácie: každá odeslaná zpráva odečte kredit podľa cílové krajina a kategorie zprávy (viz sekce Kredit a ceny).

Prepojenia WhatsApp Business účtu

Prepojenia probíhá cez Embedded Signup Meta, tedy okno prihlásenie Meta/Facebook, ktoré vás provede výběrem Business portfolia, WhatsApp Business účtu (WABA) a čísla k prepojenia — nie je to jednoduché naskenování QR kódu.

1. Používateľské menu → Integrácie → WhatsApp Business.
2. Kliknite na Connect WhatsApp Business (vyžaduje «vhodný plán Premium»).
3. Přihlaste se Meta účtem v otevřeném okně a postupujte podľa kroků: zvoľte Business portfolio, WhatsApp Business účet a telefónní číslo k prepojenia.
4. Potvrďte: Mokapen obdrží potřebná oprávnenia a automaticky se přihlásí k notifikacím (webhook) pre daný účet.

Ak Meta počas prepojenia oznámí, že číslo je u jiného poskytovatele WhatsApp Business API, zvoľte navrhovanou možnost migrace a potvrďte, že číslo je už na WhatsApp Business API; ak je číslo stále v osobní aplikaci WhatsApp, musí byť nejprve smazán účet pre toto telefónní číslo a počkat asi 15 minut pred ďalšiem pokusem. Je-li na čísle aktívna dvoufázové ověření, musí byť pred prepojeniam vypnuto (v WhatsApp Manager alebo u současného poskytovatele).

Aktivace čísla

Po Embedded Signup musí byť číslo aktivováno, než budete moci odesílat zprávy:

1. Na stránke Integrácie → WhatsApp Business kliknite na Activate number.
2. Ak se zobrazí výzva, požiadajte o ověřovací kód SMS alebo hlasovým hovorem na prepojené číslo a zadajte ho po obdržení.
3. Zadajte 6místný PIN: pokud u čísla už existuje dvoufázové ověření, použite stávající PIN; jinak se tento stane novým PIN, ktorý Meta v budúcnu vyžaduje pre operace s číslem.
4. Volitelně: zvoľte region lokalizace dat. Po aktivaci lzo změnit iba odregistrací a novou registrací čísla.
5. Potvrďte: je-li vše v pořádku, číslo přejde do stavu aktívna a integráciu môžete používať.

Meta povoluje maximálně 10 registračních požadavků pre stejné telefónní číslo v okně 72 hodin: po překročení limitu počkejte pred ďalšiem pokusem. Je-li PIN nesprávný, overte ho v WhatsApp Manager alebo resetujte u predchádzajúceho poskytovatele, pokud jste číslo právě migrovali.

Kredit a ceny

Odesílání WhatsApp zpráv je pay-as-you-go: používá stejnou peněženku organizácie (předplacený kredit) jako ostatní funkce s platbou za použití v Mokapenu, napr. SMS — nie je to samostatný kredit.

• Cena za zprávu závisí na cílové zemi čísla a kategorii zprávy (marketing, utility, authentication alebo bezplatná konverzační zpráva v rámci 24hodinového okna — viz ďalšie sekce).
• Stránka Integrácie → WhatsApp Business vždy zobrazuje dostupný kredit organizácie s přímým odkazem na dobití peněženky.
• Kredit se odečítá v okamžiku odoslania, ne předem.
• Ak kredit nestačí, odoslania je blokováno a Mokapen zobrazí upozornění — «Insufficient WhatsApp Business credits. Please top up your credits to send messages.» — s přímým odkazem na stránku dobíjení.

Dobití peněženky vidí Vlastník a členovia s oprávneniam v organizácii; pred kampanemi alebo hromadným odoslaniam marketingových šablon skontrolujte zůstatek.

Ruční odoslania zprávy

Tlačidlo pre odoslania WhatsApp je na karte kontaktu. Po stisknutí ikony WhatsApp:

1. Vyberte telefónní číslo kontaktu, na ktoré píšete (z těch na karte).
2. Máte-li prepojeno viac WhatsApp Business účtů, zvoľte, ktorý použít.
3. Jste-li v rámci 24hodinového okna (kontakt vám nedávno psal, viz ďalšie sekce), môžete psát volný text jako v běžném WhatsApp. Jste-li mimo okno alebo ide o první kontakt, musíte zvolit schválenou šablonu od Meta: v menu lzo vybrat iba šablóny se stavom Approved.
4. Má-li šablóna zástupné symboly ({{1}}, {{2}}…), doplňte požadované hodnoty pred pokračováním: bez hodnot zostane šablóna neaktívna.
5. Skontrolujte náhled zprávy (jako WhatsApp bublina) a stlačte Odeslat. Pri úspěchu se zobrazí potvrzení «WhatsApp Business message sent successfully.» a zpráva se zapíše do história kontaktu.

Ak ešte nemáte aktívna integráciu WhatsApp Business, tlačidlo vás přesměruje na stránku Integrácie → WhatsApp Business k dokončení prepojenia.

24hodinové okno

WhatsApp Business uplatňuje pravidlo platné pre každou firmu na platformě, nelen Mokapen: volný text (bez šablóny) môžete kontaktu psát iba do 24 hodin od poslední zprávy, ktorú vám kontakt poslal — tzv. customer care window.

• Napíše-li vám kontakt, okno se otevře (alebo obnoví) a 24 hodin môžete volně odpovídat textem alebo prílohami.
• Po uplynutí 24 hodin bez nové prichádzajúcu zprávy, alebo pokud jste od daného čísla nikdy zprávu neobdrželi, musíte k psaní použít schválenou šablonu od Meta (viz ďalšie sekce): tak zahajujete alebo obnovujete obchodné konverzaci mimo okno.
• Pokusíte-li se mimo okno odeslat volný text, odoslania je blokováno: zvoľte vhodnou šablonu (typicky kategorie Utility) namiesto volné zprávy.

WhatsApp Business šablóny

Message templates sú předem schválené formáty od Meta, nutné k zahájení konverzace alebo psaní mimo 24hodinové okno. Spravovat je môžete dvěma způsoby:

• Synchronizovať šablóny už existující na Meta — zo stránky Integrácie → WhatsApp Business použite Sync templates: Mokapen importuje šablóny se stavom Approved, ktoré ešte nesú prepojené, abyste je hned mohli použít pri ručním odesílání.
• Vytvoriť alebo upraviť šablóny v Mokapenu — v Nastavenia → Šablóny, typ WhatsApp Business: vytvorenie, úprava alebo smazání probíhá priamo na Meta cez prepojenou aplikaci a stav schválení se automaticky aktualizuje, keď Meta hlásí změnu.

Důležitá pravidla pri vytváření šablóny:

• Kategorie — Utility (transakční aktualizácie očekávané používaťeľam: stav objednávky, připomínky schôdzok, upozornění k účtu), Marketing (propagace, ponuky, newslettery: vyžaduje explicitní souhlas príjemcu s WhatsApp zprávami od vaší firmy) alebo Authentication (OTP alebo ověřovací kódy, s dedikovanými tlačítky). Kategorie musí odpovídat skutečnému obsahu: nesprávné zařazení môže vést k zamítnutí alebo nižšímu quality score.
• Struktura — volitelná hlavička (text, obrázek, video, dokument alebo poloha), povinné tělo, volitelná patička, až 3 tlačítka (rychlá odpověď, URL odkaz alebo telefónní číslo).
• Názov — iba malá písmena, číslice a podtržítka (napr. order_confirmation), jedinečný na účet a jazyk.
• Zástupné symboly — používejte {{1}}, {{2}}, {{3}} v pořadí a bez mezer; pri vytváření uveďte ukázkové hodnoty.
• Limity znaků — tělo až 1 024 znaků, text hlavičky a patičky až 60 znaků každý, popisek tlačítka až 20 znaků, až 3 tlačítka na šablonu.

Každou šablonu pred použitím kontroluje Meta: schválení obvykle trvá několik minut, někdy až 24 hodin. Zamítnutá šablóna zobrazí důvod zamítnutí; nízký quality score alebo příliš mnoho blokování/nahlášení od príjemcov môže omezit WhatsApp Business účet.

História, konverzace a příjem

Na rozdíl od SMS je WhatsApp Business obousměrný: kontakt vám môže volně psát a zpráva skutečně dorazí jako nová konverzace v Mokapenu.

• Karta kontaktu — história/časová os zobrazuje odoslané i přijaté zprávy s textovým náhledem.
• Schránka Zprávy — vlákna WhatsApp se zobrazují vedle SMS a chatu ve stejné sjednocené schránce, s vyhľadávaniem v textu. Na rozdíl od SMS Mokapen u WhatsApp automaticky aktualizuje stav doručení a přečtení (odoslané, doručeno, přečteno), jak Meta hlásí udalosti.
• Kontakt vám môže poslat text, obrázky, dokumenty, audio, video a nálepky, i jako odpověď na konkrétní zprávu: vše dorazí ve stejném vlákně ve schránce Zprávy.

Limity, ktoré je dobré znát

• Nie je v automatizacích — modul Automatizácie dnes nabízí akcie Odeslat e-mail a Odeslat SMS, ale ne akci WhatsApp Business: odoslania je možné iba ručně z karty kontaktu.
• Volný text iba do 24 hodin — mimo customer care window vždy potrebujete schválenou šablonu od Meta.
• Jeden kanál u kontaktu dnes — tlačidlo odoslania je u Kontaktů; u Spoločnosťí alebo jiných karet WhatsApp odoslania v rozhraní zatím nie je.
• Číslo nelzo sdílet s jiným použitím — číslo prepojené s Mokapen cez WhatsApp Business API nemôže současně zůstat aktívna v osobní aplikaci WhatsApp alebo u jiného poskytovatele API.
• Limit registrace — maximálně 10 pokusů o aktivaci na číslo každých 72 hodin, ukládá Meta, ne Mokapen.

Časté problémy

• Prepojenia nelzo dokončiť — overte ověřené Meta Business portfolio, prepojenou Developer aplikaci s produktem WhatsApp a zkuste Embedded Signup znovu.
• Číslo stále v osobní aplikaci WhatsApp — smažte WhatsApp účet pre toto číslo v telefónu, počkejte asi 15 minut a zkuste prepojenia znovu.
• Číslo už u jiného poskytovatele API — počas prepojenia zvoľte migraci a potvrďte; je-li na čísle aktívna dvoufázové ověření, nejprve ho vypněte v WhatsApp Manager alebo u současného poskytovatele.
• Niesprávný ověřovací PIN — overte 6místný PIN dvoufázového ověření v WhatsApp Manager, alebo ho resetujte u predchádzajúceho poskytovatele po migraci.
• WhatsApp je prepojen, ale webhook subscription selhala — prichádzajúcu zprávy se nemusí zobrazovat: pokud problém přetrvává po opakování prepojenia, kontaktujte podporu Mokapen.
• Volná zpráva se neodesílá — pravděpodobně jste mimo 24hodinové okno: zvoľte schválenou šablonu namiesto volného textu.
• Šablóna zamítnuta Meta — skontrolujte uvedený důvod: kategorie nezodpovedá obsahu, nesprávně očíslované alebo mezerové zástupné symboly, nepovolený obsah (spam, falešná naléhavost, citlivá dátumy) alebo nevyhovující formát.
• Niedostatečný kredit — dobijte peněženku organizácie odkazem na stránke Integrácie → WhatsApp Business alebo v sekci Fakturace.

Odpojenie

Na stránke Integrácie → WhatsApp Business kliknite na Disconnect: otevře se okno se sekcí Keep.

• Políčko Messages & Templates je ve výchozím stavu zaškrtnuté: ponecháte-li ho zaškrtnuté, história zpráv a synchronizované šablóny zůstanou v Mokapenu viditelné i po odpojenie.
• Ak ho zrušíte, Mokapen smaže synchronizované šablóny, WhatsApp vlákna a zprávy prepojené s touto integrácií plus súvisiace mediální súbory.

V každém prípadě se vždy odstraní prepojenia s Meta účtem a webhook subscription. Jste-li používaťeľ, se ktorým byla integrácie sdílena (ne vlastník), odpojenie odstraní iba váš prístup: integrácie zostane pre organizácii aktívna. Pre potvrzení zadajte do požadovaného pole DISCONNECT.

Prípady použitia

• Potvrzení objednávky alebo schôdzky — použite schválenou šablonu Utility k potvrzení právě uzavřené objednávky alebo domluvené schôdzky: zákazník dostane upozornění, i keď vám ešte nepsal, bez čekání na otvorenia e-mailu.
• Zákaznická podpora v reálnom čase — zákazník vám napíše na WhatsApp s dotazem: zpráva dorazí na kartu kontaktu a do schránky Zprávy a ďalšiech 24 hodin môžete odpovídat volným textem, obrázky alebo dokumenty bez šablóny.
• Aktualizácie stavu zásilky — Utility šablóna se zástupnými symboly pre číslo objednávky a očekávané dátum, odeslaná ručně z karty kontaktu pri změně stavu zásilky.
• Ověřovací kód — šablóna kategorie Authentication s dedikovaným OTP tlačítkem, užitečná pre spolehlivé odoslania bezpečnostního kódu kontaktu se záznamem v historii.
• Kampaň s explicitním souhlasem — Marketing šablóna odeslaná iba kontaktům, ktorí dali explicitní souhlas s WhatsApp zprávami od firmy, napr. k oznámení sezónní akce.

Často kladené otázky

O: Mohu v Mokapenu přijímat zprávy od zákazníků, na rozdíl od SMS?

A: Áno. WhatsApp Business je obousměrný: napíše-li vám kontakt, zpráva se zobrazí jako nová konverzace na karte kontaktu a ve schránce Zprávy a do 24 hodin môžete odpovídat volným textem.

O: Opravdu potřebuji Meta Business účet k prepojenia WhatsApp?

A: Áno. Potrebujete ověřené Meta Business portfolio a Meta Developer aplikaci s nakonfigurovaným produktem WhatsApp: prepojenia probíhá cez Embedded Signup Meta, ne přímým prihláseniem v aplikaci WhatsApp v telefónu.

O: Moje číslo je už v běžném WhatsApp alebo u jiného poskytovatele: mohu ho stále propojit?

A: Áno, ale nejprve musí byť uvolněno alebo migrováno: je-li v osobní aplikaci WhatsApp, smažte účet pre toto telefónní číslo a počkejte asi 15 minut; je-li u jiného poskytovatele WhatsApp Business API, počas prepojenia zvoľte migraci a potvrďte.

O: Mohu zákazníkovi psát volně kdykoli?

A: Nie. Volný text môžete psát iba do 24 hodin od poslední zprávy, ktorú vám zákazník poslal. Mimo toto okno, alebo pre první kontakt, musíte použít šablonu schválenou Meta.

O: Jak vytvorím alebo aktualizuji message template?

A: V Nastavenia → Šablóny, typ WhatsApp Business: šablonu vytvoríte alebo upraviete, uloží se a odešle ku schválení priamo na Meta. Alternativně, máte-li schválené šablóny na Meta, použite Sync templates zo stránky Integrácie → WhatsApp Business k importu.

O: Kolik stojí odoslania WhatsApp zprávy?

A: Cena závisí na cílové zemi a kategorii zprávy (marketing, utility, authentication alebo bezplatná konverzace v rámci 24hodinového okna). Kredit se odečítá z peněženky organizácie v okamžiku odoslania: dostupný zůstatek najdete na stránke Integrácie → WhatsApp Business.

O: Je WhatsApp Business dostupný jako akcie v automatizacích, jako E-mail alebo SMS?

A: Zatím ne: modul Automatizácie dnes nabízí iba Odeslat e-mail a Odeslat SMS. Odesílání WhatsApp zpráv je možné iba ručně z karty kontaktu.

O: Proč Meta zamítla mou šablonu?

A: Niejčastější důvody: kategorie nezodpovedá skutečnému obsahu zprávy, nesprávně očíslované alebo mezerové zástupné symboly, nepovolený obsah (spam, falešná naléhavost, požiadavky na citlivá dátumy) alebo formát nevyhovující pravidlům struktury. Přesný důvod zamítnutí zobrazí Meta u šablóny.

O: Čo sa stane s daty po odpojenie integrácie?

A: Se zaškrtnutím políčkem «Messages & Templates» (výchozí) zostane história zpráv a synchronizované šablóny viditelná v Mokapenu. Po zrušení políčka Mokapen smaže šablóny, vlákna, zprávy a mediální súbory prepojené s touto integrácií. Prepojenia s Meta účtem se vždy odstraní.

O: Mohu ve stejné organizácii používať viac WhatsApp Business čísel?

A: Áno, pokud váš WhatsApp Business účet (WABA) má prepojeno viac čísel, alebo prepojíte viac účtů: v editoru, je-li k dispozícii viac než jedna možnost, pred odoslaniam zvoľte, ktorú použít jako odesílatele.