> 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

발신자가 콜백, 견적 또는 팀에서 후속 조치해야 할 다른 사항을 요청하면 접수 담당자가 Trello 목록에 카드를 추가할 수 있습니다. [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)가 Trello REST API를 통해 카드를 생성합니다.

## 시작하기 전에

### API 키 받기

[Power-Up 관리자 포털](https://trello.com/apps/admin)로 이동해 워크스페이스용 Power-Up을 생성하고(이름은 중요하지 않음), **Trello Auth** 탭을 연 다음 **Generate a new API key**를 선택합니다.

### 토큰 생성

API 키 옆의 **Token** 링크를 선택하거나, `API_KEY` 자리에 API 키를 넣어 브라우저에서 다음 URL을 엽니다.

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

**Allow**를 선택하고 토큰을 복사합니다. 이 토큰은 접근 가능한 모든 보드를 읽고 변경할 수 있으므로, 필요한 보드에만 멤버로 등록된 계정에서 생성하는 것이 좋습니다.

### 목록 ID 찾기

브라우저에서 보드를 열고 URL 끝에 `.json`을 추가한 다음 페이지를 불러옵니다. 목록 이름을 검색하면 옆에 있는 `id` 값이 목록 ID입니다.

## 웹훅 도구 만들기

**Integrations**로 이동해 **Add integration**을 선택한 다음 **Webhook Tool**을 선택합니다.

| 필드                   | 값                                                                                                                           |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `create_trello_card`                                                                                                        |
| **Description**      | "발신자에게 후속 조치를 약속했거나 팀에서 처리해야 할 사항을 발신자가 요청할 때마다 팀을 위한 카드를 생성합니다."                                                           |
| **Method**           | POST                                                                                                                        |
| **URL**              | `https://api.trello.com/1/cards?idList=LIST_ID`                                                                             |
| **Request Headers**  | `Authorization`: `OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"`                                                  |
| **Body Parameters**  | `name` (문자열, 필수): "발신자의 이름과 필요한 사항을 담은 짧은 제목입니다. 예: Jane Doe에게 견적 관련 콜백."  `desc` (문자열, 필수): "발신자의 이름, 전화번호 및 요청 세부 정보입니다." |
| **Assign to agents** | **Receptionist**                                                                                                            |

목록 ID를 사용해 URL 필드 자체에 `?idList=LIST_ID`를 입력하세요. `idList`를 쿼리 매개변수로 추가하지 마세요. 쿼리 매개변수는 AI가 채우지만 URL의 텍스트는 작성된 그대로 전송됩니다.

> **Note**
>
> Trello는 `&key=API_KEY&token=TOKEN` 형식으로 URL에 키와 토큰을 넣는 방식도 지원합니다. 이 방법도 작동하지만,
> 헤더를 사용하면 URL에 포함되지 않습니다. URL에 넣는 경우 전체 URL을
> 비밀 정보로 취급하세요.

**Enable**을 선택한 다음 콜백을 요청하여 [접수 담당자를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 카드가 목록 맨 아래에 표시됩니다.

## 문제 해결

| 문제                           | 확인할 사항                                                                |
| ---------------------------- | --------------------------------------------------------------------- |
| Trello에서 401을 반환함            | 헤더를 확인하세요. 키와 토큰은 각각 큰따옴표로 묶고 쉼표와 공백으로 구분해야 합니다. 토큰이 취소되었다면 다시 생성하세요. |
| `invalid value for idList`   | URL의 목록 ID가 잘못되었습니다. 보드의 ID가 아니라 목록의 `id`를 사용하세요.                     |
| Trello에서 404를 반환하거나 접근할 수 없음 | 토큰의 사용자가 보드 멤버여야 합니다.                                                 |
| 접수 담당자가 카드를 전혀 생성하지 않음       | 도구 설명에 카드를 생성해야 하는 상황을 명시하세요.                                         |