Wiadomości Vibera

SMSBAT API obsługuje wiele typów wiadomości Viber do różnych zastosowań, od kampanii promocyjnych po powiadomienia o transakcjach.

Przegląd typów wiadomości

Wpisz	Cel	Bogate multimedia	Interaktywny
viber_promo	Kampanie marketingowe	✅ Zdjęcia, filmy	✅Przyciski
viber_trans	Powiadomienia transakcyjne	✅Pliki PDF	❌
viber_karuzela	Prezentacje produktów	✅ Obrazy	✅ Wiele przycisków
viber_ankieta	Ankiety i opinie	❌	✅ Wiele opcji
viber_otp	Hasła jednorazowe	❌	❌

Promocja Vibera

Przekazy promocyjne z bogatą obsługą medialną kampanii marketingowych.

Obsługiwana treść

• Tylko obraz
• Tylko tekst
• Tekst + przycisk
• Obraz + tekst + przycisk
• Wideo + tekst
• Wideo + tekst + przycisk
• Tylko wideo

Parametry

Parametr	Wpisz	Wymagane	Opis
img	ciąg	Nie	Adres URL obrazu
wideo	ciąg	Nie	Adres URL pliku wideo
miniatura	ciąg	Nie	Obraz podglądu wideo
Tekst przycisku	ciąg	Nie	Etykieta przycisku wezwania do działania
przyciskAkcja	ciąg	Nie	Kliknij przycisk Docelowy adres URL
Rozmiar pliku	liczba całkowita	Nie	Rozmiar pliku wideo w bajtach
czas trwania	liczba całkowita	Nie	Długość filmu w sekundach

Przykłady

Tekst + Obraz + Przycisk

KOD_BLOKU_0

Wideo + tekst + przycisk

KOD_BLOKU_1

Tylko obraz

KOD_BLOKU_2

Tylko tekst

KOD_BLOKU_3

Tylko wideo

KOD_BLOKU_4

Wideo + tekst

KOD_BLOKU_5

Transakcje Vibera

Powiadomienia o transakcjach dotyczące informacji wrażliwych na czas, takich jak potwierdzenia zamówień i rachunki.

Obsługiwana treść

• Tylko tekst
• Plik PDF + tekst
• Tylko plik PDF

Parametry

Parametr	Wpisz	Wymagane	Opis
Urlpliku	ciąg	Nie	Adres URL dokumentu PDF
Nazwa pliku	ciąg	Nie	Nazwa wyświetlana załącznika
typ pliku	ciąg	Nie	Typ pliku (użyj „pdf”)

Przykłady

Tylko tekst

KOD_BLOKU_6

Tekst + PDF

KOD_BLOKU_7

Tylko PDF

KOD_BLOKU_8

Karuzela Vibera

Prezentacja produktów lub treści z wieloma elementami, którą można przeglądać.

Struktura

Zestaw elementów karuzelowych, z których każdy zawiera:

• Tytuł
• Obraz
• Przycisk główny (akcja główna)
• Przycisk dodatkowy (akcja alternatywna)

Parametry

Parametr	Wpisz	Wymagane	Opis
karuzela	tablica	Tak	Tablica elementów karuzeli
przedmioty	tablica	Tak	Poszczególne obiekty kart

Przykład

KOD_BLOKU_9

Ankieta Vibera

Interaktywne ankiety i zbieranie opinii z możliwością wielokrotnego wyboru.

Parametry

Parametr	Wpisz	Wymagane	Opis
„ankieta”	obiekt	Tak	Kontener ankietowy
opcje	tablica	Tak	Tablica 1-5 odpowiedzi do wyboru

Ograniczenia

• Obsługiwanych jest maksymalnie 5 opcji odpowiedzi
• Każda opcja powinna być zwięzła (zalecane: poniżej 30 znaków)

Przykład

KOD_BLOKU_10

Viber OTP

Jednorazowe dostarczenie hasła z predefiniowanymi szablonami.

Kluczowe funkcje

• 9 predefiniowanych szablonów
• Walidacja parametrów (typy TEXT, NUMBER)
• Obsługa wielu języków (19 języków)
• W nazwach zmiennych rozróżniana jest wielkość liter

Obsługiwane języki

Ukraiński, angielski, rosyjski, polski, rumuński, hiszpański, niemiecki, francuski, włoski, portugalski, holenderski, turecki, arabski, hebrajski, hindi, chiński, japoński, koreański, wietnamski

Parametry

Parametr	Wpisz	Wymagane	Opis
Identyfikator szablonu	ciąg znaków (UUID)	Tak	Identyfikator szablonu
język szablonu	ciąg	Tak	Kod języka ISO
Param szablonu	obiekt	Tak	Zmienne pasujące do szablonu

Przykład

KOD_BLOKU_11

Przykład szablonu: „Twój kod: 123456. Ważny przez 10 minut. Nigdy nie udostępniaj tego kodu”.

Obsługiwane szablony i walidacje

Viber oferuje predefiniowane i ściśle kontrolowane szablony. Przekazane parametry zmiennych muszą odpowiadać właściwym typom danych.

Typy danych: - NUMER: Tylko cyfry [0-9], +, - i .. Symbole takie jak / lub białe znaki nie są obsługiwane. - TEKST: Alfabet dowolnego języka, symbole (@#$%^&*().,<>;:!\"'+=-()[]{} \n itp.). - Regularne mapowanie: Sekwencja <liter> nie może sąsiadować z sekwencją <liczba>; wymagają oddzielenia białymi znakami. Podwójne białe znaki `` wewnątrz szablonów są generalnie zabronione. W przypadku linków unikaj spacji, jeśli przekraczają limity.

Poniżej znajduje się 9 standardowych szablonów ISO. Wymień identyfikatory w oparciu o wymagania rejestracyjne w określonych krajach. Skontaktuj się z pomocą techniczną, jeśli dodasz dodatkowe języki.

1. „TYLKO kod (dowolny PIN)”

Wymagania: Obsługuje kody PIN zawierające cyfry i litery angielskie oraz symbole - lub .. Szablon wymaga sformatowania, aby prawidłowo wyświetlać Twoją markę obok weryfikacyjnego kodu PIN.

2. „Akcja: Użyj tego kodu”

Parametry: {pin} (NUMER lub TEKST) Przykładowy format: „W celu weryfikacji użyj tego kodu {pin}.”

3. „Rejestracja marki/dostęp”

Parametry: {business_platform_name} (TEKST), {pin} (NUMER lub TEKST) Przykładowy format: „Twój kod dla {business_platform_name} to {pin}”.

4. „Termin sprawdzania poprawności kodu”

Parametry: {pin} (NUMBER/TEKST), {code_validity_time} (NUMBER) Przykładowy format: „Twój kod weryfikacyjny to {pin}. Jest ważny przez {code_validity_time} minut.”

5. „Dostęp do marki i weryfikacja kodu”

Parametry: {business_platform_name} (TEKST), {pin} (NUMBER/TEKST), {code_validity_time} (NUMBER) Przykładowy format: „Kod weryfikacyjny {business_platform_name} jest {pin} ważny przez {code_validity_time} minut”.

(Uwaga: istnieje do 9 predefiniowanych bloków strukturalnych dla standardowych reguł OTP Viber opartych na kombinacjach użycia „pin”, „nazwa_platformy_biznesowej” i „czas_ważności_kodu”).

Wymagania ogólne

Wszystkie typy wiadomości Viber wymagają:

• od: Alfanumeryczny identyfikator nadawcy
• do: Numer telefonu w formacie E.164
• type: Identyfikator typu wiadomości
• ttl: Czas ważności wiadomości w sekundach (zalecane)

Powrót do SMS-ów

Wszystkie typy wiadomości Viber obsługują zastępcze wiadomości SMS wykorzystujące blok tablicy „rezerwy”. Jeśli dostarczenie Vibera nie powiedzie się, wiadomość automatycznie powróci do alternatywnych skonfigurowanych kanałów.

Promocja Vibera -> Awaryjna wiadomość SMS

KOD_BLOKU_12

Ankieta Vibera -> Awaryjna wiadomość SMS

KOD_BLOKU_13

Viber Trans -> Awaryjna wiadomość SMS

KOD_BLOKU_14

Najlepsze praktyki

Obrazy

• Użyj formatu JPG lub PNG
• Zalecany rozmiar: 800x600 pikseli
• Utrzymuj rozmiar pliku poniżej 1MB
• Używaj adresów URL HTTPS

Filmy

• Użyj formatu MP4
• Utrzymuj rozmiar pliku poniżej 10MB
• Dołącz obraz miniatury
• Określ czas trwania i rozmiar pliku

Przyciski

• Zachowaj krótki tekst przycisku (2-3 słowa)
• Używaj jasnych wezwań do działania
• Zawsze używaj adresów URL HTTPS
• Testuj adresy URL przed wysłaniem

TTL (czas życia)

• Wiadomości promocyjne: 24-72 godziny
• Wiadomości transakcyjne: 24 godziny
• Wiadomości OTP: 5-10 minut
• Ankiety: 7-30 dni

Następne kroki

– Wiadomości SMS – Dowiedz się o zastępczych wiadomościach SMS - Wiadomości RCS - Bogate usługi komunikacyjne - Sprawdź stan - Śledź stan dostawy