Monday.com | ElevenLabs Documentation

리셉셔니스트는 신규 리드나 콜백 요청과 같은 항목을 Monday.com 보드에 추가하고, 이름으로 항목을 찾을 수 있습니다. Monday.com의 API는 GraphQL입니다. 모든 요청은 query 필드 하나를 포함하는 POST이므로, 각 도구는 리셉셔니스트가 채울 수 있는 쿼리 템플릿을 제공합니다.

시작하기 전에

값	확인 위치
API 토큰	프로필 사진 → Developers → My access tokens
보드 ID	보드 URL에서 `/boards/` 뒤에 있는 숫자

이 토큰은 모든 보드에 대한 사용자 권한으로 작동합니다.

항목 만들기

Integrations로 이동해 Add integration을 선택한 다음 Webhook Tool을 선택하세요.

필드	값
이름	`create_monday_item`
설명	”팀 보드에 콜백 요청을 추가합니다. 발신자에게 후속 연락을 약속할 때마다 사용하세요.”
메서드	POST
URL	`https://api.monday.com/v2`
요청 헤더	`Authorization`: `Bearer` 없이 API 토큰 입력
본문 매개변수	아래 설명이 포함된 `query`(문자열, 필수)
에이전트에 할당	Receptionist

query에는 아래 설명을 사용하고, 1234567890을 보드 ID로 바꾸세요.

A GraphQL mutation in exactly this form, changing only ITEM_NAME:
mutation { create_item(board_id: 1234567890, item_name: "ITEM_NAME") { id } }
ITEM_NAME is the caller's name, phone number, and request, without double quotes.

Enable을 선택하세요.

항목 찾기

동일한 메서드, URL, 헤더로 두 번째 웹훅 도구를 만드세요.

필드	값
이름	`find_monday_item`
설명	”보드에서 발신자의 항목을 정확한 이름으로 찾습니다. 발신자가 기존 작업에 관해 문의할 때 사용하세요.”
본문 매개변수	아래 설명이 포함된 `query`(문자열, 필수)

A GraphQL query in exactly this form, changing only ITEM_NAME:
query { items_page_by_column_values(board_id: 1234567890, limit: 5, columns: [{column_id: "name", column_values: ["ITEM_NAME"]}]) { items { name column_values { text column { title } } } } }

콜백 요청으로 리셉셔니스트를 테스트한 후, 두 번째 대화에서 해당 요청에 관해 물어보세요.

제한 사항

만들기 도구는 항목 이름만 설정합니다. 상태, 날짜 또는 담당자 열을 채우려면 GraphQL 쿼리 안에 JSON 값을 작성해야 하는데, 리셉셔니스트가 이를 안정적으로 작성하기는 어렵습니다. 열을 설정하려면 Zapier를 통해 Monday.com의 Create Item 액션을 사용하세요.

문제 해결

문제	확인할 사항
`Not Authenticated`	헤더에는 `Bearer` 없이 토큰만 입력해야 합니다.
`Parse error on ...`	리셉셔니스트가 쿼리 구조를 변경했습니다. `query` 설명을 더 엄격하게 작성하거나 항목 이름을 줄이세요.
항목을 찾을 수 없음	조회는 전체 항목 이름과 정확히 일치해야 합니다.
`Board not found`	보드 ID와 토큰 소유자가 해당 보드를 볼 수 있는지 확인하세요.