Trello | ElevenLabs Documentation

Twój recepcjonista może dodać kartę do listy Trello, gdy rozmówca prosi o oddzwonienie, wycenę lub inną sprawę, którą zespół powinien załatwić. Narzędzie webhook tworzy kartę przez REST API Trello.

Zanim zaczniesz

Pobierz klucz API

Przejdź do panelu administracyjnego Power-Up, utwórz Power-Up dla swojego obszaru roboczego (nazwa nie ma znaczenia), otwórz kartę Trello Auth i wybierz Generate a new API key.

Wygeneruj token

Wybierz link Token obok klucza API albo otwórz w przeglądarce ten adres URL, wstawiając swój klucz API w miejsce API_KEY:

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Reception&key=API_KEY

Wybierz Allow i skopiuj token. Może on odczytywać i zmieniać wszystkie tablice, do których masz dostęp, więc rozważ wygenerowanie go z konta należącego tylko do potrzebnej tablicy.

Znajdź identyfikator listy

Otwórz tablicę w przeglądarce, dodaj .json na końcu jej adresu URL i wczytaj stronę. Wyszukaj nazwę listy; wartość id obok niej to identyfikator listy.

Utwórz narzędzie webhook

Przejdź do Integrations, wybierz Add integration, a potem Webhook Tool.

Pole	Wartość
Nazwa	`create_trello_card`
Opis	”Utwórz kartę dla zespołu, gdy obiecasz rozmówcy dalszy kontakt lub gdy poprosi o coś, czym zespół musi się zająć.”
Metoda	POST
URL	`https://api.trello.com/1/cards?idList=LIST_ID`
Nagłówki żądania	`Authorization`: `OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"`
Parametry body	`name` (string, wymagane): “Krótki tytuł z nazwiskiem rozmówcy i jego potrzebą, na przykład: Oddzwoń do Jane Doe w sprawie wyceny.” `desc` (string, wymagane): “Imię i nazwisko rozmówcy, numer telefonu oraz szczegóły jego prośby.”
Przypisz do agentów	Receptionist

Wpisz ?idList=LIST_ID bezpośrednio w polu adresu URL, podając identyfikator swojej listy. Nie dodawaj idList jako parametru zapytania: parametry zapytania są wypełniane przez AI, a tekst w adresie URL jest wysyłany dokładnie tak, jak został wpisany.

Trello akceptuje też klucz i token w adresie URL jako &key=API_KEY&token=TOKEN. To również działa, ale nagłówek nie umieszcza ich w adresie URL. Jeśli dodasz je do adresu URL, traktuj cały adres URL jako sekret.

Wybierz Enable, a następnie przetestuj recepcjonistę, prosząc o oddzwonienie. Karta pojawi się na dole listy.

Rozwiązywanie problemów

Problem	Co sprawdzić
Trello zwraca 401	Sprawdź nagłówek: klucz i token muszą być w podwójnych cudzysłowach, oddzielone przecinkiem i spacją. Wygeneruj token ponownie, jeśli został cofnięty.
`invalid value for idList`	Identyfikator listy w adresie URL jest nieprawidłowy. Użyj `id` listy, a nie tablicy.
Trello zwraca 404 lub brak dostępu	Użytkownik tokenu musi należeć do tablicy.
Recepcjonista nigdy nie tworzy kart	Upewnij się, że opis narzędzia wskazuje sytuacje, w których powinno utworzyć kartę.