Integracja z Planfixem

Zintegruj SMSBAT z Planfix CRM, aby wysyłać wiadomości Viber i SMS bezpośrednio z zadań i czatów Planfix. Ten przewodnik opisuje instalację, konfigurację szablonów i automatyzację czatu.

Przegląd

Integracja SMSBAT z Planfix pozwala na:

• Wysyłaj wiadomości Viber i SMS do klientów z zadań Planfix
• Automatycznie twórz zadania na podstawie przychodzących wiadomości na czacie
• Otwórz ponownie czaty, gdy klienci odpowiedzą
• Śledź status dostarczenia wiadomości w Planfix

Warunki wstępne

• Aktywne konto SMSBAT z poświadczeniami API
• Konto Planfix z dostępem administratora
• Zatwierdzony szablon wiadomości Viber Business (dla wiadomości transakcyjnych)

Krok 1: Połącz integrację

1.1 Włącz API czatu w Planfix

Przejdź do Zarządzanie kontem > Integracje > Czaty > Planfix Chat API na swoim koncie Planfix.

Wybierz z listy integrację SMSBAT i włącz ją.

1.2 Skonfiguruj parametry integracji

Wypełnij ustawienia integracji danymi uwierzytelniającymi dostarczonymi przez SMSBAT:

Parametr	Opis
Adres URL żądania	Adres URL udostępniany przez SMSBAT do otrzymywania żądań
Klucz autoryzacyjny	Twój klucz autoryzacyjny SMSBAT
Dostawca	smsbat
Adres URL powiadomienia	Adres URL webhooka do otrzymywania powiadomień o dostawie od Planfix, np. https://api.smsbat.com.ua/planfix/auth/uuid=...
Identyfikator dostawcy	smsbat
Klucz autoryzacyjny Planfix	Klucz autoryzacyjny dla strony Planfix
Szablon zadania	Wybierz szablon, którego chcesz używać do tworzenia zadań na czacie
Szablon kontaktu	Wybierz szablon do tworzenia nowych kontaktów

!!! info „Uzyskiwanie danych uwierzytelniających” Skontaktuj się z pomocą techniczną SMSBAT pod adresem help@smsbat.com, aby otrzymać dane uwierzytelniające integracji (adres URL żądania, klucz autoryzacyjny i adres URL powiadomienia).

1.3 Ustawienia tworzenia zadań

Skonfiguruj sposób, w jaki Planfix obsługuje przychodzące wiadomości czatu:

• Utwórz nowe zadanie, jeśli nie ma aktywnych zadań z tym kontaktem - Włącz tę opcję, jeśli Twój przepływ pracy obejmuje krótkie interakcje lub przetwarzanie leadów, gdzie każde zapytanie powinno tworzyć nowe zadanie.
• Jeśli Twoje cykle sprzedażowe są dłuższe lub zapewniasz bieżące wsparcie, lepiej ponownie otworzyć istniejące zadania, aby zachować pełną historię rozmów z klientem.

Krok 2: Konfiguracja szablonu i automatyzacji czatu

2.1 Skonfiguruj szablon powitania

Uzgodnij z klientem szablon wiadomości powitalnej. Aby zainicjować czat, użyj szablonu wiadomości transakcyjnej, ponieważ jest to bardziej opłacalne niż wiadomość promocyjna.

2.2 Skonfiguruj szablon zadania

Dodaj zatwierdzony szablon wiadomości powitalnej do szablonu zadania pole opisu. Po utworzeniu zadania tekst z opisu zostanie przesłany do klienta jako pierwsza wiadomość.

Przykładowa konfiguracja szablonu zadania:

Pole	Wartość
Nazwa zadania	„Zapytanie biznesowe Viber”
Telefon	Numer telefonu klienta
Kontrahent	Kontrahent klienta
Opis	Twój zatwierdzony szablon wiadomości powitalnej

2.3 Przebieg szybkich interakcji

Jeśli Twój przepływ pracy obejmuje szybkie przetwarzanie i nie musisz prowadzić długich rozmów z potencjalnymi klientami:

1. Przetwórz zapytanie klienta na czacie
2. Odpowiedz klientowi poprzez czat w zadaniu
3. Ustaw status zadania na Ukończone
4. Kiedy klient wyśle nową wiadomość, automatycznie utworzone zostanie nowe zadanie (jeżeli checkbox z kroku 1.3 jest włączony)

2.4 Przebieg trwających rozmów

Jeśli nie chcesz tworzyć osobnego zadania dla każdej wiadomości klienta, skonfiguruj automatyzację ponownego otwierania czatu.

2.4.1 Otwórz ponownie czat poprzez wiadomość transakcyjną

Utwórz scenariusz automatyzacji, który będzie uruchamiany, gdy status zadania zmieni się na Ukończone lub Ukończone:

Scenariusz: „Otwórz ponownie czat”

Ustawienie	Wartość
Wydarzenie	Wartość pola zmieniona
Pole	Rozpocznij czat
Warunki	Rozpocznij czat = Tak ORAZ Stan w (Zakończono, Gotowe)
Logika filtra	1 I 2

Działania:

1. Dodaj komentarz z szablonem wiadomości powitalnej (powiadamiając kontakt jako odbiorcę)
2. Zaznacz pole „Rozpocznij czat”.
3. Zaktualizuj planowany termin zakończenia do aktualnej daty + 1 godzina

2.4.2 Otwórz ponownie czat po nowym komentarzu

Twórz scenariusze automatyzacji, które ponownie otwierają czat po dodaniu nowego komentarza (od potencjalnego klienta/klienta lub pracownika):

Scenariusz: „Otwórz ponownie czat (pracownik)”

Ustawienie	Wartość
Wydarzenie	Dodano komentarz spełniający warunki
Warunki	Status w (Zakończony, Gotowy) ORAZ Autor komentarza = Pracownik
Logika filtra	1 I 2

Działania:

1. Zmień status na W toku
2. Zaktualizuj planowany termin zakończenia do aktualnej daty + 1 godzina
3. Zaktualizuj nazwę zadania, dodając aktualny znacznik czasu i informacje o kliencie

Scenariusz: „Otwórz ponownie czat (klient)”

Ustawienie	Wartość
Wydarzenie	Dodano komentarz spełniający warunki
Warunki	Stan w (Zakończony, Gotowy) ORAZ Autor komentarza = Kontakt
Logika filtra	1 I 2

Działania:

1. Zmień status na Nowy
2. Zaktualizuj planowany termin zakończenia do aktualnej daty + 1 godzina
3. Zaktualizuj nazwę zadania, dodając aktualny znacznik czasu i informacje o kliencie

Krok 3: Wysyłanie wiadomości (powiadomienia o potencjalnych klientach)

Odbiorcy powiadomień

Wysyłając komentarz (zgłaszając leada) upewnij się, że kontakt (lead) jest zaznaczony jako odbiorca na liście powiadomień. Pamiętaj, że stan pola wyboru może się różnić w zależności od warunków, dlatego sprawdź go przed wysłaniem.

3.1 Pole wyboru niezaznaczone – Klient nie otrzyma wiadomości

Jeśli pole wyboru potencjalnego klienta nie jest zaznaczone na liście odbiorców, klient nie otrzyma powiadomienia. Możesz użyć tej opcji, aby pozostawić komentarze wewnętrzne widoczne tylko dla Twojego zespołu.

3.2 Pole wyboru zaznaczone – Klient otrzyma wiadomość

Jeżeli zaznaczono checkbox leada, wiadomość zostanie wysłana do klienta poprzez Viber lub SMS poprzez SMSBAT.

3.3 Weryfikacja dostarczenia wiadomości

Sprawdź status dostawy w Planfix

Kliknij ikonę znacznika wyboru obok wysłanej wiadomości, aby wyświetlić raport doręczenia dla wszystkich odbiorców tego komentarza.

Sprawdź w protokole dostawy

Protokół doręczenia powinien pokazywać klienta jako odbiorcę ze statusem Wysłane (bez statusu błędu). Raport pokazuje datę, kanał (Chat API), numer telefonu odbiorcy i status dostarczenia.

Najlepsze praktyki

Konfiguracja szablonu

• Używaj szablonów wiadomości transakcyjnych do inicjowania czatu (bardziej opłacalne niż promocje)
• Powitania powinny być zwięzłe i istotne
• Przed wdrożeniem przetestuj szablon w małej grupie

Zarządzanie zadaniami

• Używaj oddzielnych szablonów zadań dla różnych typów wiadomości Viber Business
• Włącz opcję automatycznego tworzenia zadań, jeśli obsługujesz krótkie, jednorazowe zapytania
• Zachowaj otwarte zadania dla bieżących relacji z klientami, aby zachować historię czatów

Automatyzacja

• Skonfiguruj scenariusze ponownego otwarcia komentarzy pracowników i klientów
• Użyj planowanych dat zakończenia do śledzenia umowy SLA
• Starannie skonfiguruj odbiorców powiadomień, aby uniknąć niezamierzonych wiadomości

Rozwiązywanie problemów

Wiadomości nie są wysyłane

1. Sprawdź, czy poświadczenia integracji są prawidłowe w ustawieniach Planfix
2. Sprawdź, czy numer telefonu kontaktu ma prawidłowy format
3. Upewnij się, że potencjalny klient jest zaznaczony jako odbiorca na liście powiadomień o komentarzach
4. Sprawdź, czy szablon wiadomości został zatwierdzony

Zadania nie są tworzone automatycznie

1. Upewnij się, że pole wyboru „Utwórz nowe zadanie, jeśli nie ma aktywnych zadań” jest zaznaczone
2. Sprawdź, czy szablon zadania jest poprawnie skonfigurowany
3. Sprawdź, czy adres URL powiadomienia jest ustawiony prawidłowo

Czat nie otwiera się ponownie

1. Sprawdź, czy scenariusze automatyzacji są aktywne
2. Sprawdź, czy warunki statusu odpowiadają statusom przepływu pracy
3. Upewnij się, że pole „Rozpocznij czat” jest prawidłowo skonfigurowane

Następne kroki

• SMSBAT API - Dowiedz się o wysyłaniu wiadomości poprzez API
• Cascade API - Skonfiguruj wielokanałowe dostarczanie wiadomości – Typy wiadomości – Przeglądaj dostępne typy wiadomości – Stan dostawy – Sprawdź statusy dostawy