Attio
ShanoneのAttio連携では、Attioの柔軟なオブジェクトモデルをカバーする76個のツールをエージェントに提供します — 企業・人物・取引といった標準的なCRMレコードに加え、カスタムオブジェクト、リスト、属性(attribute)、ノート、コメント、タスクまで扱えます。はじめに
1
OAuthで接続する
エージェントにAttioで何か作業をしてもらう(例:「エンタープライズタグのついた企業を一覧表示して」)か、Shanoneダッシュボードのインテグレーションから事前に接続します。
2
ワークスペースを承認する
Shanoneにアクセスさせたいワークスペースについて、AttioのOAuth承認画面で承認します。
3
リクエストを再試行する
接続が完了すると、
attio_*ツールに対するshanone_execute_toolの呼び出しが成功するようになります。利用可能なツール
Shanoneは Attio向けに76個のツールを提供しており、以下のカテゴリに分類されています。企業(Companies)
企業(Companies)
attio_list_companies, attio_get_company, attio_create_company, attio_update_company, attio_delete_company, attio_search_companies人物(People)
人物(People)
attio_list_people, attio_get_person, attio_create_person, attio_update_person, attio_delete_person, attio_search_people取引(Deals)
取引(Deals)
attio_list_deals, attio_get_deal, attio_create_deal, attio_update_deal, attio_delete_deal, attio_search_dealsレコード & オブジェクト(カスタムオブジェクト)
レコード & オブジェクト(カスタムオブジェクト)
attio_list_records, attio_get_record, attio_create_record, attio_update_record, attio_delete_record, attio_assert_record, attio_list_objects, attio_get_object, attio_create_object, attio_update_object, attio_get_object_attributes属性(Attributes)
属性(Attributes)
attio_list_attributes, attio_get_attribute, attio_create_attribute, attio_update_attribute, attio_archive_attribute, attio_get_select_options, attio_create_select_optionリスト & エントリー
リスト & エントリー
attio_list_lists, attio_get_list, attio_create_list, attio_update_list, attio_delete_list, attio_get_list_attributes, attio_list_entries, attio_get_entry, attio_create_entry, attio_update_entry, attio_delete_entry, attio_assert_entryタスク
タスク
attio_list_tasks, attio_get_task, attio_create_task, attio_update_task, attio_delete_task, attio_complete_taskノート & コメント
ノート & コメント
attio_list_notes, attio_get_note, attio_create_note, attio_update_note, attio_delete_note, attio_list_comments, attio_get_comment, attio_create_comment, attio_delete_comment, attio_list_threads, attio_create_threadユーザー、ワークスペースメンバー & Webhook
ユーザー、ワークスペースメンバー & Webhook
attio_list_users, attio_get_user, attio_search_users, attio_get_current_user, attio_list_workspace_members, attio_get_workspace_member, attio_list_webhooks, attio_get_webhook, attio_create_webhook, attio_update_webhook, attio_delete_webhookよくある使い方
パイプラインレビュー
ステージ別に取引を一覧・検索し、停滞している取引をまとめる
カスタムオブジェクトの自動化
ワークスペースのスキーマに紐づくカスタムオブジェクト(例:「Renewals」)のレコードを作成・更新する
リスト駆動のワークフロー
企業や人物をキュレーションされたリストに追加し、リスト固有の属性で追跡する
フォローアップタスクの作成
通話や会議の後に、人物や取引のレコードにタスクを作成・割り当てる
トラブルシューティング
attio_create_recordが不明な属性エラーで失敗する
attio_create_recordが不明な属性エラーで失敗する
Attioのオブジェクトスキーマはワークスペースごとに異なり、カスタム属性を含むことがあります。まず
attio_get_object_attributesまたはattio_list_attributesで正確な属性のslugと型を確認してください。attio_assert_record / attio_assert_entryの動作が想定と違う
attio_assert_record / attio_assert_entryの動作が想定と違う
これらはマッチする属性(企業ならドメインなど)に基づくupsert的な操作です — マッチ条件が曖昧または不足していると、意図したレコードを更新するのではなく重複を作成してしまう場合があります。
select/statusフィールドの更新が拒否される
select/statusフィールドの更新が拒否される
enum型の属性(select、status)には、
attio_get_select_optionsから取得した正確なオプションIDまたはタイトルが必要です — 既存のオプションに一致しない自由入力の値は、attio_create_select_optionで先にオプションを作成しない限り失敗します。