novafon-api

Skill umożliwia połączenie z dwoma API Novafon: Data API do dostępu do danych i raportów oraz Call API do tworzenia i zarządzania połączeniami telefonicznymi. Obie usługi działają na protokole JSON-RPC 2.0 i wymagają konfiguracji zmiennych środowiskowych (URL API, token dostępu) oraz dodania IP do białej listy w panelu administracyjnym. Skill wspiera filtrowanie, sortowanie i paginację danych, obsługuje szczegółowe kody błędów i wymaga zainstalowanych narzędzi curl oraz jq.

1. Przygotuj trzy zmienne środowiskowe: NOVAFON_DATA_API_URL (zwykle dataapi-jsonrpc.novofon.ru/v2.0), NOVAFON_CALL_API_URL (zwykle callapi-jsonrpc.novofon.ru/v4.0) oraz NOVAFON_API_TOKEN zawierający Twój access token. 2. Upewnij się, że na Twoim serwerze zainstalowane są narzędzia curl i jq, które są wymagane do działania skilla. 3. Dodaj adres IP Twojego serwera do białej listy w panelu administracyjnym Novafon — bez tego kroku żadne żądania nie będą akceptowane. 4. Aby pobrać dane konta, wyślij żądanie POST do NOVAFON_DATA_API_URL z nagłówkiem Content-Type: application/json i ciałem zawierającym JSON-RPC 2.0 request z metodą get.account, identyfikatorem żądania i wersją JSONRPC. 5. Wszystkie parametry i nazwy pól muszą być w formacie snake_case — zwróć uwagę na tę konwencję przy konstruowaniu żądań. 6. Obsługuj odpowiedzi błędów na podstawie kodów i mnemonik zwracanych przez API, które są szczegółowo udokumentowane w dokumentacji Novafon.