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 portálu CDESK.
Více o používání WhatsApp s CDESK se dočtete v článku Příručka k WhatsApp.
Propojení WhatsApp Business s CDESK budete potřebovat:
- Facebook Business 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á v vývojářském účtu, která slouží jako propojovací článek mezi CDESK a WhatsApp Business API.
- Telefonní číslo – Telefonní číslo, které není aktuálně používáno v žádné aplikaci WhatsApp (ani v osobní, ani v business verzi)
Vytvoření firemního profilu (firemního účtu na Facebooku)
Přejděte na stránku business.facebook.com a přihlaste se pomocí svého běžného účtu na Facebooku. Pokud ještě nemáte firemní profil, 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 jsou například stránky, účty, čísla WhatsApp a podobně.
Dále potvrďte svou e-mailovou adresu. Poté přejděte na Settings – > Business portfolio info a vyplňte základní údaje o vaší společnosti.
Vytvoření vývojářského účtu Meta
Přejděte na stránku developers.facebook.com a přihlaste se ke svému vývojářskému účtu (Meta developer account). Pokud ještě vývojářský účet 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 vývojářského účtu Meta je nutné vytvořit vlastní vývojářskou aplikaci, která bude sloužit jako propojení mezi CDESK a službou WhatsApp Business API.
Přejděte na stránku Apps a klikněte na tlačítko Create App.
Zobrazí se formulář, do kterého zadáte název aplikace a kontaktní e-mailovou adresu, na kterou budou zasílána oznámení od společnosti Meta.
Při výběru způsobu použití vyberte 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 vyberte jako typ aplikace možnost „Business“.
Znovu zadejte název aplikace, kontaktní e-mail a přiřaďte aplikaci k vytvořenému firemnímu portfoliu. Poté klikněte na Create app. Meta vás vyzve k zadání hesla k vašemu účtu na Facebooku.
Po vytvoření aplikace přidejte produkt WhatsApp do aplikace kliknutím na Set up. Pokud tuto obrazovku nevidíte nebo jste ji již opustili, můžete se na ni vrátit kliknutím na Add Product.
Nastavení rozhraní WhatsApp API v vývojářské aplikaci
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í účet WhatsApp Business.
Hned po vytvoření aplikace se vám zobrazí úvodní obrazovka. Pokud je správně nastaveno Business portfolio, klikněte na Continue.
Na stránce Quickstart klikněte na odkaz Start using API,, čímž budete přesměrováni na stránku API Setup.
V této záložce přidáte své vlastní telefonní číslo. Meta vám automaticky přidělila testovací číslo, pomocí kterého sice můžete propojení otestovat, ale pro produkční použití musíte přidat své vlastní číslo. Chcete-li jej přidat, klikněte na Add phone number.
Vyplňte formulář pro přidání telefonního čísla, čímž si vytvoříte účet WhatsApp Business. Jméno a popis se zákazníkům budou zobrazovat při komunikaci přes WhatsApp.
Po ověření telefonního čísla budete přesměrováni do svého Business Portfolia (business.facebook.com), kde si vytvoříte systémového uživatele, který zajistí trvalý přístupový token.
Vytvoření trvalého přístupového tokenu pomocí systémového uživatele
Ve svém Business Portfoliu (business.facebook.com) přejděte do sekce System users a klikněte na +Add. Otevře se formulář pro vytvoření nového systémového uživatele. Zvolte mu jméno a roli. Role Employee postačí. Po vyplnění klikněte na Create system user.
Po vytvoření System usera mu bude třeba přidělit oprávnění k vytvořené vývojářské aplikaci 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ář pro přidělení oprávnění. V záložce Apps vyberte vaši vytvořenou vývojářskou aplikaci a přidělte jí všechna oprávnění: Full control -> Manage app.
Poté přejděte do záložky WhatsApp accounts a vyberte WA Business účet s vaším telefonním číslem (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. Poté klikněte na Assign assets, čímž se oprávnění přidělí.
Poté přejděte k vytvoření přístupového tokenu pomocí tohoto systémového uživatele. Klikněte na Generate token. Zobrazí se vám formulář pro vygenerování přístupového tokenu. V prvním kroku vyberte svou vývojářskou aplikaci.
Expiraci 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 trvalý přístupový token. Před zavřením okna tento token zkopírujte a uložte. Po zavření okna již tento token nebudete moci zobrazit a bude nutné jej vygenerovat znovu.
Příprava pro nasazení do produkčního prostředí
Ověření firmy
Pro produkční využí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 obchodního rejstříku. Ú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 své Business Portfolio (business.facebook.com) a přejděte do Settings -> Business portfolio info. V sekci Business verification status klikněte na View details.
Poté klikněte na tlačítko Start verification a postupně vyplňte ověřovací formulář.
Po úspěšném ověření se v sekci Business verification zobrazí stav Verified.
Nastavení platebních metod
Pro používání WhatsApp Business API je nezbytné nastavit způsob platby. Bez platného způsobu platby není možné 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, zasílání oznámení nebo komunikace po uplynutí 24 hodin od poslední zprávy mohou být účtovány poplatky. Více o poplatcích za používání WhatsApp API se dočtete na stránkách Meta.
Otevřete své Business Portfolio (business.facebook.com) a v menu klikněte na Billing & payments.
Přejděte do záložky Accounts -> WhatsApp Bussiness accounts a u 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í API aplikace WhatsApp s CDESK
Propojení s WhatsApp API se na portálu CDESK nastavuje v sekci CDESK -> Global settings -> Omnichannel -> Chats. Nejprve modul aktivujte pomocí přepínače. Veškeré údaje potřebné k nastavení propojení najdete v nastavení vývojářské aplikace (developers.facebook.com).
V editaci aplikace přejděte na záložku WhatsApp -> API Setup a zkopírujte údaje podle následující tabulky nebo obrázku.
Pole v CDESK | Pole v nastaveních vývojářské aplikace WA v Meta Developers |
WhatsApp company account ID | WhatsApp Business Account ID (Záložka API Setup) |
API Token (Access Token) | Vložte permanentní token vytvořený pomocí System usera (popis výše v článku) |
Webhook URL | URL adresa, kterou zadáte do záložky Configuration -> Callback URL |
Webhook Token | Token, který zadáte do záložky Configuration -> Verify token |
Company phone number ID | Phone number ID (Záložka API Setup) |
Company phone number | Vaše přidané telefonní číslo (Záložka API Setup) |
Second company phone number ID | Vyplňujte pouze pokud máte nastaveno i druhé telefonní číslo |
Second company phone number | Vyplňujte pouze pokud máte nastaveno i druhé telefonní číslo |
Poté 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 nezbytná pro příjem zpráv z WhatsApp do CDESK.
Po aktivaci modulu a vykonání potřebných nastavení přejděte na záložku chat processing, kde vyberte výchozí společnost pro zakládání požadavků. Nastavení uložte kliknutím na Save.
Poté můžete přejít do sekce CDESK -> Omnichannel -> Chats a začít používat modul Chatů prostřednictvím WhatsApp. Uživatelskou příručku najdete v článku Příručka k WhatsApp.
Nastavení účtu WhatsApp Business
Chcete-li přizpůsobit svůj účet, přejděte do části WhatsApp accounts v Meta Business Suite (business.facebook.com).
Vyberte účet WhatsApp Business, ke kterému patří vaše telefonní číslo, klikněte na tři 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 účtu WhatsApp Business – například šablony zpráv, informace o firmě a další.
Jedním z důležitých kroků je nastavení vzhledu účtu tak, jak ho uvidí zákazníci při komunikaci. Přejděte na záložku Phone numbers, vyberte své telefonní číslo a přejděte na záložku Profile. Můžete upravit například profilovou fotku, jméno, webovou stránku, e-mail, adresu sídla… Tyto informace se zákazníkům zobrazí při komunikaci přes WhatsApp a pomáhají vytvořit důvěryhodný a profesionální profil.
Přidání odkazu na WhatsApp na webovou stránku
Aby vás zákazníci mohli kontaktovat přes WhatsApp přímo z vašich webových stránek, můžete použí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 účtu WhatsApp Business.
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.