# Viber Podłącz własnego **bota Viber**, aby rozmowy z Viber trafiały do aplikacji, gdzie może na nie odpowiadać Agent AI. Połączenie wymaga jedynie wklejenia jednej wartości (tokena autoryzacyjnego bota), a resztę konfiguracji wykonamy za Ciebie. --- ## Czym jest integracja z Viber? Integracja z Viber łączy posiadanego przez Ciebie **bota Viber** z platformą przy użyciu oficjalnego interfejsu Bot API firmy Viber – systemu służącego do automatycznego wysyłania i odbierania wiadomości, dzięki czemu nie musisz robić tego ręcznie. Rozmowy między Twoim botem a osobami, które go obserwują, stają się dostępne w aplikacji, gdzie mogą być obsługiwane przez Agenta AI oraz wspólną skrzynkę odbiorczą. Jest to **oficjalna** integracja, dzięki czemu jest stabilna i zgodna z zasadami Viber. > **Dostępność.** Viber jest najczęściej używany na Filipinach, w Wietnamie i innych częściach Azji Południowo-Wschodniej, a także w Europie Wschodniej i Grecji. --- ## Zanim zaczniesz **Musisz posiadać własnego bota Viber, a Viber udostępnia boty tylko w ramach płatnego planu biznesowego.** Od lutego 2024 r. Viber nie tworzy już darmowych botów. Konto konfigurujesz bezpośrednio w Viber, a wszelkie opłaty z tym związane dotyczą wyłącznie relacji między Tobą a Viber. Nie odsprzedajemy tej usługi, nie doliczamy marży, nie pobieramy prowizji i nie możemy utworzyć bota w Twoim imieniu. W momencie pisania tego tekstu Viber pobiera miesięczną opłatę za bota oraz opłatę za każdą wiadomość zainicjowaną przez bota (zobacz [Koszt](#cost) poniżej). Podczas rejestracji sprawdź aktualny regulamin Viber, ponieważ firma może zmieniać swoje ceny. Nie ma formularza rejestracyjnego samoobsługowego. Viber ręcznie weryfikuje każdą aplikację chatbota, a zgłoszenie można wysłać na dwa sposoby: - **Za pośrednictwem zweryfikowanego partnera Viber**, co jest ścieżką zalecaną przez Viber i zazwyczaj szybszą. - **Bezpośrednio w Viber**, wysyłając wiadomość e-mail na adres `partners@viber.com`. Jeśli już współpracujesz z Viber, Twój opiekun konta biznesowego może rozpocząć ten proces zamiast Ciebie. Po zatwierdzeniu wniosku podpisujesz umowę z Viber i akceptujesz ich warunki handlowe, a Twój bot zostaje utworzony. Następnie znajdziesz jego token w aplikacji Viber w sekcji **Więcej → Ustawienia → Boty → Edytuj informacje → Twój klucz aplikacji**. Viber nazywa go *kluczem aplikacji* (*app key*); w dokumentacji API ta sama wartość określana jest jako *token uwierzytelniający*, a administratorzy botów mogą go również zobaczyć w panelu administracyjnym Vibera. Niezależnie od etykiety, jest to jedyna wartość, o którą prosi ta aplikacja. Ten token to jedyna rzecz, której potrzebujesz od Viber. Konfiguracja tutaj zajmuje około minuty. --- ## Konfiguracja Viber ### Krok 1: Skopiuj token autoryzacyjny bota Najszybciej znajdziesz go w aplikacji Viber na swoim telefonie. 1. Otwórz Viber na telefonie, do którego konta przypisany jest bot. 2. Przejdź do **Więcej → Ustawienia → Boty**. 3. Wybierz swojego bota i stuknij **Edytuj informacje**. 4. Skopiuj wartość wyświetloną pod **Twój klucz aplikacji**. To jest właśnie token. > Zachowaj ten token w tajemnicy. Każdy, kto go posiada, może wysyłać wiadomości w imieniu Twojego bota. ### Krok 2: Połącz Viber w aplikacji 1. Na lewym pasku bocznym kliknij **Ustawienia** (Settings) w dolnej części. 2. W menu ustawień po lewej stronie, w sekcji **Kanały** (Channels), kliknij **Kanały** (Channels). 3. Znajdź kartę **Viber** i kliknij **Połącz** (Connect). 4. Wklej swój **token autoryzacyjny** (auth token). 5. Kliknij **Połącz** (Connect). 6. Aplikacja sprawdzi token w Viberze i wyświetli komunikat **"Połączono z: \"**. **Nie ma potrzeby konfigurowania webhooka.** W przeciwieństwie do większości innych kanałów, podczas łączenia rejestrujemy wszystko w Viberze za Ciebie, więc nie musisz niczego kopiować do innej konsoli. Ekran połączenia pokazuje adres, pod który docierają Twoje wiadomości, wyłącznie po to, abyś mógł go udostępnić pomocy technicznej, jeśli zajdzie taka potrzeba. ### Krok 3: Przetestuj bota 1. Z innego telefonu otwórz Viber i **zaobserwuj swojego bota** (wyszukaj go lub użyj linku do niego). 2. **Wyślij do niego wiadomość.** 3. Otwórz aplikację i przejdź do **Czatów** (Chats). Przychodząca wiadomość pojawi się na liście konwersacji. 4. Jeśli ten kanał obsługuje Agent AI, zobaczysz, że **odpowie automatycznie**. Po połączeniu Twój bot Viber będzie widoczny jako **Połączony** (Connected) na stronie Kanałów, a AI będzie odpowiadać na przychodzące wiadomości. --- ## Do kogo Twój bot może wysyłać wiadomości To najważniejsza rzecz, którą należy zrozumieć w przypadku Vibera, i różni się ona od każdego innego kanału: **Twój bot może wysyłać wiadomości tylko do osób, które go obserwują.** Ktoś musi znaleźć Twojego bota i zacząć go obserwować, zanim będziesz mógł mu cokolwiek wysłać. Nie ma możliwości wysłania wiadomości do użytkownika Vibera, który wcześniej nie zaczął obserwować Twojego bota. Jeśli ktoś przestanie obserwować lub zablokuje Twojego bota, nie będziesz mógł do niego ponownie napisać, dopóki ta osoba nie zacznie go obserwować i nie wyśle do Ciebie wiadomości. Gdy tak się stanie, aplikacja oznaczy konwersację, aby przestać podejmować próby wysyłki, a każda wysłana przez Ciebie odpowiedź zostanie oznaczona jako nieudana wraz z wyjaśnieniem, zamiast po cichu znikać. Z tego powodu Viber bardzo dobrze sprawdza się jako **kanał wsparcia i odpowiedzi** (ktoś pisze do Ciebie, AI odpowiada), a słabo jako kanał do nawiązywania pierwszego kontaktu. --- ## Koszt Viber jest **darmowym** kanałem w aplikacji: brak opłat za wiadomość i brak miesięcznej opłaty za połączenie z naszej strony. Twoje koszty wynikają z rozliczeń z **Viberem** na Twoim własnym koncie: - **Miesięczna opłata za bota** (około 100 EUR w momencie pisania tego tekstu). - **Odpowiedzi w ramach rozpoczętej przez kogoś konwersacji są darmowe i nielimitowane.** Obejmuje to prawie wszystko, co robi Agent AI. - **Wiadomości inicjowane przez bota**, poza konwersacją rozpoczętą przez daną osobę, są płatne za każdą wiadomość według stawki zależnej od kraju odbiorcy. Wniosek praktyczny: odpowiadanie ludziom nie kosztuje Cię nic poza miesięczną opłatą. To transmisje i proaktywne działania generują koszty. --- ## Wiadomości multimedialne Przychodzące zdjęcia, filmy, pliki, naklejki, lokalizacje i udostępnione kontakty są rozpoznawane, dzięki czemu AI wie, że wysłano multimedia (do konwersacji dodawana jest krótka notatka). Wychodzące odpowiedzi AI w tej wersji to **tekst i obrazy**. Długie odpowiedzi są automatycznie przycinane do limitu 7000 znaków Vibera. --- ## Zarządzanie sesją ### Sprawdzanie statusu połączenia Status połączenia z Viber jest widoczny na karcie **Viber** na stronie **Kanały**: | Status | Znaczenie | |---|---| | **Połączono** | Bot Viber jest powiązany z tym kontem | | **Połączono, wymagane działanie** | Inne narzędzie przejęło bota; wiadomości nie docierają do nas | | **Nie połączono** | Brak skonfigurowanego połączenia | Karta sprawdza stan bota przy każdym otwarciu strony Kanały. **Bot Viber może wysyłać wiadomości tylko w jedno miejsce jednocześnie**, więc jeśli połączysz tego samego bota z innym narzędziem, przejmie ono kontrolę, a Twoje wiadomości przestaną tu docierać bez żadnego ostrzeżenia ze strony Viber. Właśnie to oznacza status **„Połączono, wymagane działanie”**. Otwórz kartę i połącz ponownie, aby odzyskać dostęp. ### Rozłączanie Otwórz kartę **Viber**, kliknij **Zarządzaj**, a następnie kliknij **Rozłącz** i potwierdź **Usunąć Viber?**. Spowoduje to wstrzymanie odbierania wiadomości od bota i usunięcie go z Twojego konta. Sam bot pozostaje Twoją własnością. Nic nie zmienia się na Twoim koncie Viber. --- ## Ograniczenia - **Tylko obserwujący.** Twój bot może wysyłać wiadomości tylko do osób, które go obserwują. Zobacz [Do kogo Twój bot może wysyłać wiadomości](#who-your-bot-can-message). - **Wymagany własny płatny bot Viber.** Nie możemy go zapewnić. - **Jeden bot na połączenie.** Łącz każdego bota osobno; bot może być powiązany tylko z jednym kontem. - **Wysyłanie tekstu i obrazów.** AI odpowiada tekstem i obrazami; karuzele i karty typu rich cards nie są wysyłane w tej wersji. - **Brak wiadomości powitalnej.** Gdy ktoś otwiera bota po raz pierwszy, ale jeszcze go nie obserwuje, Viber pozwala na jedno natychmiastowe powitanie. Ta wersja go nie wysyła. Rozmowa rozpoczyna się, gdy użytkownik wyśle pierwszą wiadomość. --- ## Rozwiązywanie problemów ### Token odrzucony podczas łączenia - Upewnij się, że skopiowałeś wartość z **Edit Info → Your app key** w aplikacji Viber, a nie inny identyfikator. - Sprawdź, czy bot jest nadal aktywny na Twoim koncie Viber. - Proces łączenia sprawdza również, czy Viber może się z nami skontaktować. Jeśli token jest na pewno poprawny, a połączenie nadal nie działa, odczekaj minutę i spróbuj ponownie, a następnie skontaktuj się z pomocą techniczną. ### „Ten bot Viber jest już połączony z innym kontem” Ten sam bot jest powiązany z innym kontem w aplikacji. Najpierw rozłącz go tam lub użyj innego bota. ### Bot nie odpowiada - Potwierdź, że karta wyświetla status **Połączono**, a nie **Połączono, wymagane działanie**. - Potwierdź, że osoba, z którą testujesz, **obserwuje Twojego bota**. Viber dostarcza wiadomości tylko od obserwujących. - Sprawdź, czy do tego kanału przypisany jest agent AI. ### Wiadomości przestały docierać Jest to prawie zawsze problem przejęcia opisany w sekcji [Sprawdzanie statusu połączenia](#checking-connection-status): ten sam bot został połączony z innym narzędziem. Otwórz kartę **Viber** i połącz ponownie. ### Odpowiedź nie powiodła się z komunikatem „Not Subscribed” Osoba przestała obserwować lub zablokowała Twojego bota. Nie możesz wysyłać do niej wiadomości, dopóki ponownie go nie zaobserwuje i nie wyśle do Ciebie pierwszej wiadomości. --- ## Dobre praktyki - **Skup się na wsparciu, nie na masowej wysyłce.** Odpowiedzi w ramach rozpoczętej przez kogoś rozmowy są bezpłatne i nielimitowane; wiadomości, które sam inicjujesz, są płatne i docierają tylko do obserwujących. - **Ułatw obserwowanie bota.** Umieść link do niego na swojej stronie, w podpisie e-mail i w innych kanałach. Obserwowanie to jedyny sposób, w jaki ludzie mogą się z nim skontaktować. - **Dbaj o bezpieczeństwo tokena autoryzacyjnego.** Każdy, kto go posiada, może wysyłać wiadomości jako Twój bot. Jeśli wycieknie, wygeneruj go ponownie w aplikacji Viber, a następnie połącz ponownie tutaj. - **Nie łącz tego samego bota z dwoma narzędziami.** Drugie narzędzie po cichu przejmie kontrolę.