ナビゲーションにスキップ

Monday.com

Webhookツールを使って、通話中にMonday.comアイテムを作成・検索します。

レセプショニストは、新しいリードや折り返し依頼などのアイテムをMonday.comボードに追加したり、名前でアイテムを検索したりできます。Monday.comのAPIはGraphQLです。すべてのリクエストはqueryフィールドを1つ含むPOSTであるため、各ツールにはレセプショニストが入力するクエリテンプレートを設定します。

始める前に

値確認場所
APIトークンプロフィール写真 → Developers → My access tokens
ボードIDボードURL内の/boards/の後にある数字

トークンは、すべてのボードに対するアクセス権を持つ本人として機能します。

アイテムを作成する

Integrationsに移動し、Add integrationを選択して、Webhook Toolを選びます。

フィールド値
名前create_monday_item
説明「チームのボードに折り返し依頼を追加します。発信者にフォローアップを約束したときは必ず使用します。」
メソッドPOST
URLhttps://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、ヘッダーを使用して、2つ目のWebhookツールを作成します。

フィールド値
名前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 } } } } }

折り返し依頼でレセプショニストをテストし、2回目の会話でその依頼について尋ねます。

制限事項

作成ツールで設定できるのはアイテム名のみです。ステータス、日付、担当者の列を入力するには、GraphQLクエリ内にJSON値が必要ですが、レセプショニストがこれを確実に記述するのは困難です。列を設定するには、Zapier経由でMonday.comのCreate Itemアクションを使用してください。

トラブルシューティング

問題確認事項
Not AuthenticatedヘッダーにはBearerなしで、トークンのみを設定する必要があります。
Parse error on ...レセプショニストがクエリの形を変更しました。queryの説明をより厳密にするか、アイテム名を短くしてください。
アイテムが見つからない検索ではアイテム名が完全に一致する必要があります。
Board not foundボードIDと、トークンのオーナーがボードを閲覧できることを確認してください。