Prepojenie WhatsApp Business s CDESK

Obsah stránky

Overenie firmy
Nastavenie platobných metód

Tento návod vás prevedie procesom prepojenia služby WhatsApp Business s CDESK. Vďaka tomuto prepojeniu budete môcť vytvárať požiadavky a komunikovať so zákazníkmi cez WhatsApp priamo prostredníctvom CDESK Portálu.

Viac o používaní WhatsApp s CDESK sa dočítate v článku WhatsApp manuál.

Pre prepojenie WhatsApp Business s CDESK budete potrebovať:

Facebook Bussiness portfólio – Firemný účet v Meta Business Manageri, ktorý bude vlastniť vývojársku aplikáciu pre WhatsApp a telefónne číslo.
Meta vývojársky účet – Účet na Meta for Developers, potrebný na vytvorenie vývojárskej aplikácie pre WhatsApp a získanie prístupových údajov.
Vývojárska aplikácia pre WhatsApp – Aplikácia vytvorená vo vývojárskom účte, ktorá slúži ako konektor medzi CDESK a WhatsApp Business API.
Telefónne číslo – Telefónne číslo, ktoré nie je aktuálne používané v žiadnej WhatsApp aplikácií (osobnej, ani business verzií)

Vytvorenie Business portfólia (Facebook Business účtu)

Prejdite na stránku business.facebook.com a prihláste sa pomocou svojho bežného Facebook účtu. Ak ešte nemáte business portfólio, systém vás vyzve na jeho vytvorenie. Vyplňte úvodný formulár a kliknite na Submit.

**Obrázok:** Vytvorenie Business portfólia

Po úspešnom prihlásení alebo vytvorení účtu sa otvorí prostredie Meta Business Suite, kde budete môcť spravovať firemné aktíva, ako napríklad stránky, účty, WhatsApp čísla a podobne.

Ako ďalšie potvrďte svoju e-mailovú adresu. Potom prejdite do Settings -> Business portfolio info a vyplňte základné údaje o vašej spoločnosti.

**Obrázok:** Vyplnenie údajov o spoločnosti

Vytvorenie Meta vývojárskeho účtu

Prejdite na stránku developers.facebook.com a prihláste sa do svojho vývojárskeho účtu (Meta developer account). Ak vývojársky účet ešte nemáte, systém Vás prevedie registračným formulárom.

**Obrázok:** Vytvorenie nového Meta vývojárskeho účtu

**Obrázok:** Voľba roly konta (odporúčame Developer)

Vytvorenie vývojárskej aplikácie

Po úspešnom prihlásení do Meta vývojárskeho účtu je potrebné vytvoriť vlastnú vývojársku aplikáciu, ktorá bude slúžiť ako konektor medzi CDESK a službou WhatsApp Business API.

Prejdite na stránku Apps a kliknite na tlačidlo Create App.

**Obrázok:** Tlačidlo Create App v zozname aplikácií vo vývojárskom účte

Zobrazí sa formulár, kde zadáte názov aplikácie a kontaktný e-mail, ktorý bude slúžiť na oznámenia z Meta.

Pri voľbe spôsobu použitia zvoľte Other a kliknite na Next. Týmto krokom vás Meta presmeruje do staršieho prostredia na vytvorenie aplikácie, ktoré je kompatibilné s WhatsApp API.

**Obrázok:** Výber spôsobu použitia aplikácie

V ďalšom kroku zvoľte ako typ aplikácie možnosť Business.

Znovu vyplňte názov aplikácie, kontaktný e-mail a prideľte aplikáciu do vytvoreného business portfólia. Potom kliknite na Create app. Meta vás vyzve na zadanie hesla k vášmu Facebook účtu.

**Obrázok:** Vytvorenie vývojárskej aplikácie

Po vytvorení aplikácie pridajte produkt WhatsApp do aplikácie kliknutím na Set up. Ak túto obrazovku nevidíte, alebo ste z nej už odišli, viete sa k nej vrátiť kliknutím na Add Product.

**Obrázok:** Pridanie produktu WhatsApp vo vytvorenej aplikácií

Nastavenie WhatsApp API vo vývojárskej aplikácií

Po vytvorení vývojárskej aplikácie je ďalším krokom nastavenie WhatsApp API pre vašu aplikáciu. Tento proces zahŕňa pripojenie vlastného telefónneho čísla, ktoré bude slúžiť ako oficiálny WhatsApp Business účet.

Hneď po vytvorení aplikácie sa vám zobrazí úvodná obrazovka. Ak je nastavené správne Business portfólio, kliknite na Continue.

V záložke Quickstart kliknite na Start using API, čo vás presmeruje na záložku API Setup.

V tejto záložke pridáte svoje vlastné telefónne číslo. Meta vám automaticky pridelila testovacie číslo, s ktorým síce môžete prepojenie otestovať, no pre produkčné použitie musíte pridať vlastné číslo. Pre jeho pridanie kliknite na Add phone number.

Vyplňte formulár pre pridanie telefónneho čísla, čím vytvoríte WhatsApp Business účet. Meno a popis sa bude zákazníkom zobrazovať pri komunikácií cez WhatsApp.

**Obrázok:** Formulár pre pridanie telefónneho čísla

**Obrázok:** Overenie telefónneho čísla pomocou kódu

Po overení telefónneho čísla sa presuniete do vášho Business Portfolia (business.facebook.com) a vytvoríte systémového používateľa, ktorý bude zabezpečovať permanentný Access token.

Vytvorenie permanentného Access tokenu pomocou Systémového používateľa

Vo vašom Business Portfóliu (business.facebook.com) prejdite do časti System users a kliknite na +Add. Otvorí sa formulár pre vytvorenie nového System usera. Zvoľte mu meno a rolu. Rola Employee postačuje. Po vyplnení kliknite na Create system user.

**Obrázok:** Vytvorenie nového System usera

Po vytvorení System usera mu bude potrebné prideliť oprávnenia k vytvorenej vývojárskej aplikácií a WA business účtu.

Pri vytvorenom System userovi kliknite na tri bodky a tlačidlo Assign assets. Zobrazí sa vám formulár pri prideľovanie oprávnení. V záložke Apps vyberte vašu vytvorenú vývojársku aplikáciu a prideľte mu všetky oprávnenia: Full control -> Manage app.

**Obrázok:** Pridelenie oprávnení k vývojárskej aplikácií

Potom sa presuňte do záložky WhatsApp accounts a vyberte WA Business účet s vaším telefónnym číslo (ten, ktorý ste vytvorili na konci predchádzajúcej sekcie článku). Prideľte mu všetky oprávnenia: Full control -> Manage WhatsApp business accounts. Potom kliknite na Assign assets, čím sa oprávnenia pridelia.

**Obrázok:** Pridelenie oprávnení k WA Business účtu

Následne prejdite k vytvoreniu Access tokenu pomocou tohto System usera. Kliknite na Generate token. Zobrazí sa vám formulár pre vygenerovanie Access tokenu. V prvom kroku vyberte vašu vývojársku aplikáciu.

**Obrázok:** Výber vývojárskej aplikácie pre vygenerovanie Access tokenu

Exspiráciu tokenu nastavte na Never (nikdy).

**Obrázok:** Nastavenie exspirácie tokenu

V ďalšom kroku pridajte nasledovné oprávnenia:

whatsapp_business_management
whatsapp_business_messaging

**Obrázok:** Pridanie whatsapp oprávnení

V poslednom kroku sa vám vygeneruje permanentný Access token. Pred zatvorením okna tento token skopírujte a uložte. Po zatvorení okna už nebudete môcť tento token zobraziť a bude ho potrebné vygenerovať znova.

**Obrázok:** Vygenerovaný permanentný token

Príprava pre produkčné používanie

Overenie firmy

Pre produkčné používanie služby WhatsApp Business API je nevyhnutné, aby bola vaša firma overená (verifikovaná). Na overenie budete potrebovať oficiálny dokument, ktorý potvrdzuje existenciu vašej firmy. Napríklad potvrdenie o vedení účtu od banky alebo výpis z ORSR. Údaje v tomto dokumente sa musia zhodovať s údajmi zadanými v Business portfóliu. Viac o podporovaných dokumentoch sa dočítate na stránkach Meta.

Otvorte vaše Business Portfólio (business.facebook.com) a prejdite do Settings -> Business portfolio info. V sekcií Business verification status kliknite na View details.

**Obrázok:** Vstup do business portfólia

Potom kliknite na tlačidlo Start verification a postupne vyplňte verifikačný formulár.

Po úspešnom overení sa v sekcií Business verification zobrazí status Verified.

Nastavenie platobných metód

Na používanie WhatsApp Business API je nevyhnutné, aby bol nastavený platobný spôsob. Bez platného spôsobu platby nie je možné plne využívať produkčné funkcie WhatsApp API. Tento proces však nie je spojený s okamžitými nákladmi. Bežná komunikácia je bezplatná. Pri použití automatizovaných správ, šablón, posielaní notifikácií, či komunikácií po prejdení 24h od poslednej správy sa môžu účtovať poplatky. Viac o poplatkoch za používanie WhatsApp API sa dočítate na stránkach Meta.

Otvorte vaše Business Portfólio (business.facebook.com) a v menu kliknite na Billing & payments.

**Obrázok:** Otvorenie Billing & payments v Business portfóliu

Prejdite do záložky Accounts -> WhatsApp Bussiness accounts a pri WA Business účte, pod ktorý patrí vaše vlastné pridané číslo, kliknite na Add payment method.

Otvorí sa formulár pre pridanie platobnej metódy. Po jeho vyplnení je platobná metóda nastavená.

**Obrázok:** Jeden z krokov formuláru pre pridanie platobnej metódy

Prepojenie WhatsAPP API s CDESK

Prepojenie s WhatsApp API sa na CDESK Portáli nastavuje v časti CDESK -> Global settings -> Omnichannel -> Chats. Najprv modul aktivujte pomocou prepínača. Všetky potrebné údaje na nastavenie prepojenia nájdete v nastaveniach vývojárskej aplikácie (developers.facebook.com).

V editácii aplikácie prejdite do záložky WhatsApp -> API Setup a skopírujte údaje podľa nasledujúcej tabuľky alebo obrázku.

Pole v CDESK	Pole v nastaveniach WA vývojárskej aplikácie
WhatsApp company account ID	WhatsApp Business Account ID Nájdete v záložke API Setup
API Token (Access Token)	Vložte permanentný token vytvorený pomocou System usera (popis vyššie v článku)
Webhook URL	URL adresa, ktorú zadáte do záložky Configuration → Callback URL
Webhook Token	Token, ktorý zadáte do záložky Configuration → Verify token
Company phone number ID	Phone number ID Nájdete v záložke API Setup
Company phone number	Vaše pridané telefónne číslo Nájdete v záložke API Setup
Second company phone number ID	Phone number ID druhého čísla Vypĺňate len ak máte nastavené aj druhé telefónne číslo
Second company phone number	Vaše druhé pridané telefónne číslo Vypĺňate len ak máte nastavené aj druhé telefónne číslo

**Obrázok:** Nastavenia v záložke API Setup

Potom prejdite do záložky Configuration, kde:

do poľa Callback URL zadáte adresu z poľa Webhook URL v CDESK,
do poľa Verify token vložíte token z poľa Webhook token v CDESK.

**Obrázok:** Nastavenia v záložke Configuration

Po zadaní Callback URL a Verify tokenu sa zobrazí zoznam udalostí Webhook fields. Zaškrtnite položku messages. Táto udalosť je potrebná na prijímanie správ z WhatsAppu do CDESK.

**Obrázok:** Aktivácia webhook udalosti messages

Po aktivácií modulu a vykonaní potrebných nastavení prejdite do záložky chat processing, kde zvoľte predvolenú spoločnosť pre zakladanie požiadaviek. Nastavenia uložte kliknutím na Save.

**Obrázok:** Výber predvolenej spoločnosti

Potom môžete prejsť do časti CDESK -> Omnichannel -> Chats a začať používať modul Čety pomocou WhatsApp. Používateľský manuál nájdete v článku WhatsApp manuál.

Prispôsobenie WhatsApp Business účtu

Pre prispôsobenie vášho účtu prejdite do časti WhatsApp accounts v Meta Business Suite (business.facebook.com).

Vyberte WhatsApp Business účet, ku ktorému patrí vaše telefónne číslo, kliknite na 3 bodky a vyberte WhatsApp Manager. Otvorí sa nová karta, s prostredím WhatsApp Manager. V tomto prostredí môžete upravovať všetky parametre týkajúce sa vášho WhatsApp Business účtu – napríklad šablóny správ, informácie o firme a ďalšie.

Jedným z dôležitých krokov je nastavenie vzhľadu účtu tak, ako ho uvidia zákazníci pri komunikácií. Prejdite do záložky Phone numbers, vyberte svoje telefónne číslo a prejdite do záložky Profile. Môžete upraviť napríklad profilovú fotku, meno, webstránku, e-mail, adresu sídla… Tieto informácie sa zobrazia zákazníkovi pri komunikácii cez WhatsApp a pomáhajú vytvoriť dôveryhodný a profesionálny profil.

**Obrázok:** Úprava údajov v záložke Profile

Pridanie WhatsApp odkazu na webstránku

Aby vás mohli zákazníci kontaktovať cez WhatsApp priamo z vašej webovej stránky, môžete využiť jednoduchý odkaz v tomto formáte:

https://api.whatsapp.com/send?phone=421917123456

421917123456 je telefónne číslo v medzinárodnom formáte bez znaku „+“ a bez medzier. Telefónne číslo musí byť rovnaké ako to, ktoré ste pridali do svojho WhatsApp Business účtu.

Po kliknutí na tento odkaz sa zákazníkovi otvorí WhatsApp (mobilná aplikácia alebo web), kde bude môcť začať konverzáciu s vaším číslom.