Kanał InBox – Konfiguracja, wysyłka i obsługa powiadomień w skrzynce odbiorczej

Kanał InBox pozwala na przesyłanie wiadomości bezpośrednio do dedykowanej „skrzynki odbiorczej” zaimplementowanej w Twojej aplikacji webowej lub mobilnej. W przeciwieństwie do tradycyjnych kanałów (np. SMS czy E-mail), InBox działa w modelu pull-based – system iPresso generuje wiadomość i udostępnia ją w API, z którego Twoja aplikacja pobiera treści dla danego kontaktu.

Gdzie znaleźć kanał InBox w iPresso?

Kanał InBox znajduje się w menu głównym systemu. Aby do niego przejść:

1. Z menu bocznego wybierz zakładkę Kanały.
2. Kliknij pozycję InBox.

Podstawowe pojęcia

Przed rozpoczęciem pracy z kanałem InBox zapoznaj się z kluczowymi pojęciami:

• Instancja InBox – pojedyncza skrzynka odbiorcza, do której kierowane są wiadomości. Aplikacja kliencka pyta system o zawartość konkretnej instancji dla wskazanego kontaktu. Jedna aplikacja może obsługiwać kilka instancji (np. osobne skrzynki na powiadomienia transakcyjne i promocyjne).
• Aplikacja InBox – zdefiniowana w iPresso wersja Twojej aplikacji webowej lub mobilnej, połączona z instancją InBox za pomocą klucza API.
• Wysyłka InBox – pojedyncza kreacja wiadomości kierowana do odbiorców z segmentu, zarejestrowanych w instancji lub wyzwalana automatycznie (API, scenariusz, porzucony proces).
• Rejestracja w instancji InBox – przypisanie kontaktu do danej instancji InBox. Kontakt otrzyma wiadomość tylko wtedy, gdy jest zarejestrowany w wybranej instancji.

Rejestracja kontaktu w instancji InBox

Aby kontakt mógł odbierać wiadomości w danej skrzynce, musi zostać do niej zarejestrowany. Możesz to zrobić na trzy sposoby:

1. Manager kontaktów

• Edycja profilu: Podczas edycji danych kontaktu włącz lub wyłącz dostęp do wybranej instancji za pomocą suwaka.
  
•  
•  
• Podgląd kontaktu: W szczegółach profilu znajduje się indykator wskazujący, do których instancji InBox kontakt jest obecnie przypisany.
  
   
• 

2. Dedykowana akcja na segmencie

Po utworzeniu segmentu kontaktów możesz wykonać masową akcję zarejestrowania lub wyrejestrowania wybranych osób z konkretnej instancji InBox.

 

3. REST API v2

Podczas dodawania lub edycji kontaktów przez API przekaż pole contactInboxes z kluczem API Inboxa oraz odpowiednią wartością:

• 1 – zarejestrowanie kontaktu,
• 2 – wyrejestrowanie kontaktu.

Wskazówka: Każda zmiana statusu rejestracji generuje odpowiednią aktywność (Zarejestrowanie w InBox / Wyrejestrowanie z InBox) w historii kontaktu.

Tworzenie kreacji InBox (Krok po kroku)

Proces tworzenia wiadomości InBox składa się z dwóch głównych kroków: przygotowania treści oraz konfiguracji ustawień wysyłki.

Krok 1: Zawartość kreacji (Treść)

Wypełnij formularz kreacji, pamiętając o limitach znaków oraz o tym, że wszystkie pola tekstowe wspierają standardową personalizację treści (np. imię odbiorcy).

Wymagane pola:

• Tytuł (limit: 255 znaków) – główny nagłówek notyfikacji.
• Lead (limit: 500 znaków) – krótki tekst informacyjny, wyświetlany zazwyczaj na liście wiadomości w aplikacji.
• Treść (limit: 1000 znaków) – pełna treść wiadomości widoczna po jej otwarciu.
  
   

Opcjonalne pola:

• Tekst CTA (limit: 255 znaków) – etykieta przycisku akcji (Call to Action).
• Link CTA (limit: 1000 znaków) – adres URL w protokole https://, automatycznie monitorowany przez iPresso (rekomendowany dla aplikacji webowych).
• Deep link CTA (limit: 1000 znaków) – hiperłącze w protokole aplikacji mobilnej (np. app://promotion). Generowany jest śledzony adres pośredni do oznaczania kliknięć.
• URL ikony (limit: 1000 znaków) – link do małego obrazka (np. do wyświetlenia na liście wiadomości).
• URL obrazu (limit: 1000 znaków) – link do dużej grafiki głównej (wyświetlanej po otwarciu wiadomości).
  
   

Wysyłka testowa i podgląd

W prawym panelu formularza możesz przeprowadzić test kreacji:

1. Wybierz odpowiednią Instancję InBox.
2. Wybierz Kontakt (kontakt musi być zarejestrowany w danej instancji oraz posiadać status kontaktu testowego).
3. Kliknij Wyślij test.
   
    

Po wysłaniu testu zobaczysz podgląd wizualny notyfikacji oraz przykładową strukturę obiektu JSON, który otrzyma Twoja aplikacja.

Krok 2: Ustawienia kampanii

Po przejściu do zakładki ustawień skonfiguruj parametry kampanii.

1. Podstawowe informacje

• Nazwa* – nazwa identyfikacyjna kampanii w iPresso.
• Opis – dodatkowy opis widoczny na liście kampanii.
• Tagi – ułatwiające filtrowanie i organizację.

2. Konfiguracja InBox

• InBox* – wybór instancji InBox, dla której zostaną wygenerowane wiadomości.
• Aplikacje InBox (opcjonalnie) – domyślnie wiadomość trafi do wszystkich aplikacji podpiętych do instancji. Możesz ograniczyć jej dostępność tylko do wybranych aplikacji.

3. Wysyłka

• Typ wysyłki*:
  • AdHoc – natychmiastowa wysyłka do segmentu lub wszystkich zarejestrowanych kontaktów.
  • Zaplanowana – wysyłka zaplanowana na konkretny dzień i godzinę.
  • Dla scenariuszy – wysyłka wykorzystywana jako element scenariusza MA.
  • Wyzwalana przez API – wyzwalana kluczem API dla konkretnych kontaktów lub w reaktywacji porzuconych procesów.
• Odbiorcy / Segment* – wskazanie grupy docelowej.
  
   

4. Zaawansowane (Data wygaśnięcia i Grupa kontrolna)

Każda wiadomość InBox musi posiadać datę wygaśnięcia (brak możliwości ustawienia wiadomości bezterminowej).

Wybierz Typ wygaśnięcia:

• Stała data – wszystkie wiadomości przestaną być dostępne w aplikacji po upływie określonej daty i godziny.
• Interwał – wiadomość wygasa po określonym czasie od momentu jej wygenerowania (określanym w Godzinach lub Dniach). Rozwiązanie to jest zalecane przy wysyłkach scenariuszowych oraz przez API.

Dodatkowo w sekcji zaawansowanej możesz wskazać Segment grupy kontrolnej (osoby z tej grupy zostaną pominięte podczas generowania wiadomości) oraz ustawić Dostępy elementów.

Wygląd wiadomości po stronie aplikacji

Sposób prezentacji notyfikacji zależy od integracji i stylów graficznych wdrożonych w Twojej aplikacji webowej lub mobilnej. Przykład standardowej integracji:

Raporty i analityka

Raportowanie dla kanału InBox mierzy zdarzenia specyficzne dla modelu pull-based:

*Zliczone raz - licznik w raporcie wzrasta maksymalnie o 1 dla danego kontaktu, bez względu na to, ile razy wykona on tę samą akcję. Powtórzone otwarcia lub kliknięcia tworzą nowe wpisy w historii aktywności kontaktu, ale nie zwiększają ogólnego wyniku w statystykach kampanii.