チュートリアル | CAAC - Assignment API

Assignment APIは、外部システムと連携することができ、チャットを特定のチームやユーザーに担当者として割り当てることを可能にします。複雑な割り当てロジックを必要とする企業様向けに設計された割り当て機能です。この機能により、外部機能と連携し、割り当てルールを柔軟に調整することで多様なニーズを満たすことができます。

📖 参照：Tutorials｜CAAC Individual Assignment

CAAC Assignment API を利用するには、当社のCAAC API TokenとAPI ドキュメントを入手する必要があります。

➤Assignment APIの特徴

高度な割り当て機能

• CAACの管理機能と並行して、外部システムのルールに基づく割り当てをサポートします。
• 多様な割り当て設定： CAACの「永続割り当て」「チーム割り当て」「シフト制割り当て」などの割り当て設定と同期した柔軟な割り当てが可能です。

包括的な連携と自動化

• 既存の顧客管理システムと互換性があり、多様なユースケースに対応します。
• Webhook Forward機能と連携し、新規チャットや割り当てのルールを自動化します。

サービス効率の向上

• 自動割り当てを利用することで、割り当てを手動で管理する必要が不要になりコンタクトの待ち時間を短縮することができます。
• CAACのデータ分析機能をサポートし、「チーム」「ユーザー」の担当者パフォーマンス指標を確認することができ、ワークフローを最適化に役立ちます。

➤ターゲットユーザー

• 既にCAACを使用中の複雑な割り当てルールを必要とする方
• 「従業員のシフト、作業量」や「お客様のビジネスタイプ」に基づく割り当てなど、カスタマイズされた担当者割り当て機能を必要とする方

➤割り当て方法の種類

1. 外部個別割り当て（APIドキュメント：External Individual Assign）

   • VIP顧客対応のような専属の担当者がコンタクトに対応するシナリオに適しています。
   • チャット割り当て後、特定のCAACユーザーが永久的に担当者に割り当てられます。

2. 外部通常割り当て機能（APIドキュメント：External Manual Assign）

   • CAACで設定された割り当てルールに従って動作します。
   • 担当者の割り当て解除に対応します。

➤CAAC Assignment APIの設定

1. データ同期

Before using CAAC Assignment API, ensure data preparation and synchronization are completed to establish linkage between CAAC and third-party systems for assignment targets (teams, agents).

• データ同期方法
  

  • 一括更新：

    • システムが提供するCSVテンプレートを使用して、チームとユーザーのデータを迅速に同期します。ユーザーロール、チームコードなどの一括追加・更新に対応（Tutorials｜CAAC Users）

  • APIによる自動同期
    • 「チーム管理API」「ユーザー管理API」を利用し、データを自動更新することで、ユーザーとチームの関係性を同期させることができます。

•  

2. トリガー割り当て

カスタマイズされた割り当ての一般的なニーズは以下のとおりです。

1. 外部システムからのイベントに基づいて割り当てをトリガーする
   
   • シナリオ例：
     • コンタクトのステータスが「商談中」から「購入完了」に変更されたとき、チャットの担当者は 「営業チーム」から「CSチーム」に変更したい。
   • システムワークフロー設計：
     • 外部システムが 「購入イベント」を発動させると、割り当てAPIを呼び出し、特定のチャットの担当者に「CSチーム」を割り当てる。
     • チャットが「CSチーム」に割り当てられると、チーム内の特定のユーザーを担当者として割り当てることができます。 (Tutorials｜CAAC Team Management)
2. 外部システムの割り当てロジックに基づく新規チャットの割り当て
   
   • シナリオ例：
     • シフトスケジュール、仕事量、ビジネスタイプに基づいて新規コンタクトを割り当てる割り当てシステムをすでに持っている。

     • 新規コンタクトからの問合せを、既存の割り当てロジックに従って割り当てたい。

   • システムワークフロー設計：
     • LINE Webhook機能を活用して、チャットがCAACと外部システムに同時にルーティングされるようにします。
     • 外部システムが新規チャットを受け取ると、そのコンタクトに割り当てられた担当者がいないかどうかチェックし、割り当てAPIを呼び出して特定のチームに会話を割り当てます。