Skip to main content

HubSpot

ShanoneのHubSpot連携は、CRM(コンタクト、会社、商談)、マーケティング(キャンペーン、メール、フォーム)、コマース(請求書、注文、決済)、サポート(チケット、フィードバック)にまたがる214個のツールをエージェントに提供します。

はじめに

1

OAuthで接続する

エージェントにHubSpot関連の作業を依頼(例: 「このリードのコンタクトを作成して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

要求されたスコープを許可する

HubSpotのOAuth同意画面には、Shanoneが要求するスコープが一覧表示されます——自分が使う予定の内容に関連するものを承認してください(CRM、マーケティング、コマースはそれぞれ別のスコープグループです)。
3

リクエストを再実行する

接続が完了すると、hubspot_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

利用可能なツール

ShanoneはHubSpot向けに214個のツールを提供しています——カタログの中でStripeに次ぐ2番目に大きな連携です。
hubspot_create_contact, hubspot_get_contact, hubspot_update_contact, hubspot_search_contacts, hubspot_list_contacts, hubspot_merge_contacts, hubspot_batch_create_contacts, hubspot_batch_update_contacts, hubspot_gdpr_delete_contact, hubspot_create_company, hubspot_search_companies, hubspot_merge_companies, hubspot_create_lead, hubspot_get_lead, hubspot_search_leads
hubspot_create_deal, hubspot_get_deal, hubspot_update_deal, hubspot_search_deals, hubspot_merge_deals, hubspot_get_deal_analytics, hubspot_create_pipeline, hubspot_get_pipeline, hubspot_list_pipeline_stages, hubspot_get_forecast, hubspot_list_forecasts
hubspot_create_association, hubspot_delete_association, hubspot_list_associations, hubspot_list_association_types, hubspot_batch_create_associations, hubspot_batch_read_associations, hubspot_batch_delete_associations
hubspot_create_campaign, hubspot_get_campaign_metrics, hubspot_create_marketing_email, hubspot_clone_marketing_email, hubspot_create_form, hubspot_get_form_submissions, hubspot_create_marketing_event, hubspot_record_event_attendance, hubspot_create_workflow, hubspot_enroll_in_workflow
hubspot_create_invoice, hubspot_get_invoice, hubspot_search_invoices, hubspot_create_order, hubspot_get_order, hubspot_create_payment, hubspot_search_payments, hubspot_create_quote, hubspot_create_line_item, hubspot_create_product, hubspot_search_products
hubspot_create_call, hubspot_get_call_recording_url, hubspot_get_call_transcript, hubspot_create_meeting, hubspot_create_note, hubspot_create_task, hubspot_create_ticket, hubspot_merge_tickets, hubspot_create_feedback_submission
hubspot_create_custom_object, hubspot_create_custom_object_schema, hubspot_search_custom_objects, hubspot_create_property, hubspot_update_property, hubspot_create_property_group
hubspot_create_list, hubspot_associate_list_to_event, hubspot_upload_file, hubspot_search_files, hubspot_start_import, hubspot_get_import_status, hubspot_cancel_import
hubspot_subscribe_contact, hubspot_unsubscribe_contact, hubspot_get_contact_subscriptions, hubspot_batch_update_subscriptions, hubspot_gdpr_delete_company

よくあるユースケース

リードエンリッチメント

他所からのインバウンド信号をもとにコンタクトや会社を作成・更新する

パイプラインレポート

ステージ別に商談を要約し、停滞している商談にフラグを立てる

サポートチケットのトリアージ

Slackやメールで挙がった顧客からのメッセージをもとにチケットを作成・更新する

キャンペーンパフォーマンス

ステータス更新のためにキャンペーン/メールの指標を取得する

トラブルシューティング

カスタムオブジェクトは、それに対するレコードを作成(hubspot_create_custom_object)する前に定義(hubspot_create_custom_object_schema)しておく必要があります。正確なオブジェクトタイプ名はhubspot_get_custom_object_schemaで確認してください。
バッチ作成/更新ツール(hubspot_batch_create_contactsなど)はレコードごとにベストエフォートで処理されます——200系のレスポンスだからといって全レコードが成功したとは限らないため、レスポンス内の項目ごとのエラーを確認してください。
まず、対象となる2つのオブジェクトタイプについてhubspot_list_association_typesを呼び出してください——HubSpotの標準およびカスタムのアソシエーションタイプIDはポータルごとに異なります。