Połączenie WhatsApp Business z CDESK
Spis treści strony
Ten przewodnik przeprowadzi Cię przez proces połączenia usługi WhatsApp Business z CDESK. Dzięki temu połączeniu będziesz mógł tworzyć wnioski i komunikować się z klientami przez WhatsApp bezpośrednio za pośrednictwem Portalu CDESK.
Więcej o korzystaniu z WhatsApp w CDESK przeczytasz w artykule Podręcznik WhatsApp.
Do połączenia WhatsApp Business z CDESK będziesz potrzebować:
- Portfolio Facebook Business – Konto firmowe w Meta Business Managerze, które będzie właścicielem aplikacji deweloperskiej dla WhatsApp i numeru telefonu.
- Konto deweloperskie Meta – Konto na Meta for Developers, niezbędne do utworzenia aplikacji deweloperskiej dla WhatsApp i uzyskania danych dostępowych.
- Aplikacja deweloperska dla WhatsApp – Aplikacja utworzona na koncie deweloperskim, która służy jako konektor między CDESK a WhatsApp Business API.
- Numer telefonu – Numer telefonu, który nie jest aktualnie używany w żadnej aplikacji WhatsApp (ani osobistej, ani w wersji business)
Utworzenie portfolio Business (konta Facebook Business)
Przejdź na stronę business.facebook.com i zaloguj się przy użyciu swojego zwykłego konta Facebook. Jeśli nie masz jeszcze portfolio business, system poprosi Cię o jego utworzenie. Wypełnij wstępny formularz i kliknij Submit.
Po pomyślnym zalogowaniu lub utworzeniu konta otworzy się środowisko Meta Business Suite, w którym będziesz mógł zarządzać zasobami firmowymi, takimi jak strony, konta, numery WhatsApp i tym podobne.
Następnie potwierdź swój adres e-mail. Potem przejdź do Settings -> Business portfolio info i wypełnij podstawowe dane o swojej firmie.
Utworzenie konta deweloperskiego Meta
Przejdź na stronę developers.facebook.com i zaloguj się na swoje konto deweloperskie (Meta developer account). Jeśli nie masz jeszcze konta deweloperskiego, system przeprowadzi Cię przez formularz rejestracyjny.
Utworzenie aplikacji deweloperskiej
Po pomyślnym zalogowaniu na konto deweloperskie Meta należy utworzyć własną aplikację deweloperską, która będzie służyć jako konektor między CDESK a usługą WhatsApp Business API.
Przejdź na stronę Apps i kliknij przycisk Create App.
Pojawi się formularz, w którym podasz nazwę aplikacji i kontaktowy e-mail, który będzie służyć do powiadomień od Meta.
Przy wyborze sposobu użycia wybierz Other i kliknij Next. Tym krokiem Meta przekieruje Cię do starszego środowiska tworzenia aplikacji, które jest kompatybilne z WhatsApp API.
W kolejnym kroku jako typ aplikacji wybierz opcję Business.
Ponownie wypełnij nazwę aplikacji, kontaktowy e-mail i przypisz aplikację do utworzonego portfolio business. Następnie kliknij Create app. Meta poprosi Cię o podanie hasła do Twojego konta Facebook.
Po utworzeniu aplikacji dodaj produkt WhatsApp do aplikacji, klikając Set up. Jeśli nie widzisz tego ekranu lub już go opuściłeś, możesz do niego wrócić, klikając Add Product.
Konfiguracja WhatsApp API w aplikacji deweloperskiej
Po utworzeniu aplikacji deweloperskiej kolejnym krokiem jest konfiguracja WhatsApp API dla Twojej aplikacji. Proces ten obejmuje podłączenie własnego numeru telefonu, który będzie służyć jako oficjalne konto WhatsApp Business.
Zaraz po utworzeniu aplikacji wyświetli się ekran początkowy. Jeśli jest ustawione poprawne portfolio Business, kliknij Continue.
W zakładce Quickstart kliknij Start using API, co przekieruje Cię do zakładki API Setup.
W tej zakładce dodasz swój własny numer telefonu. Meta automatycznie przydzieliła Ci numer testowy, za pomocą którego wprawdzie możesz przetestować połączenie, jednak do użycia produkcyjnego musisz dodać własny numer. Aby go dodać, kliknij Add phone number.
Wypełnij formularz dodawania numeru telefonu, czym utworzysz konto WhatsApp Business. Nazwa i opis będą wyświetlać się klientom podczas komunikacji przez WhatsApp.
Po weryfikacji numeru telefonu przejdziesz do swojego Portfolio Business (business.facebook.com) i utworzysz użytkownika systemowego, który będzie zapewniać stały Access token.
Utworzenie stałego Access tokenu za pomocą użytkownika systemowego
W Twoim Portfolio Business (business.facebook.com) przejdź do sekcji System users i kliknij +Add. Otworzy się formularz tworzenia nowego System usera. Nadaj mu nazwę i rolę. Rola Employee wystarczy. Po wypełnieniu kliknij Create system user.
Po utworzeniu System usera trzeba mu będzie przydzielić uprawnienia do utworzonej aplikacji deweloperskiej i konta WA business.
Przy utworzonym System userze kliknij trzy kropki i przycisk Assign assets. Wyświetli się formularz przydzielania uprawnień. W zakładce Apps wybierz utworzoną przez siebie aplikację deweloperską i przydziel jej wszystkie uprawnienia: Full control -> Manage app.
Następnie przejdź do zakładki WhatsApp accounts i wybierz konto WA Business z Twoim numerem telefonu (ten, który utworzyłeś na końcu poprzedniej sekcji artykułu). Przydziel mu wszystkie uprawnienia: Full control -> Manage WhatsApp business accounts. Następnie kliknij Assign assets, czym uprawnienia zostaną przydzielone.
Następnie przejdź do utworzenia Access tokenu za pomocą tego System usera. Kliknij Generate token. Wyświetli się formularz generowania Access tokenu. W pierwszym kroku wybierz swoją aplikację deweloperską.
Wygaśnięcie tokenu ustaw na Never (nigdy).
W kolejnym kroku dodaj następujące uprawnienia:
- whatsapp_business_management
- whatsapp_business_messaging
W ostatnim kroku zostanie wygenerowany stały Access token. Przed zamknięciem okna skopiuj i zapisz ten token. Po zamknięciu okna nie będziesz już mógł wyświetlić tego tokenu i trzeba będzie wygenerować go ponownie.
Przygotowanie do użycia produkcyjnego
Weryfikacja firmy
Do użycia produkcyjnego usługi WhatsApp Business API niezbędne jest, aby Twoja firma była zweryfikowana (verifikowana). Do weryfikacji będziesz potrzebować oficjalnego dokumentu potwierdzającego istnienie Twojej firmy. Na przykład potwierdzenie prowadzenia rachunku od banku lub wyciąg z rejestru handlowego. Dane w tym dokumencie muszą być zgodne z danymi podanymi w Portfolio Business. Więcej o obsługiwanych dokumentach przeczytasz na stronach Meta.
Otwórz swoje Portfolio Business (business.facebook.com) i przejdź do Settings -> Business portfolio info. W sekcji Business verification status kliknij View details.
Następnie kliknij przycisk Start verification i stopniowo wypełnij formularz weryfikacyjny.
Po pomyślnej weryfikacji w sekcji Business verification wyświetli się status Verified.
Konfiguracja metod płatności
Do korzystania z WhatsApp Business API niezbędne jest, aby był ustawiony sposób płatności. Bez ważnego sposobu płatności nie jest możliwe pełne korzystanie z produkcyjnych funkcji WhatsApp API. Proces ten nie jest jednak związany z natychmiastowymi kosztami. Zwykła komunikacja jest bezpłatna. Przy użyciu zautomatyzowanych wiadomości, szablonów, wysyłaniu powiadomień czy komunikacji po upływie 24h od ostatniej wiadomości mogą być naliczane opłaty. Więcej o opłatach za korzystanie z WhatsApp API przeczytasz na stronach Meta.
Otwórz swoje Portfolio Business (business.facebook.com) i w menu kliknij Billing & payments.
Przejdź do zakładki Accounts -> WhatsApp Bussiness accounts i przy koncie WA Business, do którego należy Twój własny dodany numer, kliknij Add payment method.
Otworzy się formularz dodawania metody płatności. Po jego wypełnieniu metoda płatności jest ustawiona.
Połączenie WhatsAPP API z CDESK
Połączenie z WhatsApp API ustawia się na Portalu CDESK w sekcji CDESK -> Global settings -> Omnichannel -> Chats. Najpierw aktywuj moduł za pomocą przełącznika. Wszystkie potrzebne dane do ustawienia połączenia znajdziesz w ustawieniach aplikacji deweloperskiej (developers.facebook.com).
W edycji aplikacji przejdź do zakładki WhatsApp -> API Setup i skopiuj dane według poniższej tabeli lub rysunku.
| Pole w CDESK | Pole w ustawieniach aplikacji deweloperskiej WA |
|---|---|
| WhatsApp company account ID | WhatsApp Business Account ID
Znajdziesz w zakładce API Setup |
| API Token (Access Token) | Wstaw stały token utworzony za pomocą System usera
(opis wyżej w artykule) |
| Webhook URL | Adres URL, który podasz w zakładce
Configuration → Callback URL |
| Webhook Token | Token, który podasz w zakładce
Configuration → Verify token |
| Company phone number ID | Phone number ID
Znajdziesz w zakładce API Setup |
| Company phone number | Twój dodany numer telefonu
Znajdziesz w zakładce API Setup |
| Second company phone number ID | Phone number ID drugiego numeru
Wypełniasz tylko, jeśli masz ustawiony także drugi numer telefonu
|
| Second company phone number | Twój drugi dodany numer telefonu
Wypełniasz tylko, jeśli masz ustawiony także drugi numer telefonu
|
Następnie przejdź do zakładki Configuration, gdzie:
- w polu Callback URL podasz adres z pola Webhook URL w CDESK,
- w polu Verify token wstawisz token z pola Webhook token w CDESK.
Po podaniu Callback URL i Verify tokenu wyświetli się lista zdarzeń Webhook fields. Zaznacz pozycję messages. To zdarzenie jest potrzebne do odbierania wiadomości z WhatsAppa do CDESK.
Po aktywacji modułu i wykonaniu potrzebnych ustawień przejdź do zakładki chat processing, gdzie wybierz domyślną firmę do zakładania wniosków. Zapisz ustawienia, klikając Save.
Następnie możesz przejść do sekcji CDESK -> Omnichannel -> Chats i zacząć używać modułu Czaty za pomocą WhatsApp. Podręcznik użytkownika znajdziesz w artykule Podręcznik WhatsApp.
Dostosowanie konta WhatsApp Business
Aby dostosować swoje konto, przejdź do sekcji WhatsApp accounts w Meta Business Suite (business.facebook.com).
Wybierz konto WhatsApp Business, do którego należy Twój numer telefonu, kliknij 3 kropki i wybierz WhatsApp Manager. Otworzy się nowa karta ze środowiskiem WhatsApp Manager. W tym środowisku możesz edytować wszystkie parametry dotyczące Twojego konta WhatsApp Business – na przykład szablony wiadomości, informacje o firmie i inne.
Jednym z ważnych kroków jest ustawienie wyglądu konta tak, jak zobaczą je klienci podczas komunikacji. Przejdź do zakładki Phone numbers, wybierz swój numer telefonu i przejdź do zakładki Profile. Możesz edytować na przykład zdjęcie profilowe, nazwę, stronę internetową, e-mail, adres siedziby… Te informacje wyświetlą się klientowi podczas komunikacji przez WhatsApp i pomagają stworzyć wiarygodny i profesjonalny profil.
Dodanie odnośnika WhatsApp na stronę internetową
Aby klienci mogli kontaktować się z Tobą przez WhatsApp bezpośrednio z Twojej strony internetowej, możesz wykorzystać prosty odnośnik w tym formacie:
https://api.whatsapp.com/send?phone=421917123456
421917123456 to numer telefonu w formacie międzynarodowym bez znaku „+“ i bez spacji. Numer telefonu musi być taki sam jak ten, który dodałeś do swojego konta WhatsApp Business.
Po kliknięciu tego odnośnika klientowi otworzy się WhatsApp (aplikacja mobilna lub web), gdzie będzie mógł rozpocząć konwersację z Twoim numerem.