Integracja z pocztą Gmail Integracja Poczta Google Wersja 1.0 SPIS TREŚCI
SPIS TREŚCI 1. Rozpoczęcie współpracy 2. Konfiguracja Poczty Gmail 3. Konfiguracja skryptu ComVision 2015, strona nr: 2/7
1. Rozpoczęcie współpracy Integracja pozwala na konfigurację automatycznych powiadomień SMS o przychodzących wiadomościach w poczcie Gmail. W celu rozpoczęcia współpracy należy utworzyć konto w serwisie SMSAPI: http://www.smsapi.pl/ Utworzone konto jest gotowe do użytku, jednak zalecamy ustawienie własnego pola nadawcy. Jako domyślne ustawione jest pole nadawcy SMSAPI. Dodanie pola nadawcy jest usługą całkowicie darmową. 2. Konfiguracja Poczty Gmail Skrypt monitoruje wiadomości na podstawie etykiet. Aby ustawić automatyczne przypisywanie etykiety od zdefiniowanego odbiorcy, należy zalogować się na pocztę Gmail, następnie kliknąć w ikonę koła zębatego znajdującą się w prawym górnym rogu strony i przejść do ustawień (rys. 1). (rys. 1) W ustawieniach należy przejść do zakładki Filtry, a następnie wybrać opcję utwórz nowy filtr (rys. 2). (rys. 2) ComVision 2015, strona nr: 3/7
W następnym kroku należy określić parametry, dla których danej wiadomości zostanie przypisana odpowiednia etykieta. W tym przypadku powiadomienia będą wysyłane na odebrane wiadomości z adresu bok@smsapi.pl Oznacza to, że wszystkie wiadomości od zdefiniowanego odbiorcy będą automatycznie zapisywane z wybraną etykietą. (rys. 3) Aby przejść dalej, należy kliknąć w link Utwórz filtr na podstawie tych kryteriów wyszukiwania (rys. 3). Należy zaznaczyć opcję zastosuj etykietę, a następnie stworzyć nową, lub wybrać wcześniej utworzoną (rys. 4). (rys. 4) ComVision 2015, strona nr: 4/7
3. Konfiguracja skryptu Aby dokonać konfiguracji usługi SMSAPI w Google Mail należy upewnić się czy jesteśmy zalogowani na odpowiednim koncie w usłudze Google a następnie przejść pod adres https://script.google.com (rys. 5). Wybieramy Start Scripting (rys.5) a następnie Blank Project (rys.6). (rys. 5) (rys. 6) ComVision 2015, strona nr: 5/7
(rys. 7) W nowo otwartym oknie usuwamy przykład rozpoczętego skryptu oraz wklejamy skrypt dostępny pod adresem http://www.smsapi.pl/integracje/poczta-google (rys. 7). Do poprawnego działania skryptu należy uzupełnić wartości zmiennych: MAIL_LABEL, nazwa monitorowanej, ustawionej wcześniej etykiety w usłudze Gmail SMSAPI_LOGIN, login w serwisie SMSAPI SMSAPI_PASSWORD, hasło do API zakodowane w MD5 UWAGA! Hasło do interfejsu API po rejestracji jest takie same jak hasło do panelu WWW. Istnieje możliwość zmiany hasła do interfejsu API w zakładce Ustawienia API. Zmiana hasła do panelu WWW nie wpływa na hasło API. Hasło zakodowane w MD5 można wygenerować w panelu klienta pod adresem https://ssl.smsapi.pl/client_api/password Pokaż hasło do API w MD5. SMSAPI_SENDERNAME, aktywne pole nadawcy z którym zostanie wysłane powiadomienie SMS SMSAPI_RECIVER, numer telefonu na który będą wysyłane powiadomienia SMS MESSAGE, treść powiadomienia, :SENDER jest zastępowane adresem e-mail nadawcy a :TITLE tematem wiadomości e-mail W celu ustawienia częstotliwości wykonywania skryptu należy wybrać (wyzwalacze bieżącego projektu) a następnie dodać nowy wyzwalacz i wybrać częstotliwość wyzwalania (rys. 8). (rys. 8) ComVision 2015, strona nr: 6/7
Do poprawnego uruchomienia skryptu wymagane jest nadanie mu uprawnień. Skrypt pobiera informacje o adresach e-mail nadawców wiadomości oraz ich tematach dla zdefiniowanej w ustawieniach poczty Gmail etykiety. Następnie wykonywane są odpowiednio przygotowane odwołania do naszego API które skutkują wysłaniem powiadomienia SMS. (rys. 9-10). (rys. 9) (rys. 10) ComVision 2015, strona nr: 7/7