tally
Create and edit Tally forms via API. Use when building surveys, feedback forms, or questionnaires programmatically. Supports all question types including text inputs, multiple choice, checkboxes, ratings (via workaround), and more.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Create and edit Tally forms via API. Use when building surveys, feedback forms, or questionnaires programmatically. Supports all question types including text inputs, multiple choice, checkboxes, ratings (via workaround), and more.
How to use
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.
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.
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.
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.
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.
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.