> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Trello

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](/docs/pl/reception-ai/integrations/webhooks) tworzy kartę przez REST API Trello.

## Zanim zaczniesz

### Pobierz klucz API

Przejdź do [panelu administracyjnego Power-Up](https://trello.com/apps/admin), 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.

> **Note**
>
> 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ę](/docs/pl/reception-ai/receptionist/testing), 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ę.                                                                    |