Społeczność
Instrukcje

Integracje: tokeny API, połączone aplikacje, kalendarze i nakładki

1 wpis7 wyświetleńCzytaj po angielsku
  1. EmanuelWorshipPro

    Integracje łączą WorshipPro z narzędziami, których już używasz. Wybierz według potrzeby:

    • nabożeństwa w kalendarzu Google, Apple albo Outlook: adres kalendarza, programista niepotrzebny,
    • tekst na transmisji: nakładka w aplikacji na komputer,
    • dane dla strony internetowej, arkusza, n8n albo Zapiera: token API,
    • pytania do asystenta AI o pieśni i plany: połączona aplikacja.

    Wszystko to tylko czyta dane. Nic z zewnątrz nie zmieni niczego w Kościele.

    Tokeny i połączone aplikacje są w Ustawienia → Ogólne, zakładka Integracje. Potrzebne jest uprawnienie Ustawienia Kościoła: Zarządzanie (Właściciel, Administrator), a Kościół musi być zweryfikowany: Weryfikacja Kościoła.

    Kalendarze

    Twój osobisty kalendarz. Może to zrobić każdy:

    1. Planowanie → Kalendarz → Subskrybuj.
    2. Kliknij Utwórz adres mojego kalendarza.
    3. Kliknij Dodaj do Google Calendar albo Apple Kalendarz. Do Outlooka użyj Kopiuj adres.

    W kalendarzu są Twoje służby i wydarzenia Kościoła. Zmień adres podmienia adres, a Wyłącz go kończy.

    Kalendarz całego Kościoła albo zespołu. Tu potrzebne jest uprawnienie Kalendarz: Zarządzanie:

    1. Planowanie → Kalendarz → Sale i zasoby, zakładka Kanały iCal.
    2. Wypełnij pole Nazwa kanału i wybierz Cały Kościół albo Zespół.
    3. Kliknij + (Dodaj kanał), potem Kopiuj adres subskrypcji.

    Adres Cały Kościół pokazuje wszystkie wydarzenia z kalendarza. Adres Zespół pokazuje nabożeństwa, w których ten zespół ma obsadę. Unieważnij kończy adres.

    Pamiętaj o dwóch rzeczach. Adres kalendarza działa bez logowania, więc każdy, kto go ma, przeczyta te wydarzenia. A synchronizacja jest jednokierunkowa: zmiany z Google Calendar nie wracają do WorshipPro, a Google odświeża kalendarz nawet co kilka godzin.

    Nakładka na transmisję

    Nakładka jest w aplikacji na komputer, a nie w przeglądarce: Ustawienia → Transmisja, sekcja Napisy do streamu (źródło przeglądarkowe OBS). Działa na Twoim komputerze i nie potrzebuje tokena. Kroki: Transmisja: napisy do OBS, vMix i NDI.

    Tokeny API

    Token pozwala zewnętrznemu narzędziu czytać dane Kościoła. Dawaj go tylko narzędziom, którym ufasz.

    1. Na zakładce Integracje kliknij Nowy token.
    2. Wypełnij pole Nazwa, np. „Strona internetowa”.
    3. W sekcji Co integracja może odczytać zaznacz Pieśni, Plany nabożeństw, Zespoły i obsada, Wydarzenia albo Osoby (dane kontaktowe).
    4. W polu Ważność wybierz 30, 90, 180 albo 365 dni.
    5. Kliknij Utwórz token, potem Kopiuj, i zapisz token w bezpiecznym miejscu. Zobaczysz go tylko ten jeden raz.
    6. Kliknij Gotowe, token jest bezpieczny.

    Do Osoby (dane kontaktowe) potrzebne jest uprawnienie Osoby: Zarządzanie, a przed utworzeniem tokena zaznaczasz Rozumiem — mam umowę powierzenia z odbiorcą. Danych wrażliwych i notatek token nigdy nie dostanie.

    Kościół może mieć 10 aktywnych tokenów. Na liście tokenów:

    • Rotacja tworzy nowy token z tymi samymi zakresami, a Ty stajesz się jego twórcą. Stary działa jeszcze przez wybrany okres, do 7 dni, żeby zdążyć go podmienić.
    • Unieważnij odcina dostęp od razu. Zaznacz pole, jeśli token wyciekł.
    • Ostatnie wywołania pokazują, co token robił przez ostatnie 90 dni.

    Token nigdy nie zrobi więcej, niż może dziś osoba, która go utworzyła. Gdy dostanie węższą rolę, zobaczysz Działa częściowo: twórca ma dziś węższą rolę. Gdy odejdzie, status zmieni się na Nieaktywny: twórca nie ma już dostępu. Naprawi to inny administrator przyciskiem Rotacja.

    Zanim token wygaśnie, jego twórca i właściciel Kościoła dostaną maila: 7 dni wcześniej i ponownie dzień wcześniej.

    Asystent AI i połączone aplikacje

    Możesz podłączyć Claude albo innego asystenta, żeby odpowiadał na pytania o pieśni, plany, obsadę i wydarzenia.

    1. W karcie Asystent AI (MCP) włącz AI ma dostęp. Domyślnie to wyłączone, a bez tego żadne połączenie z AI nie działa, nawet ważne.
    2. Otwórz Jak podłączyć asystenta. Są tam adres serwera i kroki.
    3. W claude.ai dodaj własny konektor z tym adresem i kliknij Połącz.
    4. WorshipPro poprosi o zatwierdzenie połączenia. Wybierz Kościół, zaznacz, co aplikacja może odczytać, i kliknij Zezwól.

    Zatwierdzić może tylko osoba, która zarządza ustawieniami Kościoła. Aplikacja dostaje dostęp tylko do odczytu, do wybranego Kościoła, bez danych kontaktowych, danych wrażliwych, finansów i formularzy.

    Połączenie pojawi się w sekcji Połączone aplikacje. Odwołaj odcina je od razu. Kościół może mieć 20 połączonych aplikacji. Inni asystenci mogą zamiast tego użyć przycisku Nowy token dla asystenta AI.

    Na stronie AI i Twoje dane jest dokładna lista tego, co widzi asystent.

    Webhooki

    Webhooki nie są jeszcze dostępne. Sekcję Webhooki zobaczysz na zakładce Integracje, ale Dodaj adres kończy się komunikatem „Serwer nie ma jeszcze skonfigurowanego bezpiecznego przechowywania kluczy.” Na razie narzędzie, które potrzebuje świeżych danych, może je czytać tokenem API według harmonogramu.

    Dla programistów

    Osobę, która buduje integrację, odeślij na stronę API WorshipPro. Są tam pierwsze wywołanie, zakresy, limity, stronicowanie, przykłady i Specyfikacja OpenAPI (JSON). Token ma limit 120 jednostek na minutę i 5000 na godzinę. Token nie może trafić do przeglądarki odwiedzających, więc strona musi pobierać dane po stronie serwera albo użyć adresu kalendarza.

    Co dalej

Zaloguj się, żeby odpowiedzieć

Zaloguj się, żeby pisać