Propojení WhatsApp Business s CDESK

Tento návod vás provede procesem propojení služby WhatsApp Business s CDESK. Díky tomuto propojení budete moci vytvářet požadavky a komunikovat se zákazníky přes WhatsApp přímo prostřednictvím CDESK Portálu.

Více o používání WhatsApp s CDESK se dočtete v článku WhatsApp manuál.

Pro propojení WhatsApp Business s CDESK budete potřebovat:

• Facebook Bussiness portfolio – Firemní účet v Meta Business Manageru, který bude vlastnit vývojářskou aplikaci pro WhatsApp a telefonní číslo.
• Meta vývojářský účet – Účet na Meta for Developers, potřebný k vytvoření vývojářské aplikace pro WhatsApp a získání přístupových údajů.
• Vývojářská aplikace pro WhatsApp – Aplikace vytvořená ve vývojářském účtu, která slouží jako konektor mezi CDESK a WhatsApp Business API.
• Telefonní číslo – Telefonní číslo, které není aktuálně používáno v žádné WhatsApp aplikací (osobní, ani business verzí)

Vytvoření Business portfolia (Facebook Business účtu)

Přejděte na stránku business.facebook.com a přihlaste se pomocí svého běžného Facebook účtu. Pokud ještě nemáte business portfolio, systém vás vyzve k jeho vytvoření. Vyplňte úvodní formulář a klikněte na Submit.

Po úspěšném přihlášení nebo vytvoření účtu se otevře prostředí Meta Business Suite, kde budete moci spravovat firemní aktiva, jako například stránky, účty, WhatsApp čísla a podobně.

Jako další potvrďte svoji e-mailovou adresu. Potom přejděte do Settings -> Business portfolio info a vyplňte základní údaje o vaší společnosti.

Vytvoření Meta vývojářského účtu

Přejděte na stránku developers.facebook.com a přihlaste se do svého vývojářského účtu (Meta developer account). Pokud vývojářský účet ještě nemáte, systém Vás provede registračním formulářem.

Vytvoření vývojářské aplikace

Po úspěšném přihlášení do Meta vývojářského účtu je nutné vytvořit vlastní vývojářskou aplikaci, která bude sloužit jako konektor mezi CDESK a službou WhatsApp Business API.

Přejděte na stránku Apps a klepněte na tlačítko Create App.

Zobrazí se formulář, kde zadáte název aplikace a kontaktní e-mail, který bude sloužit k oznámení z Meta.

Při volbě způsobu použití zvolte Other a klikněte na Next. Tímto krokem vás Meta přesměruje do staršího prostředí pro vytvoření aplikace, která je kompatibilní s WhatsApp API.

V dalším kroku zvolte jako typ aplikace možnost Business.

Znovu vyplňte název aplikace, kontaktní e-mail a přidělte aplikaci do vytvořeného business portfolia. Potom klepněte na Create app. Meta vás vyzve k zadání hesla k vašemu Facebook účtu.

Po vytvoření aplikace přidejte produkt WhatsApp do aplikace kliknutím na Set up. Pokud tuto obrazovku nevidíte nebo jste z ní již odešli, umíte se k ní vrátit kliknutím na Add Product.

Nastavení WhatsApp API ve vývojářské aplikací

Po vytvoření vývojářské aplikace je dalším krokem nastavení WhatsApp API pro vaši aplikaci. Tento proces zahrnuje připojení vlastního telefonního čísla, které bude sloužit jako oficiální WhatsApp Business účet.

Hned po vytvoření aplikace se vám zobrazí úvodní obrazovka. Pokud je nastaveno správné Business portfolio, klepněte na Continue.

V záložce Quickstart klikněte na Start using API, což vás přesměruje na záložku API Setup.

V této záložce přidáte své vlastní telefonní číslo. Meta vám automaticky přidělila testovací číslo, se kterým sice můžete propojení otestovat, ale pro produkční použití musíte přidat vlastní číslo. Pro jeho přidání klikněte na Add phone number.

Vyplňte formulář pro přidání telefonního čísla, čímž vytvoříte WhatsApp Business účet. Jméno a popis se bude zákazníkům zobrazovat při komunikaci přes WhatsApp.

Po ověření telefonního čísla se přesunete do vašeho Business Portfolia (business.facebook.com) a vytvoříte systémového uživatele, který bude zajišťovat permanentní Access token.

Vytvoření permanentního Access tokenu pomocí Systémového uživatele

Ve vašem Business Portfoliu (business.facebook.com) přejděte do části System users a klikněte na +Add. Otevře se formulář pro vytvoření nového System usera. Zvolte mu jméno a roli. Role Employee postačuje. Po vyplnění klikněte na Create system user.

Po vytvoření System usera mu bude nutné přidělit oprávnění k vytvořené vývojářské aplikací a WA business účtu.

U vytvořeného System usera klikněte na tři tečky a tlačítko Assign assets. Zobrazí se vám formulář při přidělování oprávnění. V záložce Apps vyberte vaši vytvořenou vývojářskou aplikaci a přidělte mu všechna oprávnění: Full control -> Manage app.

Potom se přesuňte do záložky WhatsApp accounts a vyberte WA Business účet s vaším telefonním číslo (ten, který jste vytvořili na konci předchozí sekce článku). Přidělte mu všechna oprávnění: Full control -> Manage WhatsApp business accounts. Potom klikněte na Assign assets, čímž se oprávnění přidělí.

Následně přejděte k vytvoření Access tokenu pomocí tohoto System usera. Klepněte na Generate token. Zobrazí se vám formulář pro vygenerování Access tokenu. V prvním kroku vyberte vaši vývojářskou aplikaci.

Exspiraci tokenu nastavte na Never (nikdy).

V dalším kroku přidejte následující oprávnění:

• whatsapp_business_management
• whatsapp_business_messaging

V posledním kroku se vám vygeneruje permanentní Access token. Před zavřením okna tento token zkopírujte a uložte. Po zavření okna již nebudete moci tento token zobrazit a bude jej třeba vygenerovat znovu.

Příprava pro produkční používání

Ověření firmy

Pro produkční používání služby WhatsApp Business API je nezbytné, aby byla vaše firma ověřena (verifikována). K ověření budete potřebovat oficiální dokument, který potvrzuje existenci vaší firmy. Například potvrzení o vedení účtu od banky nebo výpis z ORSR. Údaje v tomto dokumentu se musí shodovat s údaji zadanými v Business portfoliu. Více o podporovaných dokumentech se dočtete na stránkách Meta.

Otevřete vaše Business Portfolio (business.facebook.com) a přejděte do Settings -> Business portfolio info. V sekci Business verification status klikněte na View details.

Potom klikněte na tlačítko Start verification a postupně vyplňte verifikační formulář.

Po úspěšném ověření se v sekci Business verification zobrazí status Verified.

Nastavení platobných metod

Pro používání WhatsApp Business API je nezbytné, aby byl nastaven platební způsob. Bez platného způsobu platby nelze plně využívat produkční funkce WhatsApp API. Tento proces však není spojen s okamžitými náklady. Běžná komunikace je bezplatná. Při použití automatizovaných zpráv, šablon, posílání notifikací či komunikací po uplynutí 24h od poslední zprávy se mohou účtovat poplatky. Více o poplatcích za používání WhatsApp API se dočtete na stránkách Meta.

Otevřete vaše Business Portfolio (business.facebook.com) a v menu klikněte na Billing & payments.

Přejděte do záložky Accounts -> WhatsApp Bussiness accounts au WA Business účtu, pod který patří vaše vlastní přidané číslo, klikněte na Add payment method.

Otevře se formulář pro přidání platební metody. Po jeho vyplnění je platební metoda nastavena.

Propojení WhatsAPP API s CDESK

Propojení s WhatsApp API se na CDESK Portálu nastavuje v části CDESK -> Global settings -> Omnichannel -> Chats. Nejprve modul aktivujte pomocí přepínače. Všechny potřebné údaje pro nastavení odkazu naleznete v nastavení vývojářské aplikace (developers.facebook.com).

V editaci aplikace přejděte do záložky WhatsApp -> API Setup a zkopírujte údaje podle následující tabulky nebo obrázku.

Potom přejděte do záložky Configuration, kde:

• do pole Callback URL zadáte adresu z pole Webhook URL v CDESK,
• do pole Verify token vložíte token z pole Webhook token v CDESK.

Po zadání Callback URL a Verify tokenu se zobrazí seznam událostí Webhook fields. Zaškrtněte položku messages. Tato událost je potřebná k přijímání zpráv z WhatsAppu do CDESK.

Po aktivaci modulu a provedení potřebných nastavení přejděte do záložky chat processing, kde zvolte výchozí společnost pro zakládání požadavků. Nastavení uložte kliknutím na Save.

Potom můžete přejít do části CDESK -> Omnichannel -> Chats a začít používat modul Chaty pomocí WhatsApp. Uživatelský manuál naleznete v článku WhatsApp manuál.

Přizpůsobení WhatsApp Business účtu

Pro přizpůsobení vašeho účtu přejděte do části WhatsApp accounts v Meta Business Suite (business.facebook.com).

Vyberte WhatsApp Business účet, ke kterému patří vaše telefonní číslo, klikněte na 3 tečky a vyberte WhatsApp Manager. Otevře se nová karta, s prostředím WhatsApp Manager. V tomto prostředí můžete upravovat všechny parametry týkající se vašeho WhatsApp Business účtu – například šablony zpráv, informace o firmě a další.

Jedním z důležitých kroků je nastavení vzhledu účtu tak, jak jej uvidí zákazníci při komunikaci. Přejděte do záložky Phone numbers, vyberte své telefonní číslo a přejděte do záložky Profile. Můžete upravit například profilovou fotku, jméno, webstránku, e-mail, adresu sídla… Tyto informace se zobrazí zákazníkovi při komunikaci přes WhatsApp a pomáhají vytvořit důvěryhodný a profesionální profil.

Přidání WhatsApp odkazu na webstránku

Aby vás mohli zákazníci kontaktovat přes WhatsApp přímo z vaší webové stránky, můžete využít jednoduchý odkaz v tomto formátu:

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

421917123456 je telefonní číslo v mezinárodním formátu bez znaku „+“ a bez mezer. Telefonní číslo musí být stejné jako to, které jste přidali do svého WhatsApp Business účtu.

Po kliknutí na tento odkaz se zákazníkovi otevře WhatsApp (mobilní aplikace nebo web), kde bude moci zahájit konverzaci s vaším číslem.