ngrok-unofficial-webhook-skill
Odbieraj webhooki na publicznym adresie URL za pośrednictwem ngrok i przetwarzaj je przez AI
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Umiejętność uruchamiająca tunel ngrok do odbierania przychodzących webhooków i automatycznego routowania ich do pasujących umiejętności lub do modelu AI. Przydatna, gdy potrzebujesz publicznego punktu końcowego dla integracji zewnętrznych, takich jak Zoom czy inne usługi wysyłające powiadomienia. Serwer natychmiast potwierdza odbiór webhooka (200 OK) i pozwala AI zdecydować, jak go obsłużyć.
Jak używać
Przygotuj środowisko: przejdź do katalogu skills/ngrok-unofficial-webhook-skill i uruchom npm install, aby zainstalować wymagane zależności.
Skonfiguruj zmienne środowiskowe: skopiuj plik .env.example do .env i uzupełnij wymagany token NGROK_AUTHTOKEN, który możesz uzyskać z https://dashboard.ngrok.com. Opcjonalnie możesz ustawić NGROK_DOMAIN dla stałego adresu URL, WEBHOOK_PORT (domyślnie 4040) oraz WEBHOOK_PATH (domyślnie /webhook).
Uruchom serwer webhooków: wykonaj node scripts/webhook-server.js w katalogu umiejętności. Serwer wypisze publiczny adres URL na stderr w formacie NGROK_URL=https://xxxx.ngrok-free.app.
Użyj adresu URL webhooka: skopiuj wypisany adres (np. https://xxxx.ngrok-free.app/webhook) i skonfiguruj go w zewnętrznej usłudze, która ma wysyłać do Ciebie webhooki.
Serwer automatycznie odkrywa zainstalowane umiejętności, które deklarują webhookEvents w pliku skill.json, i routuje przychodzące webhooki do pasujących usług lub prezentuje je AI do ręcznej obsługi.
Dla długotrwałego działania uruchom serwer w tle za pomocą nohup: nohup node scripts/webhook-server.js >> /tmp/ngrok-webhook.log 2>&1 &