tally

Skill do zarządzania formularzami Tally przez REST API. Automatyzuj tworzenie i edycję ankiet, formularzy opinii oraz kwestionariuszy bez wychodzenia z kodu. Obsługuje pola tekstowe, pytania wielokrotnego wyboru, checkboxy, daty, numery telefonu i wiele innych typów pytań. Idealny dla deweloperów budujących systemy zbierające dane od użytkowników.

1. Skonfiguruj klucz API Tally, zapisując go w pliku ~/.config/tally/api_key. Klucz będzie automatycznie wczytywany przez skill podczas połączenia z API.

2. Pobierz listę istniejących formularzy, wysyłając żądanie GET do https://api.tally.so/forms. Otrzymasz identyfikatory wszystkich Twoich formularzy, które możesz następnie edytować lub pobrać szczegóły.

3. Aby pobrać szczegóły konkretnego formularza, użyj GET na https://api.tally.so/forms/{id}, gdzie {id} to identyfikator formularza. Odpowiedź zawiera strukturę bloków, z których zbudowany jest formularz.

4. Edytuj formularz, wysyłając żądanie PATCH do https://api.tally.so/forms/{id} z nową strukturą bloków. Pamiętaj, że każde pytanie musi składać się z dwóch bloków: bloku TITLE (zawierającego tekst pytania) oraz bloku INPUT (np. INPUT_TEXT, CHECKBOX, MULTIPLE_CHOICE_OPTION), które muszą dzielić ten sam groupUuid i groupType QUESTION.

5. Pobierz odpowiedzi użytkowników na pytania formularza, wysyłając GET do https://api.tally.so/forms/{id}/submissions. Zwrócone dane zawierają wszystkie przesłane odpowiedzi.

6. Zwróć uwagę, że niektóre typy pytań (RATING, LINEAR_SCALE) nie renderują się prawidłowo przez API — jeśli ich potrzebujesz, rozważ użycie workaroundów lub edycję formularza bezpośrednio w interfejsie Tally.