탐색으로 건너뛰기

Trello

웹훅 도구로 발신자 요청을 Trello 카드로 전환하세요.

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

시작하기 전에

1

API 키 받기

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

2

토큰 생성

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

3

목록 ID 찾기

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

웹훅 도구 만들기

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

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

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

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

Enable을 선택한 다음 콜백을 요청하여 접수 담당자를 테스트하세요. 카드가 목록 맨 아래에 표시됩니다.

문제 해결

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