Zmienne i profile marki

Zmienna to nazwana wartość, na przykład nazwa marki albo adres e-mail do kontaktu, którą wpisujesz raz i używasz w tekstach bota. Nazwę zmiennej zapisujesz w podwójnych nawiasach klamrowych, na przykład {{ CONTACT_EMAIL }}, a Fibly wstawia w to miejsce wartość, zanim tekst zobaczy klient.

Profil marki to zestaw wartości zmiennych. Jeśli w jednym obszarze roboczym Fibly prowadzisz kilka marek, tworzysz osobny profil marki dla każdej z nich. Każde konto kanału (konto na Instagramie, skrzynka e-mail, numer telefonu, domena widżetu itd.) używa jednego profilu marki, więc ten sam tekst brzmi inaczej w zależności od tego, skąd przyszła rozmowa.

Zmiennymi i profilami zarządzasz w sekcji Ustawienia → Zmienne w panelu Fibly.

Przykład: dwie marki hostingowe, jedna baza wiedzy

Firma hostingowa prowadzi dwie marki: Acme i Globex. Klienci obu marek zadają te same pytania, a odpowiedzi różnią się tylko kilkoma szczegółami: nazwą marki, adresem dokumentacji i adresem e-mail do kontaktu. Zamiast trzymać dwie kopie każdego artykułu w bazie wiedzy, firma definiuje trzy zmienne i dwa profile marki:

Artykuł w bazie wiedzy może wtedy brzmieć tak:

Aby zmienić wersję PHP, skorzystaj z instrukcji: {{ HELP_DOCS_URL }}/php.
Jeśli instrukcja nie pomoże, napisz na {{ CONTACT_EMAIL }}, a zespół
{{ BRAND }} zmieni wersję za Ciebie.

Domena widżetu Globex i skrzynka e-mail Globex używają profilu Globex, więc ich klienci dostają adres i e-mail Globex. Wszystkie pozostałe konta używają profilu domyślnego, czyli Acme.

Profil domyślny i COMPANY_NAME

Każdy obszar roboczy ma dokładnie jeden profil domyślny. Fibly tworzy go automatycznie, razem z jedną zmienną, COMPANY_NAME, której wartością jest nazwa Twojego obszaru roboczego. Profil domyślny:

• jest używany przez każde konto kanału, które nie ma wybranego profilu marki,
• musi mieć wartość każdej zmiennej (nie dodasz zmiennej bez wartości domyślnej i nie wyczyścisz tej wartości),
• można zmienić jego nazwę, ale nie można go usunąć.

COMPANY_NAME zastępuje dawny znacznik {company} w powitaniach telefonicznych. Powitania, w których był {company}, zostały automatycznie przepisane na {{ COMPANY_NAME }} i brzmią tak samo jak wcześniej. Dopóki nie zmienisz wartości domyślnej, COMPANY_NAME podąża za nazwą obszaru roboczego: gdy zmienisz nazwę obszaru, zmieni się też wartość. Jeśli wpiszesz własną wartość, Fibly ją zachowa.

COMPANY_NAME to zmienna wbudowana. W sekcji Ustawienia → Zmienne ma oznaczenie Wbudowana, a po jego kliknięciu zobaczysz wyjaśnienie. Nie można jej usunąć ani zmienić jej nazwy, a jej opis jest stały. Jej wartość możesz za to zmienić w każdym profilu marki, na przykład tak, żeby numer telefonu Globex witał dzwoniących nazwą „Globex”. Gdyby ta zmienna kiedyś zniknęła, Fibly utworzy ją ponownie z nazwą obszaru roboczego jako wartością.

Jak zapisać zmienną

Nazwę zmiennej wpisz w podwójnych nawiasach klamrowych: {{ BRAND }}. Spacje w nawiasach są opcjonalne, więc {{BRAND}} też zadziała.

Nazwy zmiennych składają się z wielkich liter, cyfr i podkreśleń i zaczynają się od litery, na przykład BRAND, HELP_DOCS_URL albo PLAN_2_PRICE. Nazwy nie można zmienić po utworzeniu zmiennej. Aby zmienić nazwę, utwórz nową zmienną i usuń starą.

Zmienną jest tylko dokładnie taki zapis. Wszystko inne w nawiasach klamrowych zostaje w tekście bez zmian, na przykład {{ brand }} małymi literami, {{ user.name }}, {% if %} czy pojedyncze nawiasy. Zmienne nie zawierają logiki: nie ma warunków, pętli ani filtrów.

Jeśli zapisujesz tekst ze zmienną, która nie istnieje, Fibly go odrzuci i wskaże nieznane zmienne. Najpierw dodaj je w sekcji Ustawienia → Zmienne albo popraw pisownię.

Przykłady kodu

Dokumentacja często zawiera kod z języków szablonów, które używają tych samych nawiasów, takich jak Twig, Jinja, Handlebars czy Vue. Wewnątrz kodu w Markdownie (bloku kodu między potrójnymi grawisami albo kodu w linii między pojedynczymi grawisami):

• nazwa, która jest jedną z Twoich zmiennych, zostanie uzupełniona, więc curl {{ HELP_DOCS_URL }}/api działa,
• każda inna nazwa zostaje dokładnie tak, jak ją wpisano, a tekst zapisuje się bez błędu. Przykład w Twigu z {{ DB_HOST }} pokaże się bez zmian.

Gdzie działają zmienne

Zmiennych możesz używać w tych tekstach:

• Wpisy w bazie wiedzy: tytuł, treść i Publiczny URL każdego artykułu. Publiczny URL może korzystać ze zmiennej, na przykład {{ HELP_DOCS_URL }}/billing, a Fibly sprawdza, czy powstaje poprawny adres dla każdego profilu marki.
• Ustawienia bota: pole Strona WWW w sekcji Marka oraz Opis Marki/Produktu i Wiadomość powitalna dla każdego języka.
• Powitania telefoniczne: Wiadomość powitalna w Ustawieniach głosu kanału telefonicznego. Powitanie musi się zmieścić w 300 znakach z wartościami każdego profilu marki, więc Fibly odrzuci wartość, która by je wydłużyła ponad limit. Nawiasów klamrowych w powitaniu można używać tylko w zmiennych: pojedynczy nawias, na przykład {name}, zostanie odrzucony.
• Teksty widżetu: Tytuł okna czatu, Tekst przycisku i Powiadomienie powitalne w Ustawieniach Widżetu.

W pozostałych tekstach zmienne nie są jeszcze obsługiwane, na przykład w szablonach e-maili, nazwie agenta bota, nazwach nadawcy skrzynki e-mail, wiadomościach wyzwalaczy sprzedażowych, tekstach w workflow sprzedażowym i menu wyboru w kanale telefonicznym. Jeśli wpiszesz zmienną w jednym z tych pól, Fibly pokaże komunikat „W tym polu nie można jeszcze używać zmiennych.” i nie zapisze zmiany.

Strony dodane przez skanowanie Twojej witryny, import plików i synchronizację z URL nie są sprawdzane podczas importu. Znana zmienna zostanie w nich uzupełniona. Nieznana zmienna w zwykłym tekście zostanie pominięta w odpowiedzi, a w kodzie zostanie tak, jak ją wpisano.

Wybór profilu marki dla konta

Profil marki wybierasz osobno dla każdego konta, a nie raz dla całego kanału. Każda połączona strona na Facebooku, każde konto na Instagramie, każdy numer WhatsApp, każda skrzynka e-mail, każdy numer telefonu i każda domena widżetu ma własną listę wyboru. Jeśli jedno połączenie z Metą daje Ci trzy strony na Facebooku, zobaczysz trzy listy i każdej stronie możesz przypisać inny profil.

Każda lista jest podpisana nazwą konta, do którego należy, na przykład Profil marki dla Globex Store, Profil marki dla @globex.store albo Profil marki dla https://globex.example. Gdy dwa konta mają tę samą nazwę, podpis zawiera też cztery ostatnie cyfry identyfikatora konta, na przykład Profil marki dla Shop (…1111).

Gdzie znajdziesz listy wyboru:

• Facebook, Instagram i WhatsApp: otwórz Ustawienia → Integracje, a potem w sekcji Kanały kanał Facebook, Instagram albo WhatsApp (zob. Kanały). Lista jest w wierszu każdej połączonej strony, konta lub numeru.
• E-mail: otwórz okno edycji każdej skrzynki i przejdź na kartę Wysyłka AI. Lista jest podpisana adresem skrzynki.
• Telefon: otwórz stronę szczegółów każdego numeru telefonu. Lista jest podpisana numerem.
• Widżet: w Ustawieniach Widżetu, w sekcji Dostępność w krajach, blok Profil marki dla domeny ma osobny wiersz dla każdej domeny, każdy z własną listą. Samymi domenami nadal zarządzasz w sekcji Ustawienia → Domeny.

Konto bez wybranego profilu używa profilu domyślnego. Na liście to pierwsza opcja, w przykładzie Domyślny (Acme). Dla stron, kont, numerów i domen wybór zapisuje się od razu. W przypadku skrzynki e-mail kliknij Zapisz w oknie edycji.

Brakujące wartości

Profil marki nie musi mieć wartości każdej zmiennej. Gdy wartości brakuje, bot używa wartości z profilu domyślnego.

Żeby braki łatwo było zauważyć, sekcja Ustawienia → Zmienne oznacza je na czerwono:

• baner na górze podaje liczbę braków, na przykład „Brakuje 2 wartości w 1 profilu marki”,
• czerwony znacznik przy zmiennej pokazuje profile marki, w których jej brakuje,
• czerwony znacznik przy profilu marki pokazuje zmienne, których mu brakuje,
• puste pole pokazuje „Brak, używa domyślnej:” i wartość, która zostanie użyta.

Nowy profil marki jest pusty, więc każda zmienna, także COMPANY_NAME, jest oznaczona jako brakująca, dopóki jej nie uzupełnisz. Nowa zmienna jest oznaczona jako brakująca w każdym profilu poza domyślnym.

Usuwanie zmiennych i profili

Nie usuniesz zmiennej, dopóki używa jej jakikolwiek tekst. Fibly pokaże wszystkie miejsca, w których występuje (wpisy w bazie wiedzy, ustawienia bota, powitania telefoniczne, teksty widżetu), każde z odnośnikiem Otwórz. Liczą się też użycia w przykładach kodu. Usuń zmienną z tych miejsc, a potem usuń samą zmienną. COMPANY_NAME jest zmienną wbudowaną i nie da się jej usunąć. Usunięcie zmiennej usuwa jej wartość ze wszystkich profili marki.

Możesz usunąć każdy profil marki poza domyślnym. Zanim potwierdzisz, Fibly pokaże konta, które go używają. Te konta przejdą na profil domyślny.

Kiedy zmiany zaczynają działać

Wartości są wstawiane za każdym razem, gdy tekst jest używany, więc zmieniona wartość działa od razu w następnej odpowiedzi. Nie trzeba ponownie indeksować ani synchronizować bazy wiedzy.

Dwa teksty są uzupełniane raz, na początku rozmowy: Wiadomość powitalna z Ustawień bota i Powiadomienie powitalne widżetu. Zapisują się razem z rozmową, więc rozmowy, które już trwają, zachowują stare wartości. Powitania telefoniczne są uzupełniane na początku każdego połączenia, więc następne połączenie użyje nowej wartości.

Plany i uprawnienia

Zmienne i profile marki są dostępne w planach Starter i Professional. W planie Free strona Zmienne opisuje funkcję, a listy wyboru profilu marki są ukryte. W sprawie planu Enterprise skontaktuj się z opiekunem w Fibly.

Jeśli przejdziesz na plan bez tej funkcji, nic się nie zepsuje. Zmienne są nadal uzupełniane w odpowiedziach dla klientów, zawsze wartościami z profilu domyślnego, a strona Zmienne pokazuje je tylko do odczytu. Po powrocie do wyższego planu znów możesz je edytować i używać pozostałych profili marki.

Zmienne i profile marki mogą zmieniać tylko administratorzy i menedżerowie (zob. Role i uprawnienia).