Webhooki i powiadomienia w Slacku, Microsoft Teams lub Discordzie
W Pro i Team otwórz Panel > Integracje, aby wysyłać zdarzenia Pandafile na kanał w Slacku, Microsoft Teams lub Discordzie albo na własny serwer jako podpisany webhook. Wybierz zdarzenia, wyślij test i sprawdź dziennik dostarczeń.
W Pro i Team Pandafile może powiadomić twoje inne narzędzia w chwili, gdy coś się dzieje: wiadomością na kanale w Slacku, Microsoft Teams lub Discordzie albo webhookiem, czyli podpisanym żądaniem HTTPS do twojego serwera.
Zdarzenia do wyboru
- Transfer gotowy: wysyłanie się zakończyło i link działa.
- Transfer pobrany: raz na odbiorcę, za pierwszym razem. Zamiast tego możesz wybrać każde pobranie.
- Transfer wygasł.
- Akceptacja lub prośba o zmiany od odbiorcy.
- Przesłanie do jednej z twoich próśb o pliki.
- Dokument podpisany przez wszystkich (Pandafile Sign).
Dodaj integrację
- W Slacku, Microsoft Teams lub Discordzie utwórz przychodzący webhook dla kanału i skopiuj jego URL. Dla własnego systemu użyj adresu HTTPS na swoim serwerze.
- Zaloguj się do Pandafile i otwórz Panel > Integracje.
- W sekcji Dodaj integrację wybierz typ, wklej URL, opcjonalnie nadaj nazwę i zaznacz potrzebne zdarzenia.
- Kliknij Dodaj integrację, a potem Wyślij zdarzenie testowe, aby sprawdzić, czy dociera.
Możesz mieć do 5 integracji. Wiadomości na czacie są pisane w języku twojego konta.
Webhooki dla programistów
- Każde dostarczenie to JSON POST z typem zdarzenia, identyfikatorem i szczegółami: identyfikatory, tytuły, linki, liczby i adresy e-mail odbiorców. Nigdy nie zawiera treści plików, haseł ani osobistych linków do pobrania.
- Każde żądanie ma nagłówek Pandafile-Signature ze znacznikiem czasu (t) i podpisem HMAC-SHA256 (v1) znacznika czasu i treści, utworzonym twoim sekretem do podpisywania. Sekret zaczyna się od whsec_ i jest pokazywany tylko raz.
- Nowy sekret tworzy nowy sekret do podpisywania. Stary działa jeszcze przez 24 godziny, więc możesz przejść na nowy bez utraty zdarzeń.
- Odpowiedz statusem 2xx w ciągu 10 sekund. W przeciwnym razie ponawiamy próbę po 1 minucie, 5 minutach, 30 minutach, 2 godzinach i 12 godzinach.
- Dziennik dostarczeń pokazuje 50 ostatnich dostarczeń każdej integracji i ich wynik.
Zespoły, tryb testowy i Zapier
W zespole każdy zarządza własnymi integracjami i dostaje zdarzenia tylko dla własnych transferów. Zdarzenia o transferach testowych utworzonych testowym kluczem API trafiają do webhooków z livemode ustawionym na false, nigdy do Slacka, Teams ani Discorda. Zapier i Make łączą się przez API Pandafile i są widoczne w sekcji Subskrypcje API.