Návod pro integraci Whatsapp Business

Požadavky před zahájením integrace

Před nastavením WhatsApp kanálu si připravte následující:

📱 WhatsApp

• Produkt: WhatsApp Business Platform

👤 Účty

• Meta Developer účet [Odkaz]
  Potřebujete jeden Meta Developer účet, pomocí kterého můžete vytvořit více aplikací pro integraci WhatsApp kanálu.
  📝 Neexistuje žádný limit pro počet WhatsApp kanálů připojených k vaší ústředně (PBX).

• Business Manager účet (Business Portfolio) [Odkaz]
  Po vytvoření účtu Business Manager nezapomeňte ověřit svou firmu. [Odkaz]

☎️ Telefonní číslo

• Ujistěte se, že používané telefonní číslo je platné a dostupné pro zasílání zpráv přes WhatsApp. Je možné využít mobilní nebo i VoIP číslo. (ověření čísla může pár dní trvat)

Pokud se Vám nedaří ověřit Vaše číslo, prosím postupujte dále dle návodu [Ověření čísla].

Limitace

Před nasazením doporučujeme seznámit se s následujícími omezeními této integrace:

Integrace krok za krokem

1️⃣ Vytvoření Meta aplikace na portálu Meta for Developers

Pro integraci WhatsApp kanálu je potřeba vytvořit vlastní aplikaci v rámci vývojářského portálu Meta, připojit k ní telefonní číslo a získat potřebné identifikátory.

• Přihlaste se na: https://developers.facebook.com

• V horní liště klikněte na My Apps

• Zvolte Create App 

• Zvolte Business jako typ aplikace.

• Vyplňte požadované informace.

• V poli Business Portfolio vyberte váš firemní účet, který jste dříve ověřili.
  🔸 Tento krok je nezbytný pro aplikace, které vyžadují rozšířený přístup k oprávněním.

• Po vytvoření aplikace se zobrazí stránka Add products to your app.

• Najděte WhatsApp a klikněte na Set up

• V levém menu přejděte na WhatsApp > API Setup > Send and receive messages.

• V rozbalovacím seznamu From klikněte na Add phone number a přidejte své WhatsApp Business číslo.

• Po přidání čísla si poznamenejte:

  • Phone Number ID – budete potřebovat při nastavování v ústředně.

• V levém menu přejděte na App settings > Basic.

• Poznamenejte si App secret – tento údaj budete také potřebovat při konfiguraci kanálu ve vaší ústředně.

2️⃣ Generování trvalého přístupového tokenu v portálu Meta Business Suite

Pro propojení aplikace s WhatsApp kanálem v ústředně potřebujete trvalý přístupový token. Ten získáte přes Meta Business Suite vytvořením systémového uživatele s oprávněními.

• V portálu Meta for Developers klikněte v levém horním rohu na App Dashboard > Business Settings.

• Budete přesměrováni do portálu Meta Business Suite – konkrétně do nastavení Business Manageru.

• V levém menu přejděte na Uživatelé > Systémoví uživatelé

• Klikněte na +Přidat a vytvořte nového systémového uživatele.

• Zvolte Admin jako roli uživatele.

• Vyberte právě vytvořeného uživatele.

• Klikněte na Přidělit položky.

• Vyberte svou aplikaci a přiřaďte Plnou kontrolu.

• V menu přejděte na Účty > Účty WhatsApp.

• Najděte svůj WhatsApp Business účet.

• Přidejte systémového uživatele a nastavte mu Plnou kontrolu.

1. Vraťte se do Uživatelé > Systémoví uživatelé.

2. Vyberte systémového uživatele a klikněte na Generovat token.

3. Zvolte příslušnou aplikaci a zaškrtněte oprávnění:

   • whatsapp_business_messaging

   • whatsapp_business_management

✅ Uložení tokenu

Po vygenerování se token zobrazí v okně:

⚠️ Důležité: Token se zobrazí pouze jednou. Než zavřete okno, uložte si jej bezpečně – bez něj nebude možné dokončit integraci.

3️⃣ Vytvoření WhatsApp kanálu ve virtuální ústředně (PBX)

Po získání všech potřebných údajů z předchozích kroků můžete nyní vytvořit WhatsApp kanál ve vaší ústředně, aby bylo možné přijímat a odesílat zprávy přes WhatsApp Business Platformu.

• Přihlaste se do webového rozhraní PBX.

• Přejděte do nabídky Omnichannel > Komunikační kanály.

• Klikněte na Přidat a vyberte WhatsApp.

Záložka Authentication (Ověření)

Vyplňte autentizační údaje WhatsApp:

Záložka Messaging Settings (Nastavení zpráv)

Vyplňte nastavení zpráv:

Možnosti směrování:

• Klapka
  Vyberte konkrétní číslo uživatele, který bude příchozí zprávy přijímat.

• Komunikační fronty
  Vyberte frontu – zprávy budou doručeny operátorům ve frontě. Pouze operátor, který převezme relaci, bude moci pokračovat v komunikaci.

4️⃣ Nastavení Webhooku v Meta aplikaci

Pro zajištění příjmu zpráv z WhatsApp do vaší ústředny je potřeba nastavit webhook v Meta aplikaci. Tím umožníte PBX přijímat události o nových zprávách v reálném čase.

1. Přihlaste se do portálu Meta for Developers.

2. V horní liště klikněte na My Apps

3. Otevřete vámi vytvořenou aplikaci kliknutím na její název.

4. V levém menu přejděte do sekce WhatsApp > Configuration.

5. V části Webhook URL vložte údaje získané při konfiguraci kanálu v PBX:

   1. Webhook URL – zkopírujte z ústředny (Webhook URL).

   2. Verify Token – zkopírujte z ústředny (Ověřit token).

6. V části Webhook fields přihlaste aplikaci k odběru následující události:

   1. ✅ messages

      • Tím zajistíte, že PBX bude informována o každé příchozí zprávě na WhatsApp.

7. Klikněte na Verify and Save čímž Meta ověří spojení s PBX.

✅ Stav kanálu WhatsApp

Po úspěšném dokončení všech předchozích kroků se ve webovém rozhraní ústředny u vytvořeného WhatsApp kanálu zobrazí stav „🟢 Aktivní“ 

Tím je potvrzeno, že kanál byl úspěšně vytvořen a ústředna je propojena s WhatsApp Business Platformou.