Integracja z E-chat
1. Cel projektu
Zorganizować automatyczne przesyłanie rozmów klientów z komunikatorów Viber i Telegram przez serwis E-chat do systemu 1C:UNF+Serwis samochodowy
2. Ogólny schemat integracji
Klient wysyła wiadomość w Viber/Telegram.
Wiadomość jest rejestrowana w E-chat.
E-chat generuje zdarzenie (JSON) i wysyła je na serwer internetowy firmy (webhook).
Serwer internetowy przyjmuje dane i przekazuje je do 1C przez usługę HTTP „Odbieranie historii rozmów z E-chat”.
W 1C tworzony jest wpis w rejestrze informacji „Historia rozmów w komunikatorach”.
Dokumentacja API E-chat https://help.e-chat.tech/ru/viber/ru-api
3. Metody API, które będziemy używać
Viber:
POST/channel/connect - utworzenie kanału
POST/channel/disconnect - wyłączenie kanału
POST/link to your webhook for incoming message - odbieranie wiadomości
POST/link to your webhook for outgoing message status - odbieranie statusów wychodzących wiadomości
Telegram:
POST/CreateChannel.php - utworzenie kanału
POST/DisableChannel.php - wyłączenie kanału
POST/:webhook [IncomingMessage] - odbieranie wychodzących i przychodzących wiadomości
POST/:webhook [OutgoingMessageStatus] - odbieranie statusów wiadomości
4. Grupa E-chat w interfejsie 1C
W sekcji CRM utworzyć grupę E-chat
W grupie E-chat utworzyć Ustawienia. W ustawieniach proponuję umieścić klucze API dla Viber i Telegram oraz utworzyć przyciski z funkcjonalnością dwóch pierwszych metod API do łączenia/rozłączania kanałów. Wyświetlać grupę E-chat wszystkim użytkownikom (Podstawowe prawa UNF). Ustawienia pokazujemy tylko pełnym prawom i wprowadzać zmiany w ustawieniach E-chat dajemy tylko pełnym prawom.
Do tej samej grupy wprowadzić nowy Rejestr informacji „Historia rozmów w komunikatorach”. Wyświetlać tylko dla pełnych praw.
5. Rejestr informacji „Historia rozmów w komunikatorach”
pytanie do programisty: jak architektonicznie w 1C najlepiej przechowywać historię rozmów w komunikatorach - w jednym rejestrze czy dwóch oddzielnych? W przyszłości historia rozmowy będzie używana do kontroli komunikacji z klientami i wyświetlana w Zleceniu na 2 oddzielnych zakładkach.
Utworzyć nowy Rejestr informacji „Historia rozmów w komunikatorach”.
Prawa do odczytu i zmiany dajemy tylko użytkownikom z pełnymi prawami.
5. Ustawienie logowania
„Włączyć logowanie wymiany z E‑chat” (Tak/Nie).
Przy włączonym znaku:
Przy wyłączonym znaku:
6. Wyświetlić historię rozmowy w Zleceniu
W dokumencie zlecenia na zakładce Komunikacja dodać 2 zakładki Viber i Telegram i na każdej zakładce wyświetlać historię rozmowy odpowiedniego komunikatora. Wiadomości rozmowy wybieramy za 30 minut przed datą utworzenia i do daty zakończenia. Kontrahenta wybieramy po numerach telefonów. Jeśli data zakończenia jest pusta, to po bieżącą datę. Dostęp do zakładki dajemy roli Podstawowe prawa UNF.
6. Usługa HTTP „Odbieranie historii rozmów z E-chat”
Utworzyć usługę HTTP w 1C, dostępną przez HTTPS.
Przyjmować dane metodą POST w formacie JSON.
Walidować token autoryzacji.
Przetwarzać przychodzące dane:
Zapisuj wiadomość w rejestrze „Historia rozmów w komunikatorach”. W zależności od ustawienia logowania wypełnia się logiem
