W tym artykule dowiesz się, jak utworzyć wymagane konto Twilio, jak połączyć numer biznesowy WhatsApp z kontem Twilio, którego będziesz używać do komunikacji z klientami, oraz jak połączyć numer WhatsApp z RemOnline.

Twilio to platforma API do komunikacji, która umożliwia programistom i firmom łatwą integrację narzędzi komunikacyjnych, takich jak telefonia, SMS-y, czaty i wideo, z ich aplikacjami i stronami internetowymi. Dzięki Twilio można wysyłać wiadomości tekstowe, wykonywać połączenia telefoniczne, konfigurować automatyczne odpowiedzi i nie tylko. Twilio pomoże nam zintegrować WhatsApp z RemOnline.

Zanim zaczniesz korzystać z tego przewodnika, będziesz potrzebować:

Jeśli korzystasz z własnego numeru telefonu, numer musi mieć możliwość odbierania wiadomości SMS lub połączeń telefonicznych. Jeśli numer może odbierać tylko połączenia telefoniczne, nie może korzystać z IVR (interaktywnej odpowiedzi głosowej).

Po zakupie płatnej wersji Twilio należy zarejestrować nadawcę WhatsApp, który umożliwi wysyłanie i odbieranie wiadomości WhatsApp z marki firmy za pomocą interfejsów API Twilio. Pewne ograniczenia są egzekwowane przez Meta (firmę będącą właścicielem WhatsApp) i prawdopodobnie będziesz musiał ukończyć weryfikację biznesową Meta przed przeniesieniem aplikacji do wersji produkcyjnej lub włączeniem dodatkowych nadawców WhatsApp.

Aby utworzyć nadawcę WhatsApp:

1. Zacznij od zalogowania się do konsoli Twilio.

2. Przejdź do Messaging > Senders > WhatsApp senders . Spowoduje to przejście do sekcji Nadawcy WhatsApp w konsoli, gdzie utworzysz swojego nadawcę WhatsApp.

3. Zapoznaj się z informacjami na tej stronie i kliknij Get Started.

4. Zapoznaj się z Warunkami korzystania z usługi WhatsApp i zaznacz pole, jeśli je akceptujesz. Następnie kliknij Confirm.

5. Następnie wybierz numer telefonu, który chcesz połączyć z Business API WhatsApp. Możesz użyć swojego numeru Twilio lub własnego numeru telefonu. Kliknij Continue.

Ten krok spowoduje otwarcie wyskakującego okienka ze zgłoszeniem do Facebook.com. Nie zamykaj wyskakującego okna ani nie przechodź do innej strony w konsoli Twilio. Okno konsoli Twilio będzie potrzebne w dalszych krokach tego przewodnika.

1. Zaloguj się do Facebooka, jeśli jeszcze tego nie zrobiłeś, lub kliknij Continue as [Twoje imię], jeśli jesteś już zalogowany. Po zalogowaniu zostanie wyświetlony przegląd procesu łączenia numeru z WhatsApp.

2. Po zalogowaniu zobaczysz kolejne kroki w procesie łączenia swojego numeru z WhatsApp. Kliknij Get started.

3. Następnie Facebook poprosi Cię o zezwolenie Twilio na zarządzanie Twoim kontem WhatsApp Business. Kliknij Continue , aby kontynuować.

4. Na następnym ekranie wybierz z listy Meta Business Account dla swojej firmy. Jeśli go nie posiadasz, możesz utworzyć nowe, wybierając opcję Create a Business Account.

5. Następnie będziesz mógł wybrać WhatsApp Business Account (WABA) lub utworzyć nowe.

Podczas rejestracji pierwszego nadawcy WhatsApp na koncie Twilio należy utworzyć nową WABA, która będzie używana tylko z tym konkretnym kontem Twilio. Podczas wdrażania dodatkowych nadawców na tym samym koncie Twilio należy wybrać tę samą WABA, którą utworzono podczas procesu wdrażania pierwszego nadawcy WhatsApp. Po połączeniu WABA z kontem Twilio identyfikator zostanie wyświetlony na stronie Nadawcy WhatsApp.

Ważne: Jeśli masz już zatwierdzony numer WhatsApp u innego dostawcy, wykonaj kroki opisane w tym artykule.

6. Na następnym ekranie należy wprowadzić następujące informacje:

WhatsApp Business Account Name - Jest ona używana wyłącznie do celów wewnętrznych i nie jest przeznaczona dla konsumentów. Jeśli wybrałeś WABA na poprzednim ekranie, nie będziesz mógł zmienić nazwy tutaj.

WhatsApp Business Profile Display Name - To właśnie zobaczą Twoi klienci. Musi on spełniać wymagania określone przez WhatsApp.

Category - Wybierz kategorię, która najlepiej opisuje Twoją firmę. Jest ona wyświetlana konsumentom podczas przeglądania profilu.

Business Description - Jest to również wyświetlane konsumentom podczas przeglądania profilu w aplikacji WhatsApp.

Website - Jest to również widoczne dla konsumentów podczas przeglądania profilu w aplikacji WhatsApp. Po zarejestrowaniu nadawcy WhatsApp będziesz mieć możliwość dodania kolejnej strony internetowej, jeśli chcesz.

Zdecydowanie zalecamy używanie nazwy firmy jako nazwy wyświetlanej podczas rejestracji nadawców WhatsApp, ponieważ WhatsApp odrzuci wszystko, co nie pasuje do nazwy firmy w połączonym Business Managerze.

Może się jednak zdarzyć, że nazwa marki, której chcesz użyć jako nazwy wyświetlanej dla swojego profilu biznesowego WhatsApp, różni się od nazwy Twojej firmy. W takim przypadku musi istnieć wyraźne, zewnętrznie opublikowane powiązanie między Twoją firmą a marką. To powiązanie między marką a firmą musi być wyświetlane na stronie internetowej i w samej nazwie wyświetlanej.

Na przykład, jeśli Twoja firma to Johnny Mobile, a Twoja marka to „PizzaApp”, zalecamy użycie nazwy wyświetlanej „PizzaApp by Johnny Mobile”. To powiązanie musi zostać opublikowane w witrynie, aby WhatsApp mógł je zweryfikować. Oznacza to, że gdzieś na stronie internetowej musi być widoczny związek między tymi dwiema nazwami. Jeśli chcesz zachować nazwę „PizzaApp”, będzie to wymagało odwołania się do WhatsApp i może wydłużyć proces rejestracji.

Aby uzyskać więcej informacji, możesz przejść do zasad wyświetlania nazwy WhatsApp.

1. Jeśli korzystasz z numeru Twilio z funkcją SMS, przejdź do okna konsoli Twilio, które pozostawiłeś otwarte w kroku 1 i kliknij, aby skopiować swój numer Twilio.

2. Następnie wklej numer w wyskakującym okienku Facebooka. Pozostaw wybraną metodę weryfikacji wiadomości tekstowej, a następnie kliknij Send Code.

Jeśli nie korzystasz z numeru Twilio, wprowadź numer, którego chcesz używać i wybierz metodę weryfikacji.

Nie kontynuuj, jeśli otrzymasz komunikat ostrzegawczy o przeniesieniu numeru. Zamiast tego otwórz zgłoszenie do pomocy technicznej i zaznacz, że chcesz przenieść swój numer z Meta lub poprzedniej firmy (pr. Business Solution Provider)), z którą współpracowałeś.

3. Kod weryfikacyjny zostanie wyświetlony w konsoli Twilio pod nagłówkiem Verification code. Kliknij Copy i wklej go w wyskakującym okienku Facebooka.

4. Następnie możesz kliknąć OK na następnym ekranie, aby zamknąć wyskakujące okienko.

Gratulacje! Twoje konto WhatsApp Business jest teraz połączone z kontem Twilio. Twilio rozpocznie proces rejestracji numeru w WhatsApp. Proces ten może potrwać do 2 minut.

Po pomyślnej rejestracji wyświetlony zostanie numer użytkownika. Możesz kliknąć Edit Sender, aby skorzystać z usługi przesyłania wiadomości, ustawić webhooki wiadomości przychodzących i zaktualizować resztę swojego profilu WhatsApp Business, w tym zdjęcie profilowe.

Jeśli nie ukończyłeś jeszcze weryfikacji biznesowej Meta, Twój dostęp do WhatsApp będzie początkowo ograniczony. Jeśli ukończyłeś już weryfikację biznesową, będziesz mieć pełny dostęp do WhatsApp.

Aby dodać kolejne numery, należy powtórzyć ten proces, wybierając to samo konto Meta Business Manager i konto WhatsApp Business. Meta Business Manager i konto biznesowe WhatsApp aktualnie połączone z kontem Twilio są wyświetlane w konsoli Twilio.

Uwaga: do czasu ukończenia weryfikacji biznesowej Meta niektóre numery mogą pozostać w stanie oczekującym i nie można ich używać do wysyłania wiadomości. Po zakończeniu weryfikacji biznesowej Meta może być konieczne usunięcie nadawców WhatsApp i ponowne przejście przez proces, aby całkowicie ich wdrożyć.

Aby utworzyć Messaging Service, przejdź do Messaging > Services i kliknij Create Messaging Service.

Krok 1. Wypełnij następujące pola:

Messaging Service friendly name — wymyśl nazwę dla swojej usługi Messaging Service (na przykład Czaty).

Select what you want to use Messaging for — wybierz funkcję, która najlepiej pasuje do Twoich czatów.

Kliknij przycisk Create Messaging Service.

Krok 2. Kliknij Add senders, wybierz WhatsApp Number i wybierz numer, dla którego chcesz włączyć usługę Messenger Service. W tym samym kroku możesz dodatkowo skonfigurować wybrany numer.

Sticky Sender — zapewniaender spójność komunikacji dla odbiorców wiadomości, wybierając ten sam numer telefonu nadawcy, który był wcześniej używany w rozmowie z tym klientem.

Area Code Geomatch — podczas wysyłania wiadomości do Stanów Zjednoczonych i Kanady należy używać lokalnych numerów telefonów z numerem kierunkowym, który pasuje lub pokrywa się z numerem telefonu odbiorcy.

Funkcje te są domyślnie włączone. Aby je wyłączyć, dotknij przełącznika.

Możesz także dodać więcej numerów, jeśli nie wybrałeś kilku numerów w poprzednim kroku, klikając przycisk Add Senders lub usunąć już dodany numer, klikając przycisk Remove obok niego.

Wybierz numery, z którymi chcesz pracować i kliknij Step 3. Set up integration.

Krok 3. W tym kroku skonfigurujesz webhooks, aby zautomatyzować procesy i zsynchronizować dane między kontami Twilio i RemOnline.

Wybierz opcję Use webhooks i wklej niezbędne linki w poniższych polach:

https://web.remonline.app/chat-service/v1/webhook/twilio/whatsapp

https://web.remonline.app/chat-service/v1/webhook/twilio/whatsapp/status

Obok pól Request URL i Fallback URL należy wybrać opcję HTTP Post.

W polu Validity period zalecamy pozostawienie domyślnej wartości 14400. Jest to liczba sekund, przez jaką wiadomości wysyłane z Twojej usługi e-mail pozostaną na platformie Twilio. Jeśli czas ten będzie dłuższy niż okres ważności, Twilio odrzuci wiadomość i wyśle żądanie do adresu URL wywołania zwrotnego, aby powiadomić Cię o błędzie.

Aby kontynuować, kliknij Step 4: Add compliance info.

Krok 4. Dodaj informacje o zgodności. Można to zrobić, rejestrując się w systemie A2P 10DLC (10-cyfrowy kod) w USA.

Jest to system w Stanach Zjednoczonych, który umożliwia firmom wysyłanie wiadomości między aplikacjami (A2P) przy użyciu 10-cyfrowych numerów telefonów (10DLC). Rejestracja dla wiadomości A2P poprawi jakość dostarczania i zmniejszy filtrowanie.

Aby zakończyć tworzenie usługi przesyłania wiadomości, kliknij przycisk Complete Messaging Service Setup.

Ważnym krokiem podczas konfigurowania konta Twilio jest skonfigurowanie podstawowego uwierzytelniania HTTP na koncie Twilio, aby odbieranie multimediów działało poprawnie.

Aby to zrobić, przejdź do Messaging > Settings > General > HTTP Basic Authentication for media access do multimediów, wybierz opcję Disabled i kliknij Save na dole strony, aby zapisać zmiany.

Gotowe! Ostatnim krokiem jest połączenie się z RemOnline, po czym można używać WhatsApp do komunikacji z klientami.

1. Na pulpicie nawigacyjnym Twilio przejdź do sekcji Account Info. Znajdziesz tam identyfikator Account SID i Auth Token potrzebny do połączenia z czatami RemOnline. Skopiuj te informacje.

2. Następnie przejdź do Messaging > Services i znajdź utworzoną usługę Messaging Service. Skopiuj jego Sid.

3. W aplikacji RemOnline przejdź do Ustawienia > Czaty i kliknij + Kanał. Wybierz zasób WhatsApp by Twilio.

4. Wypełnij wszystkie pola:

Nazwa kanału - wymyśl nazwę dla swojego kanału WhatsApp, którego będziesz używać do komunikacji z klientami.

Account SID - wklej kod Account SID skopiowany z konta Twilio.

Ważne: jeśli kanał z identycznym identyfikatorem Account SID jest już podłączony przez inną firmę, system nie pozwala na podłączenie nowego kanału z tym identyfikatorem Account SID w RemOnline. Aby to naprawić, należy usunąć istniejącą integrację w innej firmie, a następnie dodać kanał z tym identyfikatorem Account SID do RemOnline.

Auth Token - wklej tutaj kod Auth Token skopiowany z konta Twilio.

Numer telefonu - wprowadź numer telefonu, który został zarejestrowany w Twilio i będzie używany do komunikacji z klientami.

Messaging Service Sid – tutaj należy wkleić kod Messaging Service Sid skopiowany ze strony Messaging Service.

5. Skonfiguruj dostęp do kanału:

Wszyscy - wszyscy pracownicy firmy będą mieli dostęp do ustawień czatu, o ile system zezwoli na taki dostęp;

Wybrane - tylko wybrani pracownicy będą mieli dostęp do ustawień czatu, pod warunkiem, że są autoryzowani przez system;

Właściciel - tylko właściciel firmy będzie miał dostęp do ustawień.

Aby zmienić ustawienia dostępu pracowników do czatu i ustawień czatu, przejdź do Ustawienia > Pracownicy > Role i edytuj niezbędne ustawienia.

6. Kliknij przycisk Utwórz.

Gotowe! Teraz możesz rozmawiać z klientami za pomocą WhatsApp bezpośrednio w RemOnline. Więcej informacji na temat korzystania z szablonów WhatsApp w RemOnline można znaleźć tutaj.

Cennik WhatsApp jest obliczany na podstawie opłaty Meta za rozmowę i opłaty Twilio za wiadomość.

Pierwsze 1000 rozmów miesięcznie jest bezpłatnych, pod warunkiem że odbędą się one w ciągu pierwszych 24 godzin od otrzymania wiadomości od użytkownika. Wszelkie rozmowy zainicjowane po tym okresie są płatne.

Na przykład $0.0619 za każdą rozmowę i $0.005 za każdą wiadomość z polskiego numeru.

Tak więc całkowity koszt korzystania z WhatsApp obejmuje zarówno opłatę za rozmowę od Meta, jak i opłatę za wiadomość od Twilio. Aby uzyskać więcej informacji na temat cennika WhatsApp od Twilio, kliknij tutaj.