HubSpot은 2024년 12월에 원래의 타사 OneSignal 앱을 더 이상 지원하지 않습니다. OneSignal은 현재 확장된 기능을 갖춘 자체 HubSpot 앱을 제공합니다. 이전 통합을 사용했다면 아래의 마이그레이션 단계를 참조하세요.
레거시 HubSpot 통합에서 마이그레이션
새 통합 설치아래의 HubSpot을 OneSignal에 연결 섹션에 설명된 대로 OneSignal 대시보드의 데이터 > 통합에서 HubSpot 통합을 활성화합니다.워크플로 마이그레이션기존 워크플로의 액션을 교체하기 전에 새 통합을 테스트하기 위한 새 워크플로를 만드는 것을 권장합니다.
HubSpot 연락처를 OneSignal 사용자에 연결하려면 OneSignal의 외부 ID를 HubSpot의 고유 속성(예: 사용자 ID 또는 이메일 주소)과 일치하는 값으로 설정합니다.앱 또는 웹사이트에서 SDK login 메서드를 사용하여 외부 ID를 설정합니다. 매칭이 안정적으로 이루어지도록 앱과 HubSpot 모두에서 쉽게 사용할 수 있는 속성을 선택하세요.
알림 보내기 액션은 매칭된 OneSignal 사용자에게 푸시 알림, 이메일 또는 SMS를 전달합니다.
이메일이 아닌 OneSignal 외부 ID로 사용자를 매칭하세요. 이메일 매칭은 addEmail SDK 메서드를 사용하여 이메일을 설정한 고객을 위한 레거시 옵션입니다.
OneSignal 알림 보내기 액션 구성.
템플릿 사용OneSignal 대시보드 또는 API에서 생성된 사전 정의된 템플릿을 선택합니다. 템플릿은 푸시 알림, 이메일, SMS를 지원합니다.양식 필드 사용템플릿을 선택하지 않으면 제목, 부제목, 메시지, 이미지 URL, 실행 URL 필드를 사용하여 워크플로 액션에서 직접 푸시 알림을 작성할 수 있습니다. 이메일과 SMS는 템플릿을 통해서만 사용 가능합니다.양식 필드 옵션을 사용하면 HubSpot 연락처 속성(예: 이름)을 삽입하여 알림 콘텐츠를 개인화할 수 있습니다.
HubSpot 목록 또는 양식에 의해 트리거된 인앱 메시지로 특정 오디언스를 타겟팅합니다.
단계
유형
구성
등록 트리거
HubSpot
연락처가 정적 또는 활성 목록(예: “봄 세일 대상자”)의 멤버가 됨
액션 1
OneSignal: 태그 편집
{ "promo": "spring_2025" }
그런 다음 HubSpot으로 인앱 메시지 보내기 단계를 따라 promo = spring_2025와 일치하는 OneSignal 세그먼트를 만들고 해당 세그먼트에 대한 인앱 메시지를 구성합니다.캠페인이 끝난 후 사용자를 캠페인에서 제거하려면 태그를 삭제하는 두 번째 워크플로를 만듭니다:
직접은 불가능합니다. HubSpot 목록과 OneSignal 세그먼트는 독립적인 시스템입니다. 연결하려면 HubSpot 목록에서 연락처를 등록하는 워크플로를 만들고 태그 편집 액션을 사용하여 태그를 설정합니다. 그런 다음 해당 태그를 기반으로 OneSignal 세그먼트를 구축합니다. 구체적인 예는 인앱 메시지를 통한 프로모션 캠페인을 참조하세요.
태그만으로는 인앱 메시지가 트리거되지 않습니다. 태그는 사용자를 세그먼트에 추가하지만 인앱 메시지를 표시하려면 여전히 트리거가 필요합니다. 사용자가 앱을 적극적으로 사용 중일 때 태그가 설정된 경우 다음 세션(30초 이상 백그라운드)까지 표시되지 않습니다. 가장 안정적인 동작을 위해 인앱 메시지 트리거를 앱 열기 시로 설정하세요. 모든 트리거 옵션은 인앱 메시지 트리거를 참조하세요.
예. HubSpot의 커스텀 코드 워크플로 액션을 사용하여 외부 API에 HTTP 요청을 만들 수 있습니다. OneSignal REST API를 호출하여 네이티브 통합 외부에서 메시지 보내기, 사용자 생성, 태그 업데이트를 할 수 있습니다. 이는 네이티브 액션이 다루지 않는 사용 사례(개별 사용자가 아닌 세그먼트로 보내기 등)에 유용합니다.
예. 이벤트 스트림을 사용하여 OneSignal 메시지 이벤트(보낸, 클릭된 등)를 웹훅 엔드포인트로 내보낼 수 있습니다. 이러한 이벤트를 HubSpot의 커스텀 이벤트 API로 라우팅하거나 미들웨어 서비스를 사용하여 OneSignal 참여 데이터를 기반으로 HubSpot 연락처 속성을 업데이트할 수 있습니다.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OneSignal Documentation","description":"OneSignal is a platform for sending push notifications, emails, in-app messages, and SMS campaigns via a single API, Journey Builder, and a dashboard.","colors":{"primary":"#3A3DB3","light":"#E54B4D","dark":"#3A3DB3"},"logo":{"light":"https://mintcdn.com/onesignal/yJcueeDCO7UpHnnY/logo/OneSignal-Logo.svg?fit=max\u0026auto=format\u0026n=yJcueeDCO7UpHnnY\u0026q=85\u0026s=1fcfb6fef6d820fd9d99c74850711107","dark":"https://mintcdn.com/onesignal/s4WC_KzLxf8ornqq/logo/OneSignal-Logo-White.svg?fit=max\u0026auto=format\u0026n=s4WC_KzLxf8ornqq\u0026q=85\u0026s=2573a53b5aea961e18c82b3af8f31925"},"favicon":"https://mintcdn.com/onesignal/SGduBFHpiRdg5l6h/favicon.ico?fit=max\u0026auto=format\u0026n=SGduBFHpiRdg5l6h\u0026q=85\u0026s=c0a99fadc0553c658a83741c5611cef4","api":{"examples":{"languages":["curl","typescript","python","php","go","ruby","java","csharp","rust"],"autogenerate":true}},"navbar":{"links":[{"href":"mailto:support@onesignal.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.onesignal.com"}},"footer":{"socials":{"github":"https://github.com/OneSignal","linkedin":"https://linkedin.com/company/onesignal","youtube":"https://www.youtube.com/@onesignalofficial/playlists"}},"seo":{"metatags":{"apple-mobile-web-app-title":"OneSignal Docs"}},"fonts":{"family":"Nunito Sans"},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"ga4":{"measurementId":"G-2DGWL0VYP5"},"posthog":{"apiKey":"phc_vZpvE0f5eyzcOt30FHer34yddVmNdo9kmlMVRBzLMtn","apiHost":"https://eu.i.posthog.com","sessionRecording":true}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"languages":[{"language":"en","href":"docs/en/home"},{"language":"cn","href":"docs/cn/home"},{"language":"ko","href":"docs/ko/home"},{"language":"ja","href":"docs/ja/home"},{"language":"tr","href":"docs/tr/home"},{"language":"pt-BR","href":"docs/pt-BR/home"},{"language":"es","href":"docs/es/home"},{"language":"fr","href":"docs/fr/home"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onesignal","hasAudioNarration":false,"actualSubdomain":"onesignal","customDomains":["documentation.onesignal.com"],"gitSource":{"type":"github","owner":"onesignal","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af4cdb2d820fd504cae19ee","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"en","tag":"User Guides","count":204},{"language":"es","tag":"Guías del Usuario","count":178},{"language":"fr","tag":"Guides utilisateur","count":178},{"language":"ja","tag":"ユーザーガイド","count":178},{"language":"ko","tag":"사용자 가이드","count":178},{"language":"pt-BR","tag":"Guia do Usuário","count":178},{"language":"tr","tag":"Kullanıcı Kılavuzları","count":178},{"language":"cn","tag":"用户指南","count":176},{"language":"en","tag":"Message channels","count":90},{"language":"es","tag":"Canales de mensajería","count":84},{"language":"fr","tag":"Canaux de messagerie","count":84},{"language":"ja","tag":"メッセージングチャネル","count":84},{"language":"ko","tag":"메시지 채널","count":84},{"language":"pt-BR","tag":"Canais de mensagem","count":84},{"language":"tr","tag":"Mesaj kanalları","count":84},{"language":"cn","tag":"消息渠道","count":83},{"language":"default","tag":"API Reference","count":68},{"language":"default","tag":"API reference","count":64},{"language":"en","tag":"Analytics \u0026 Integrations","count":53},{"language":"es","tag":"Analítica \u0026 Integraciones","count":52},{"language":"fr","tag":"Analyses et intégrations","count":52},{"language":"ja","tag":"分析 \u0026 統合","count":52},{"language":"ko","tag":"분석 \u0026 통합","count":52},{"language":"pt-BR","tag":"Análises \u0026 Integrações","count":52},{"language":"tr","tag":"Analitik ve Entegrasyonlar","count":52},{"language":"cn","tag":"分析和集成","count":51},{"language":"cn","tag":"开发者指南","count":48},{"language":"es","tag":"Guías del desarrollador","count":48},{"language":"fr","tag":"Guides développeur","count":48},{"language":"ja","tag":"開発者ガイド","count":48},{"language":"ko","tag":"개발자 가이드","count":48},{"language":"tr","tag":"Geliştirici Kılavuzları","count":48},{"language":"en","tag":"Developer Guides","count":47},{"language":"pt-BR","tag":"Guia de desenvolvedor","count":47},{"language":"en","tag":"Integrations","count":37},{"language":"es","tag":"Integraciones","count":37},{"language":"fr","tag":"Intégrations","count":37},{"language":"ja","tag":"統合","count":37},{"language":"ko","tag":"통합","count":37},{"language":"pt-BR","tag":"Integrações","count":37},{"language":"tr","tag":"Entegrasyonlar","count":37},{"language":"cn","tag":"集成","count":36},{"language":"en","tag":"Tutorials","count":35},{"language":"cn","tag":"推送通知","count":31},{"language":"cn","tag":"OneSignal 作为目的地","count":31},{"language":"en","tag":"Push","count":31},{"language":"en","tag":"OneSignal as destination","count":31},{"language":"es","tag":"Push notificaciones","count":31},{"language":"es","tag":"OneSignal como destino","count":31},{"language":"fr","tag":"Push","count":31},{"language":"fr","tag":"OneSignal comme destination","count":31},{"language":"ja","tag":"プッシュ通知","count":31},{"language":"ja","tag":"OneSignal as 宛先","count":31},{"language":"ko","tag":"푸시","count":31},{"language":"ko","tag":"OneSignal을 데이터 목적지로 사용","count":31},{"language":"pt-BR","tag":"Push notificações","count":31},{"language":"pt-BR","tag":"OneSignal como destino","count":31},{"language":"tr","tag":"Anlık bildirimler","count":31},{"language":"tr","tag":"OneSignal hedef","count":31},{"language":"en","tag":"Mobile SDKs","count":26},{"language":"cn","tag":"移动SDK","count":25},{"language":"es","tag":"SDKs móviles","count":25},{"language":"fr","tag":"SDK mobiles","count":25},{"language":"ja","tag":"モバイルSDK","count":25},{"language":"ko","tag":"모바일 SDKs","count":25},{"language":"pt-BR","tag":"SDKs móveis","count":25},{"language":"tr","tag":"Mobil SDK'lar","count":25},{"language":"cn","tag":"教程","count":24},{"language":"es","tag":"Tutoriales","count":24},{"language":"fr","tag":"Tutoriels","count":24},{"language":"ja","tag":"チュートリアル","count":24},{"language":"ko","tag":"튜토리얼","count":24},{"language":"pt-BR","tag":"Tutoriais","count":24},{"language":"tr","tag":"Eğitimler","count":24},{"language":"en","tag":"Mobile SDK setup","count":19},{"language":"cn","tag":"移动SDK设置","count":18},{"language":"es","tag":"Configuración del SDK móvil","count":18},{"language":"fr","tag":"Configuration SDK mobile","count":18},{"language":"ja","tag":"モバイルSDKセットアップ","count":18},{"language":"ko","tag":"모바일 SDK 설정","count":18},{"language":"pt-BR","tag":"Configuração do SDK móvel","count":18},{"language":"tr","tag":"Mobil SDK kurulumu","count":18},{"language":"default","tag":"Messages","count":9},{"language":"default","tag":"Users","count":9},{"language":"default","tag":"Organization","count":9},{"language":"default","tag":"Journeys","count":8},{"language":"default","tag":"Deprecated","count":6},{"language":"default","tag":"Templates","count":6},{"language":"default","tag":"Subscriptions","count":6},{"language":"default","tag":"Segments","count":5}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@onesignal.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"docs/ko/hubspot","slug":"/docs/ko/hubspot","pageMetadata":{"title":"HubSpot","description":"네이티브 OneSignal 통합을 사용하여 HubSpot 워크플로에서 푸시 알림, 이메일, SMS 및 인앱 메시지를 자동화합니다.","keywords":["hubspot","통합","crm","자동화","워크플로","푸시 알림","이메일","sms","태그","등록 트리거","워크플로 패턴","문제 해결"],"href":"/docs/ko/hubspot"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"네이티브 OneSignal 통합을 사용하여 HubSpot 워크플로에서 푸시 알림, 이메일, SMS 및 인앱 메시지를 자동화합니다.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Card,CodeBlock,Columns,Frame,Heading,Info,Note,OptimizedFrame,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedFrame)_missingMdxReference(`OptimizedFrame`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`개요`,children:`개요`}),`\n`,_jsx(_components.p,{children:`OneSignal HubSpot 통합은 네이티브 워크플로 액션을 통해 HubSpot CRM을 OneSignal에 연결합니다 — 타사 미들웨어가 필요하지 않습니다. 다음을 수행할 수 있습니다:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`메시지 보내기`}),` — HubSpot 워크플로에서 푸시 알림, 이메일, SMS 트리거`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`사용자 생성`}),` — 이메일 및 SMS 구독과 함께 HubSpot 연락처를 OneSignal에 동기화`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`태그 관리`}),` — HubSpot 연락처 속성에 따라 OneSignal `,_jsx(_components.a,{href:`/docs/ko/add-user-data-tags`,children:`태그`}),` 설정 또는 삭제`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`인앱 메시지 타겟팅`}),` — HubSpot이 설정한 태그를 사용하여 인앱 메시지 전달을 제어하는 세그먼트 구축`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`A/B 테스트, 인텔리전트 전달, 스로틀링, 리타겟팅과 같은 기능은 HubSpot과 함께 OneSignal 대시보드 또는 API를 직접 사용하세요.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`실제 사례는 `,_jsx(_components.a,{href:`https://onesignal.com/blog/four-ways-to-use-the-onesignal-integration-with-hubspot-to-boost-engagement-across-channels/`,children:`HubSpot과 OneSignal 통합을 사용하여 채널 전반의 참여를 높이는 4가지 방법`}),`을 읽어보세요.`]})}),`\n`,_jsx(Frame,{children:_jsx(OptimizedFrame,{width:`560`,height:`315`,src:`https://www.youtube.com/embed/SiGsvdAD6w8?si=8_WPdcNV2COIpaGM`,title:`OneSignal HubSpot integration overview`,frameborder:`0`,allow:`accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share`,referrerpolicy:`strict-origin-when-cross-origin`,allowfullscreen:true})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`사전-요구-사항`,children:`사전 요구 사항`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`HubSpot 슈퍼 관리자 역할 또는 `,_jsx(_components.a,{href:`https://knowledge.hubspot.com/settings/hubspot-user-permissions-guide#admin`,children:`앱 마켓플레이스 권한`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`https://onesignal.com/pricing`,children:`유료 OneSignal 플랜`}),` (무료 플랜에서는 사용 불가)`]}),`\n`]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`HubSpot은 2024년 12월에 원래의 타사 OneSignal 앱을 더 이상 지원하지 않습니다. OneSignal은 현재 확장된 기능을 갖춘 자체 HubSpot 앱을 제공합니다. 이전 통합을 사용했다면 아래의 마이그레이션 단계를 참조하세요.`})}),`\n`,_jsxs(Accordion,{title:`레거시 HubSpot 통합에서 마이그레이션`,id:`hubspot`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`새 통합 설치`})}),_jsxs(_components.p,{children:[`아래의 `,_jsx(_components.a,{href:`#connect-hubspot-to-onesignal`,children:`HubSpot을 OneSignal에 연결`}),` 섹션에 설명된 대로 OneSignal 대시보드의 `,_jsx(_components.strong,{children:`데이터 > 통합`}),`에서 HubSpot 통합을 활성화합니다.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`워크플로 마이그레이션`})}),_jsx(_components.p,{children:`기존 워크플로의 액션을 교체하기 전에 새 통합을 테스트하기 위한 새 워크플로를 만드는 것을 권장합니다.`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`워크플로 복제`}),` — HubSpot `,_jsx(_components.strong,{children:`워크플로`}),` 페이지에서 기존 워크플로 옆의 `,_jsx(_components.strong,{children:`복제`}),`를 클릭합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`트리거 제거`}),` — 복제된 워크플로에서 게시 시 자동으로 실행되지 않도록 모든 등록 트리거를 제거합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`레거시 액션 교체`}),` — 각 레거시 OneSignal 액션을 제거하고 새 버전으로 교체합니다. 두 앱이 모두 설치된 경우 레거시 앱에는 “Built by HubSpot”이 표시됩니다 — 표시되지 않는 것을 사용하세요.`]}),`\n`]}),_jsx(Frame,{caption:`두 앱이 모두 설치된 경우 'Built by HubSpot'이라고 표시되지 않는 OneSignal 액션을 사용하세요.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a4e1a11d8c343bee5850147e5809d4c94c9966248433ab0ba59e5dce79a5a8b2-image.png?fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=9563ae1d3706dfdbe7f89b4f432a4ae7`,\"data-og-width\":`920`,width:`920`,\"data-og-height\":`1166`,height:`1166`,\"data-path\":`images/docs/a4e1a11d8c343bee5850147e5809d4c94c9966248433ab0ba59e5dce79a5a8b2-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a4e1a11d8c343bee5850147e5809d4c94c9966248433ab0ba59e5dce79a5a8b2-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=de0a97d20fcb30b9fe6a9161aec9c101 280w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a4e1a11d8c343bee5850147e5809d4c94c9966248433ab0ba59e5dce79a5a8b2-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=4e568c1d30f204607900ce7182835862 560w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a4e1a11d8c343bee5850147e5809d4c94c9966248433ab0ba59e5dce79a5a8b2-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=e207bcd618612f90f965d050939d03ff 840w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a4e1a11d8c343bee5850147e5809d4c94c9966248433ab0ba59e5dce79a5a8b2-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=633f1fd54725c85556a6df8c71671b94 1100w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a4e1a11d8c343bee5850147e5809d4c94c9966248433ab0ba59e5dce79a5a8b2-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=4e06ffe16d970884bfbd33d6d7124a3c 1650w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a4e1a11d8c343bee5850147e5809d4c94c9966248433ab0ba59e5dce79a5a8b2-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=5eee15cfaae08c5c094a44413375107a 2500w`})}),_jsxs(_components.ol,{start:`4`,children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`단일 연락처로 테스트`}),` — 워크플로를 저장하고 게시한 다음 테스트 연락처 하나를 수동으로 등록합니다. 등록 기록을 확인하여 액션이 성공적으로 완료되었는지 확인합니다.`]}),`\n`]}),_jsx(Frame,{caption:`마이그레이션된 HubSpot 워크플로 예시.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/687f1408480774304c930f72d62a82381c1ea11a9c66a8ce6595f568a3dd3b17-image.png?fit=max\u0026auto=format\u0026n=MUgio66t0sYhGEvj\u0026q=85\u0026s=e963ea94239c19696851e6edc4f18c92`,\"data-og-width\":`1482`,width:`1482`,\"data-og-height\":`487`,height:`487`,\"data-path\":`images/docs/687f1408480774304c930f72d62a82381c1ea11a9c66a8ce6595f568a3dd3b17-image.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/687f1408480774304c930f72d62a82381c1ea11a9c66a8ce6595f568a3dd3b17-image.png?w=280\u0026fit=max\u0026auto=format\u0026n=MUgio66t0sYhGEvj\u0026q=85\u0026s=de943332580bb4b49966773a91c90872 280w, https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/687f1408480774304c930f72d62a82381c1ea11a9c66a8ce6595f568a3dd3b17-image.png?w=560\u0026fit=max\u0026auto=format\u0026n=MUgio66t0sYhGEvj\u0026q=85\u0026s=a85affb2a49e785ae4ab2cd48d75ab1a 560w, https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/687f1408480774304c930f72d62a82381c1ea11a9c66a8ce6595f568a3dd3b17-image.png?w=840\u0026fit=max\u0026auto=format\u0026n=MUgio66t0sYhGEvj\u0026q=85\u0026s=0efcaefbeb488003f5b0cbd8bf3cd5cb 840w, https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/687f1408480774304c930f72d62a82381c1ea11a9c66a8ce6595f568a3dd3b17-image.png?w=1100\u0026fit=max\u0026auto=format\u0026n=MUgio66t0sYhGEvj\u0026q=85\u0026s=c5b00a0a9f7a6bcb48192b99e62d3d1b 1100w, https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/687f1408480774304c930f72d62a82381c1ea11a9c66a8ce6595f568a3dd3b17-image.png?w=1650\u0026fit=max\u0026auto=format\u0026n=MUgio66t0sYhGEvj\u0026q=85\u0026s=915be6d82394ea60a17b5bc97c04e464 1650w, https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/687f1408480774304c930f72d62a82381c1ea11a9c66a8ce6595f568a3dd3b17-image.png?w=2500\u0026fit=max\u0026auto=format\u0026n=MUgio66t0sYhGEvj\u0026q=85\u0026s=ccc4b184ae3c8c2dad46cd7a967b8e47 2500w`})}),_jsxs(_components.ol,{start:`5`,children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`교체 또는 업데이트`}),` — 워크플로가 올바르게 작동하는 것을 확인한 후 원래 워크플로를 복제본으로 교체하거나 원래 워크플로에 동일한 변경 사항을 적용합니다.`]}),`\n`]}),_jsxs(_components.p,{children:[`마이그레이션 중 오류가 발생하면 `,_jsx(_components.code,{children:`support@onesignal.com`}),`으로 문의하세요.`]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`hubspot을-onesignal에-연결`,children:`HubSpot을 OneSignal에 연결`}),`\n`,_jsx(Heading,{level:`3`,id:`통합-활성화`,children:`통합 활성화`}),`\n`,_jsxs(_components.p,{children:[`OneSignal에서 `,_jsx(_components.strong,{children:`데이터 > 통합 > 카탈로그`}),`로 이동하여 `,_jsx(_components.strong,{children:`HubSpot`}),`을 선택합니다.`]}),`\n`,_jsx(Frame,{caption:`OneSignal 통합 페이지의 HubSpot 통합 카드.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/catalog-hubspot.png?fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=91266c81fdf4cea8962c73761cc0c374`,\"data-og-width\":`2902`,width:`2902`,\"data-og-height\":`1806`,height:`1806`,\"data-path\":`images/integrations/catalog-hubspot.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/catalog-hubspot.png?w=280\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=0321f8072497ce81e0ae2a971ebcd996 280w, https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/catalog-hubspot.png?w=560\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=8c9cf55ae765b1b80536aae67583af30 560w, https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/catalog-hubspot.png?w=840\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=48193a949eca6e02adf5e2c4404a2f16 840w, https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/catalog-hubspot.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=24dfd8eb987290d3fef3460de3331281 1100w, https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/catalog-hubspot.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=55df6e224643aeaf051babd041148742 1650w, https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/catalog-hubspot.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=fa31c51316751786db1dd024fa8e7860 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`설정 > 인증`}),`을 클릭한 다음 HubSpot 계정을 선택하고 로그인합니다.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`각 OneSignal 앱에 하나의 HubSpot 계정만 연결할 수 있습니다. 테스트 환경이 있는 경우 테스트용으로 다른 OneSignal 앱을 설정할 수 있습니다.`})}),`\n`,_jsx(Frame,{caption:`이 OneSignal 앱에 연결할 HubSpot 계정을 선택합니다.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/hubspot-settings.png?fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=7faf6812bc71b1fd629c963de34e9efb`,\"data-og-width\":`2902`,width:`2902`,\"data-og-height\":`1806`,height:`1806`,\"data-path\":`images/integrations/hubspot-settings.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/hubspot-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=924a13dc31b0f63129cba389e84c561d 280w, https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/hubspot-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=cc88784ce062c636202f243faf33cef1 560w, https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/hubspot-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=328f0a1f9e6d040d866250b45b26dcce 840w, https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/hubspot-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=d2e791fdc5c12c98937a59ce7c4fc6d3 1100w, https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/hubspot-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=ddec9cfc8827f3841ee96774e0e78d5d 1650w, https://mintcdn.com/onesignal/yCAJt5-6hubcDKe8/images/integrations/hubspot-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yCAJt5-6hubcDKe8\u0026q=85\u0026s=c324324e2b6a6767b9e6f242d2f0585a 2500w`})}),`\n`,_jsxs(_components.p,{children:[`약관에 동의하고 `,_jsx(_components.strong,{children:`앱 연결`}),`을 선택하면 OneSignal로 리디렉션됩니다. 새로 연결된 HubSpot 계정을 열어 연결을 확인합니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`외부-id로-사용자-매칭`,children:`외부 ID로 사용자 매칭`}),`\n`,_jsxs(_components.p,{children:[`HubSpot 연락처를 OneSignal 사용자에 연결하려면 OneSignal의 `,_jsx(_components.a,{href:`/docs/ko/users`,children:`외부 ID`}),`를 HubSpot의 고유 속성(예: 사용자 ID 또는 이메일 주소)과 일치하는 값으로 설정합니다.`]}),`\n`,_jsxs(_components.p,{children:[`앱 또는 웹사이트에서 SDK `,_jsx(_components.code,{children:`login`}),` 메서드를 사용하여 외부 ID를 설정합니다. 매칭이 안정적으로 이루어지도록 앱과 HubSpot 모두에서 쉽게 사용할 수 있는 속성을 선택하세요.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`ID 및 구독 관리에 대한 자세한 내용은 `,_jsx(_components.a,{href:`/docs/ko/users`,children:`사용자`}),` 및 `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`을 참조하세요.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot-워크플로-생성`,children:`HubSpot 워크플로 생성`}),`\n`,_jsxs(_components.p,{children:[`HubSpot에서 `,_jsx(_components.strong,{children:`자동화 > 워크플로`}),`로 이동하여 `,_jsx(_components.strong,{children:`워크플로 생성`}),`을 클릭합니다. `,_jsx(_components.strong,{children:`연락처 기반`}),`을 선택하고 등록 트리거를 구성합니다.`]}),`\n`,_jsx(_components.p,{children:`OneSignal 액션을 추가하려면 워크플로 편집기에서 **+**를 클릭하고 “OneSignal”을 검색합니다.`}),`\n`,_jsx(Frame,{caption:`HubSpot의 OneSignal 워크플로 액션.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7857e4e4ce869bb57dfbce033baf2239054ba81e207a81565a62fe5618fb373b-Screenshot_2025-01-23_at_1.16.10_PM.png?fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=ea5f0eb7187127a9f4fef2e338ac5a2c`,\"data-og-width\":`1866`,width:`1866`,\"data-og-height\":`1340`,height:`1340`,\"data-path\":`images/docs/7857e4e4ce869bb57dfbce033baf2239054ba81e207a81565a62fe5618fb373b-Screenshot_2025-01-23_at_1.16.10_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7857e4e4ce869bb57dfbce033baf2239054ba81e207a81565a62fe5618fb373b-Screenshot_2025-01-23_at_1.16.10_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=06e568886369d21a9a8b32969d413cd5 280w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7857e4e4ce869bb57dfbce033baf2239054ba81e207a81565a62fe5618fb373b-Screenshot_2025-01-23_at_1.16.10_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=6f0f95ef2905b0873bc3eb6da69b3f02 560w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7857e4e4ce869bb57dfbce033baf2239054ba81e207a81565a62fe5618fb373b-Screenshot_2025-01-23_at_1.16.10_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=d4bde8303aa7d7f8cf56bbe3a1d1797a 840w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7857e4e4ce869bb57dfbce033baf2239054ba81e207a81565a62fe5618fb373b-Screenshot_2025-01-23_at_1.16.10_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=b27f9030be6854d4300bc0c64f87a39b 1100w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7857e4e4ce869bb57dfbce033baf2239054ba81e207a81565a62fe5618fb373b-Screenshot_2025-01-23_at_1.16.10_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=6c3cd68bacfeace89a476b001d8c0e9e 1650w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7857e4e4ce869bb57dfbce033baf2239054ba81e207a81565a62fe5618fb373b-Screenshot_2025-01-23_at_1.16.10_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=a28baf540f0bf40d4d52cbb999010e47 2500w`})}),`\n`,_jsx(_components.p,{children:`모든 OneSignal 액션에는 두 개의 필드가 필요합니다:`}),`\n`,_jsx(Frame,{caption:`워크플로 액션에서 OneSignal 앱 및 외부 ID 설정.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a9f3c793693436c0f9ef5c421f600b21ae241310e672303cb2f95fb7f0f8d103-Screenshot_2025-01-31_at_1.40.32_PM.png?fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=162b4cc4654129a4c029d4f0fa5041b8`,\"data-og-width\":`828`,width:`828`,\"data-og-height\":`550`,height:`550`,\"data-path\":`images/docs/a9f3c793693436c0f9ef5c421f600b21ae241310e672303cb2f95fb7f0f8d103-Screenshot_2025-01-31_at_1.40.32_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a9f3c793693436c0f9ef5c421f600b21ae241310e672303cb2f95fb7f0f8d103-Screenshot_2025-01-31_at_1.40.32_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=a7f5e96b703d437c8b2f6bf55f3e6613 280w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a9f3c793693436c0f9ef5c421f600b21ae241310e672303cb2f95fb7f0f8d103-Screenshot_2025-01-31_at_1.40.32_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=ee1d55ee2e499f4cdfc9cebb1e59751c 560w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a9f3c793693436c0f9ef5c421f600b21ae241310e672303cb2f95fb7f0f8d103-Screenshot_2025-01-31_at_1.40.32_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=93f9363c300a72333bd8b7e0149d3e86 840w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a9f3c793693436c0f9ef5c421f600b21ae241310e672303cb2f95fb7f0f8d103-Screenshot_2025-01-31_at_1.40.32_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=04bc66b94cc793b9b25110fcf5d879b1 1100w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a9f3c793693436c0f9ef5c421f600b21ae241310e672303cb2f95fb7f0f8d103-Screenshot_2025-01-31_at_1.40.32_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=3e5045f9d415f5c1750e5ff22918aedc 1650w, https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a9f3c793693436c0f9ef5c421f600b21ae241310e672303cb2f95fb7f0f8d103-Screenshot_2025-01-31_at_1.40.32_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=RWtLFPeffHrC81wI\u0026q=85\u0026s=fb4b081d7078c1995be731a9933188b1 2500w`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`OneSignal 앱`}),` — 설정 중에 연결한 앱`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`외부 ID`}),` — OneSignal의 외부 ID와 일치하는 HubSpot 연락처 속성`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`onesignal-액션`,children:`OneSignal 액션`}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot에서-onesignal-사용자-생성`,children:`HubSpot에서 OneSignal 사용자 생성`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`사용자 생성`}),` 액션은 연락처가 워크플로를 통과할 때 OneSignal에 `,_jsx(_components.a,{href:`/docs/ko/users`,children:`사용자`}),`를 생성합니다. 새 연락처가 추가될 때 OneSignal과 HubSpot을 동기화하는 데 사용합니다.`]}),`\n`,_jsxs(_components.p,{children:[`다음 HubSpot 속성이 설정된 경우 OneSignal은 해당 `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`을 자동으로 생성합니다:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`이메일`}),` → OneSignal에 이메일 구독 생성`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`전화번호`}),` → OneSignal에 SMS 구독 생성`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`사용자 생성 노드 내에서 외부 ID와 태그를 설정할 수도 있습니다.`}),`\n`,_jsx(Frame,{caption:`HubSpot 워크플로의 OneSignal 사용자 생성 노드.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/544e379b13eab1fdddfdaf646a879152ea6251f1833870f5ed2671e0e2558506-Screenshot_2025-03-10_at_4.34.19_PM.png?fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=c12475968bf18c8353ef576882855d03`,\"data-og-width\":`1030`,width:`1030`,\"data-og-height\":`817`,height:`817`,\"data-path\":`images/docs/544e379b13eab1fdddfdaf646a879152ea6251f1833870f5ed2671e0e2558506-Screenshot_2025-03-10_at_4.34.19_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/544e379b13eab1fdddfdaf646a879152ea6251f1833870f5ed2671e0e2558506-Screenshot_2025-03-10_at_4.34.19_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=8610585eed983e47cc4d3b4a524325ec 280w, https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/544e379b13eab1fdddfdaf646a879152ea6251f1833870f5ed2671e0e2558506-Screenshot_2025-03-10_at_4.34.19_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=bfa4e3339b70482375be79d501e02b67 560w, https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/544e379b13eab1fdddfdaf646a879152ea6251f1833870f5ed2671e0e2558506-Screenshot_2025-03-10_at_4.34.19_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=5095547b5a8a0ba1f0c6c9da613fa649 840w, https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/544e379b13eab1fdddfdaf646a879152ea6251f1833870f5ed2671e0e2558506-Screenshot_2025-03-10_at_4.34.19_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=4394347d17b909f3cdfe50262d53ce99 1100w, https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/544e379b13eab1fdddfdaf646a879152ea6251f1833870f5ed2671e0e2558506-Screenshot_2025-03-10_at_4.34.19_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=5359c7bd89dda051950be125d5b77898 1650w, https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/544e379b13eab1fdddfdaf646a879152ea6251f1833870f5ed2671e0e2558506-Screenshot_2025-03-10_at_4.34.19_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jFWn5xzleD8du3j6\u0026q=85\u0026s=5d793006220c263533e18275d37b2ff1 2500w`})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`OneSignal 앱에 `,_jsx(_components.a,{href:`/docs/ko/sms-opt-in-and-collection#promotional-double-opt-in-form`,children:`더블 옵트인`}),`이 활성화된 경우 새 SMS 구독은 자동으로 옵트인 메시지를 받습니다. 사용자 생성 노드에서 이를 비활성화할 수 있습니다 — SMS 구독은 생성되지만 사용자가 별도로 옵트인할 때까지 구독되지 않습니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot에서-onesignal-태그-편집`,children:`HubSpot에서 OneSignal 태그 편집`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`태그 편집`}),` 액션은 매칭된 OneSignal 사용자의 `,_jsx(_components.a,{href:`/docs/ko/add-user-data-tags`,children:`태그`}),`를 설정하거나 삭제합니다. 태그는 `,_jsx(_components.a,{href:`/docs/ko/message-personalization`,children:`메시지 개인화`}),`와 `,_jsx(_components.a,{href:`/docs/ko/segmentation`,children:`세분화`}),`를 가능하게 하며, `,_jsx(_components.a,{href:`#send-in-app-messages-with-hubspot`,children:`HubSpot에서 인앱 메시지를 타겟팅`}),`하는 메커니즘입니다.`]}),`\n`,_jsx(Heading,{level:`4`,id:`태그-설정`,children:`태그 설정`}),`\n`,_jsx(_components.p,{children:`태그 필드에 JSON 객체를 입력합니다:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"welcome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cFirst Name property>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`워크플로 편집기에서 HubSpot의 속성 토큰 삽입기를 사용하여 HubSpot 연락처 속성을 태그 값으로 삽입할 수 있습니다. 예를 들어, OneSignal에서 메시지를 개인화하기 위해 사용자의 이름을 태그로 추가하는 경우.`}),`\n`,_jsx(Heading,{level:`4`,id:`태그-삭제`,children:`태그 삭제`}),`\n`,_jsx(_components.p,{children:`태그를 제거하려면 값을 빈 문자열로 설정합니다:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"old_tag\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`태그가 사용자에게 존재하지 않으면 무시됩니다.`}),`\n`,_jsx(Frame,{caption:`태그 편집 액션에서 두 개의 태그('welcome'과 'name')를 설정하고 하나('key')를 삭제.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/bb4ff8e3b5c8bf3742d721f94791f2e97137b89f58f3e862ff650b2c58d1e43a-Screenshot_2025-01-23_at_1.46.35_PM.png?fit=max\u0026auto=format\u0026n=56ctKxZSV4m5VEkn\u0026q=85\u0026s=6df8727cc9c5dd212c0c4ac62aeae71a`,\"data-og-width\":`1866`,width:`1866`,\"data-og-height\":`1340`,height:`1340`,\"data-path\":`images/docs/bb4ff8e3b5c8bf3742d721f94791f2e97137b89f58f3e862ff650b2c58d1e43a-Screenshot_2025-01-23_at_1.46.35_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/bb4ff8e3b5c8bf3742d721f94791f2e97137b89f58f3e862ff650b2c58d1e43a-Screenshot_2025-01-23_at_1.46.35_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=56ctKxZSV4m5VEkn\u0026q=85\u0026s=d42df161e35a591af1fc38b09ddfe51b 280w, https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/bb4ff8e3b5c8bf3742d721f94791f2e97137b89f58f3e862ff650b2c58d1e43a-Screenshot_2025-01-23_at_1.46.35_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=56ctKxZSV4m5VEkn\u0026q=85\u0026s=68f0b7213b98247a38ebd9e2f68f3611 560w, https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/bb4ff8e3b5c8bf3742d721f94791f2e97137b89f58f3e862ff650b2c58d1e43a-Screenshot_2025-01-23_at_1.46.35_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=56ctKxZSV4m5VEkn\u0026q=85\u0026s=9332ebd9c3c9a47f1c71edd22fcb5a19 840w, https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/bb4ff8e3b5c8bf3742d721f94791f2e97137b89f58f3e862ff650b2c58d1e43a-Screenshot_2025-01-23_at_1.46.35_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=56ctKxZSV4m5VEkn\u0026q=85\u0026s=7bd976b39f5abb69ee4cbe6339f7768d 1100w, https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/bb4ff8e3b5c8bf3742d721f94791f2e97137b89f58f3e862ff650b2c58d1e43a-Screenshot_2025-01-23_at_1.46.35_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=56ctKxZSV4m5VEkn\u0026q=85\u0026s=bf579eab6e1435bd91aaa320e5d321dc 1650w, https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/bb4ff8e3b5c8bf3742d721f94791f2e97137b89f58f3e862ff650b2c58d1e43a-Screenshot_2025-01-23_at_1.46.35_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=56ctKxZSV4m5VEkn\u0026q=85\u0026s=ca0d863af027eb5fb44fd3072eb1a43d 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot-워크플로에서-메시지-보내기`,children:`HubSpot 워크플로에서 메시지 보내기`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`알림 보내기`}),` 액션은 매칭된 OneSignal 사용자에게 푸시 알림, 이메일 또는 SMS를 전달합니다.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`이메일이 아닌 `,_jsx(_components.strong,{children:`OneSignal 외부 ID`}),`로 사용자를 매칭하세요. 이메일 매칭은 `,_jsx(_components.code,{children:`addEmail`}),` SDK 메서드를 사용하여 이메일을 설정한 고객을 위한 레거시 옵션입니다.`]})}),`\n`,_jsx(Frame,{caption:`OneSignal 알림 보내기 액션 구성.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c240529d9ab770443b90a8eb61db498edde6fdacc2c4a8efc8e1eb6c26582955-Screenshot_2025-01-23_at_2.19.19_PM.png?fit=max\u0026auto=format\u0026n=9_Q1FZLh6C0BFLq-\u0026q=85\u0026s=bf5975fd590611d5aedc7f297d4262d2`,\"data-og-width\":`1866`,width:`1866`,\"data-og-height\":`1340`,height:`1340`,\"data-path\":`images/docs/c240529d9ab770443b90a8eb61db498edde6fdacc2c4a8efc8e1eb6c26582955-Screenshot_2025-01-23_at_2.19.19_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c240529d9ab770443b90a8eb61db498edde6fdacc2c4a8efc8e1eb6c26582955-Screenshot_2025-01-23_at_2.19.19_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=9_Q1FZLh6C0BFLq-\u0026q=85\u0026s=f8761b3abbc468092bcf1272a075fb17 280w, https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c240529d9ab770443b90a8eb61db498edde6fdacc2c4a8efc8e1eb6c26582955-Screenshot_2025-01-23_at_2.19.19_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=9_Q1FZLh6C0BFLq-\u0026q=85\u0026s=5822efd3af2987724c55226301f1201f 560w, https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c240529d9ab770443b90a8eb61db498edde6fdacc2c4a8efc8e1eb6c26582955-Screenshot_2025-01-23_at_2.19.19_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=9_Q1FZLh6C0BFLq-\u0026q=85\u0026s=a03283d8b813443c7470d6229b71922f 840w, https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c240529d9ab770443b90a8eb61db498edde6fdacc2c4a8efc8e1eb6c26582955-Screenshot_2025-01-23_at_2.19.19_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=9_Q1FZLh6C0BFLq-\u0026q=85\u0026s=2ae17ac69e0c3892e29b7d3698502aa0 1100w, https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c240529d9ab770443b90a8eb61db498edde6fdacc2c4a8efc8e1eb6c26582955-Screenshot_2025-01-23_at_2.19.19_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=9_Q1FZLh6C0BFLq-\u0026q=85\u0026s=156c0edecb47180c3ec20693af2b6e39 1650w, https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c240529d9ab770443b90a8eb61db498edde6fdacc2c4a8efc8e1eb6c26582955-Screenshot_2025-01-23_at_2.19.19_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=9_Q1FZLh6C0BFLq-\u0026q=85\u0026s=6a44a1f4bde3e918a7d2ac38859e832c 2500w`})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`템플릿 사용`})}),`\n`,_jsxs(_components.p,{children:[`OneSignal 대시보드 또는 API에서 생성된 사전 정의된 `,_jsx(_components.a,{href:`/docs/ko/templates`,children:`템플릿`}),`을 선택합니다. 템플릿은 푸시 알림, 이메일, SMS를 지원합니다.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`양식 필드 사용`})}),`\n`,_jsx(_components.p,{children:`템플릿을 선택하지 않으면 제목, 부제목, 메시지, 이미지 URL, 실행 URL 필드를 사용하여 워크플로 액션에서 직접 푸시 알림을 작성할 수 있습니다. 이메일과 SMS는 템플릿을 통해서만 사용 가능합니다.`}),`\n`,_jsxs(_components.p,{children:[`양식 필드 옵션을 사용하면 HubSpot 연락처 속성(예: `,_jsx(_components.code,{children:`이름`}),`)을 삽입하여 알림 콘텐츠를 개인화할 수 있습니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`4`,id:`hubspot으로-인앱-메시지-보내기`,children:`HubSpot으로 인앱 메시지 보내기`}),`\n`,_jsx(_components.p,{children:`인앱 메시지는 HubSpot 워크플로에서 직접 보낼 수 없습니다. 대신 HubSpot을 사용하여 사용자에게 태그를 지정하고 OneSignal에서 세그먼트 기반 인앱 메시지로 해당 사용자를 타겟팅합니다.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`HubSpot에서 사용자에게 태그 지정`,children:_jsxs(_components.p,{children:[`HubSpot 워크플로에서 `,_jsx(_components.a,{href:`#edit-onesignal-tags-from-hubspot`,children:`태그 편집`}),` 액션을 사용하여 연락처에 태그를 설정합니다. 예: `,_jsx(_components.code,{children:`{ \"hubspot_campaign\": \"spring_promo\" }`}),`.`]})}),_jsx(Step,{title:`OneSignal에서 세그먼트 생성`,children:_jsxs(_components.p,{children:[`OneSignal 대시보드에서 `,_jsx(_components.strong,{children:`오디언스 > 세그먼트`}),`로 이동하여 `,_jsx(_components.strong,{children:`새 세그먼트`}),`를 클릭합니다. HubSpot이 설정한 태그 키와 값과 일치하는 `,_jsx(_components.strong,{children:`사용자 태그`}),` 필터를 추가합니다(예: `,_jsx(_components.code,{children:`hubspot_campaign`}),`이 `,_jsx(_components.code,{children:`spring_promo`}),`).`]})}),_jsxs(Step,{title:`인앱 메시지 생성`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`메시지 > 인앱`}),`으로 이동하여 새 인앱 메시지를 생성합니다. `,_jsx(_components.strong,{children:`오디언스`}),`에서 `,_jsx(_components.strong,{children:`특정 세그먼트에 표시`}),`를 선택하고 생성한 세그먼트를 선택합니다.`]}),_jsx(_components.p,{children:`사용자가 HubSpot 워크플로를 통과하여 태그를 받으면 즉시 세그먼트에 추가됩니다.`})]}),_jsxs(Step,{title:`트리거 구성`,children:[_jsx(_components.p,{children:`태그만으로는 인앱 메시지가 트리거되지 않습니다. 사용자가 앱을 적극적으로 사용 중일 때 태그가 설정된 경우 다음 세션까지 인앱 메시지가 표시되지 않습니다(앱이 30초 이상 백그라운드에 있으면 새 세션이 시작됩니다).`}),_jsx(_components.p,{children:`사용 가능한 트리거:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`앱 열기 시`}),` — 사용자가 다음에 앱을 열 때 표시`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`세션 시간`}),` — 세션 내 설정된 초 수 후 표시`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`마지막 인앱 메시지 이후 시간`}),` — 연속 메시지 방지`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`프로그래밍 방식`}),` — OneSignal SDK를 사용하여 앱 코드에서 트리거`]}),`\n`]}),_jsxs(_components.p,{children:[`AND/OR 연산자로 트리거를 결합하는 방법은 `,_jsx(_components.a,{href:`/docs/ko/iam-triggers`,children:`인앱 메시지 트리거`}),`를 참조하세요.`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`일반적인-워크플로-패턴`,children:`일반적인 워크플로 패턴`}),`\n`,_jsxs(_components.p,{children:[`HubSpot 워크플로는 `,_jsx(_components.strong,{children:`등록 트리거`}),`(워크플로를 시작하는 이벤트)와 `,_jsx(_components.strong,{children:`OneSignal 액션`}),`(OneSignal에서 사용자에게 일어나는 일)을 결합합니다. 아래는 일반적인 사용 사례에 대한 권장 패턴입니다.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`아래의 모든 워크플로 패턴은 이미 `,_jsx(_components.a,{href:`#connect-hubspot-to-onesignal`,children:`HubSpot을 OneSignal에 연결`}),`했고 `,_jsx(_components.a,{href:`#match-users-with-external-id`,children:`외부 ID를 통해 사용자를 매칭`}),`하고 있다고 가정합니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`환영-및-온보딩`,children:`환영 및 온보딩`}),`\n`,_jsx(_components.p,{children:`새 사용자가 가입할 때 환영 메시지를 보내고 온보딩 인앱 메시지를 위해 태그를 지정합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`단계`}),_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`구성`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`등록 트리거`})}),_jsx(_components.td,{children:`HubSpot`}),_jsxs(_components.td,{children:[`연락처 속성 `,_jsx(_components.code,{children:`고객이 된 날짜`}),`가 알려진 경우`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`액션 1`})}),_jsx(_components.td,{children:`OneSignal: 사용자 생성`}),_jsx(_components.td,{children:`외부 ID를 앱과 일치하는 HubSpot 연락처 속성(예: 사용자 ID 또는 이메일 주소)으로 설정`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`액션 2`})}),_jsx(_components.td,{children:`OneSignal: 태그 편집`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`{ \"onboarding\": \"active\", \"name\": \"\u003cFirst Name>\" }`}),` — 이름 값에 HubSpot 이름 속성 토큰 삽입`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`액션 3`})}),_jsx(_components.td,{children:`OneSignal: 알림 보내기`}),_jsx(_components.td,{children:`환영 푸시 템플릿 사용 또는 개인화된 인사말로 인라인 작성`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`새 사용자를 첫 실행 시 앱에서 안내하는 `,_jsx(_components.code,{children:`onboarding`}),` = `,_jsx(_components.code,{children:`active`}),` 세그먼트를 타겟팅하는 `,_jsx(_components.a,{href:`#send-in-app-messages-with-hubspot`,children:`인앱 메시지`}),`와 결합하세요.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`재참여`,children:`재참여`}),`\n`,_jsx(_components.p,{children:`최근 앱을 방문하지 않은 사용자에게 연락합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`단계`}),_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`구성`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`등록 트리거`})}),_jsx(_components.td,{children:`HubSpot`}),_jsxs(_components.td,{children:[`연락처 속성 `,_jsx(_components.code,{children:`마지막 활동 날짜`}),`가 14일 이상 전`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`액션 1`})}),_jsx(_components.td,{children:`OneSignal: 알림 보내기`}),_jsx(_components.td,{children:`재참여 푸시 템플릿 사용(예: “보고싶었습니다 — 새로운 소식이 있어요”)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`지연`})}),_jsx(_components.td,{children:`HubSpot: 3일 대기`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`If/then 분기`})}),_jsx(_components.td,{children:`HubSpot`}),_jsx(_components.td,{children:`연락처가 등록 후 사이트를 방문했는지 확인`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`예 분기`})}),_jsx(_components.td,{children:`OneSignal: 태그 편집`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"reengaged\": \"true\" }`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`아니오 분기`})}),_jsx(_components.td,{children:`OneSignal: 알림 보내기`}),_jsx(_components.td,{children:`더 강한 인센티브를 포함한 이메일 템플릿 사용`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`라이프사이클-단계-변경`,children:`라이프사이클 단계 변경`}),`\n`,_jsx(_components.p,{children:`HubSpot의 라이프사이클 단계 변경을 OneSignal 태그와 동기화하여 다양한 사용자 세그먼트를 타겟팅할 수 있습니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`단계`}),_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`구성`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`등록 트리거`})}),_jsx(_components.td,{children:`HubSpot`}),_jsxs(_components.td,{children:[`연락처 속성 `,_jsx(_components.code,{children:`라이프사이클 단계`}),`가 임의의 값으로 변경`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`액션 1`})}),_jsx(_components.td,{children:`OneSignal: 태그 편집`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`{ \"lifecycle_stage\": \"\u003cLifecycle Stage>\" }`}),` — 값에 HubSpot 라이프사이클 단계 속성 토큰 삽입`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`If/then 분기`})}),_jsx(_components.td,{children:`HubSpot`}),_jsxs(_components.td,{children:[`라이프사이클 단계 = `,_jsx(_components.code,{children:`고객`}),`인지 확인`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`예 분기`})}),_jsx(_components.td,{children:`OneSignal: 알림 보내기`}),_jsx(_components.td,{children:`”환영합니다” 푸시 또는 이메일 템플릿 사용`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`거래-성사-/-구매-후`,children:`거래 성사 / 구매 후`}),`\n`,_jsx(_components.p,{children:`거래 성사 후 감사 메시지를 트리거하고 업셀 캠페인을 위해 사용자에게 태그를 지정합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`단계`}),_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`구성`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`등록 트리거`})}),_jsx(_components.td,{children:`HubSpot`}),_jsxs(_components.td,{children:[`거래 속성 `,_jsx(_components.code,{children:`거래 단계`}),` = `,_jsx(_components.code,{children:`성사`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`액션 1`})}),_jsx(_components.td,{children:`OneSignal: 태그 편집`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`{ \"customer\": \"true\", \"deal_value\": \"\u003cAmount>\" }`}),` — 값에 HubSpot 거래 금액 속성 토큰 삽입`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`액션 2`})}),_jsx(_components.td,{children:`OneSignal: 알림 보내기`}),_jsx(_components.td,{children:`감사 이메일 템플릿 사용`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`지연`})}),_jsx(_components.td,{children:`HubSpot: 7일 대기`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`액션 3`})}),_jsx(_components.td,{children:`OneSignal: 알림 보내기`}),_jsx(_components.td,{children:`업셀/크로스셀 푸시 템플릿 사용`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`거래 기반 워크플로는 HubSpot에서 `,_jsx(_components.strong,{children:`거래 기반`}),` 워크플로 유형이 필요합니다. 관련 연락처의 외부 ID를 사용하여 OneSignal 사용자를 매칭합니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`인앱-메시지를-통한-프로모션-캠페인`,children:`인앱 메시지를 통한 프로모션 캠페인`}),`\n`,_jsx(_components.p,{children:`HubSpot 목록 또는 양식에 의해 트리거된 인앱 메시지로 특정 오디언스를 타겟팅합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`단계`}),_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`구성`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`등록 트리거`})}),_jsx(_components.td,{children:`HubSpot`}),_jsx(_components.td,{children:`연락처가 정적 또는 활성 목록(예: “봄 세일 대상자”)의 멤버가 됨`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`액션 1`})}),_jsx(_components.td,{children:`OneSignal: 태그 편집`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"promo\": \"spring_2025\" }`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`그런 다음 `,_jsx(_components.a,{href:`#send-in-app-messages-with-hubspot`,children:`HubSpot으로 인앱 메시지 보내기`}),` 단계를 따라 `,_jsx(_components.code,{children:`promo`}),` = `,_jsx(_components.code,{children:`spring_2025`}),`와 일치하는 OneSignal 세그먼트를 만들고 해당 세그먼트에 대한 인앱 메시지를 구성합니다.`]}),`\n`,_jsx(_components.p,{children:`캠페인이 끝난 후 사용자를 캠페인에서 제거하려면 태그를 삭제하는 두 번째 워크플로를 만듭니다:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`단계`}),_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`구성`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`등록 트리거`})}),_jsx(_components.td,{children:`HubSpot`}),_jsx(_components.td,{children:`날짜 기반, 캠페인 종료일로 설정`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`액션 1`})}),_jsx(_components.td,{children:`OneSignal: 태그 편집`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"promo\": \"\" }`})})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`문제-해결`,children:`문제 해결`}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot에서-워크플로-액션이-“실패”로-표시됨`,children:`HubSpot에서 워크플로 액션이 “실패”로 표시됨`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`오류 메시지 확인`}),` — HubSpot 워크플로 등록 기록에서 실패한 액션을 펼칩니다. 오류 메시지는 종종 원인을 나타냅니다(예: “사용자를 찾을 수 없음”, “잘못된 앱 ID”).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`외부 ID 확인`}),` — 외부 ID로 사용되는 HubSpot 연락처 속성이 OneSignal의 사용자와 일치하는지 확인합니다. `,_jsx(_components.strong,{children:`OneSignal > 오디언스 > 사용자`}),`에서 사용자 프로필을 확인하고 외부 ID로 검색합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`통합이 활성화되어 있는지 확인`}),` — `,_jsx(_components.strong,{children:`OneSignal > 데이터 > 통합 > HubSpot`}),`으로 이동하여 연결 상태가 활성 상태인지 확인합니다.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`메시지는-보냈지만-사용자가-받지-못함`,children:`메시지는 보냈지만 사용자가 받지 못함`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`구독 확인`}),` — 사용자는 보내는 채널(푸시, 이메일 또는 SMS)에 대한 활성 구독이 있어야 합니다. OneSignal의 사용자 프로필에서 `,_jsx(_components.strong,{children:`구독`}),`을 확인합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`세그먼트 멤버십 확인`}),` — 세그먼트 타겟팅이 있는 템플릿을 사용하는 경우 사용자가 타겟 세그먼트에 속하는지 확인합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`메시지 보고서 검토`}),` — OneSignal 대시보드에서 `,_jsx(_components.strong,{children:`메시지`}),`로 이동하여 메시지를 찾고 전달 보고서를 확인하여 메시지가 전달, 삭제 또는 오류가 발생했는지 확인합니다.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`onesignal-사용자에-태그가-나타나지-않음`,children:`OneSignal 사용자에 태그가 나타나지 않음`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`외부 ID 매칭 확인`}),` — 워크플로의 외부 ID가 기존 OneSignal 사용자와 일치하지 않으면 태그 편집 액션이 자동으로 실패합니다. 사용자가 존재하는지 확인하기 위해 태그 편집 전에 `,_jsx(_components.strong,{children:`사용자 생성`}),` 액션을 사용하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`JSON 형식 확인`}),` — 태그는 유효한 JSON 객체여야 합니다. 일반적인 실수로는 키나 값 주위에 따옴표가 없거나, 후행 쉼표가 있거나, 큰따옴표 대신 작은따옴표를 사용하는 것이 있습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`빈 값 확인`}),` — 태그 값을 `,_jsx(_components.code,{children:`\"\"`}),`로 설정하면 태그가 삭제됩니다. 삽입되는 HubSpot 연락처 속성이 비어 있지 않은지 확인합니다.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`인앱-메시지가-표시되지-않음`,children:`인앱 메시지가 표시되지 않음`}),`\n`,_jsxs(_components.p,{children:[`아래 FAQ의 `,_jsx(_components.a,{href:`#why-didnt-my-in-app-message-display-after-the-tag-was-set`,children:`태그가 설정된 후 인앱 메시지가 표시되지 않은 이유는?`}),`를 참조하세요.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot과-onesignal-간에-어떤-데이터가-공유됩니까`,children:`HubSpot과 OneSignal 간에 어떤 데이터가 공유됩니까?`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HubSpot`}),_jsx(_components.th,{children:`방향`}),_jsx(_components.th,{children:`OneSignal`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`연락처 속성`}),_jsx(_components.td,{children:`→`}),_jsx(_components.td,{children:`외부 ID, 태그`}),_jsxs(_components.td,{children:[`HubSpot 연락처 데이터는 `,_jsx(_components.a,{href:`/docs/ko/users`,children:`외부 ID`}),`와 `,_jsx(_components.a,{href:`/docs/ko/add-user-data-tags`,children:`태그`}),`를 통해 OneSignal 사용자를 매칭하고 강화합니다.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`워크플로`}),_jsx(_components.td,{children:`←`}),_jsx(_components.td,{children:`메시지 템플릿`}),_jsxs(_components.td,{children:[`OneSignal `,_jsx(_components.a,{href:`/docs/ko/templates`,children:`템플릿`}),`은 HubSpot 워크플로 액션에서 선택할 수 있습니다.`]})]})]})]}),`\n`,_jsx(_components.p,{children:`통합은 HubSpot 목록, 거래 또는 회사 레코드를 OneSignal에 자동으로 동기화하지 않습니다. 필요한 데이터를 명시적으로 전달하려면 워크플로 액션을 사용하세요.`}),`\n`,_jsx(Heading,{level:`3`,id:`외부-id가-onesignal-사용자와-일치하지-않으면-어떻게-됩니까`,children:`외부 ID가 OneSignal 사용자와 일치하지 않으면 어떻게 됩니까?`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`알림 보내기`}),`와 `,_jsx(_components.strong,{children:`태그 편집`}),` 액션은 자동으로 실패합니다 — 메시지가 보내지지 않고 태그도 설정되지 않습니다. 워크플로의 다른 OneSignal 액션 앞에 항상 `,_jsx(_components.strong,{children:`사용자 생성`}),` 액션을 배치하여 사용자가 OneSignal에 존재하는지 확인하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot-목록을-사용하여-onesignal-세그먼트를-타겟팅할-수-있습니까`,children:`HubSpot 목록을 사용하여 OneSignal 세그먼트를 타겟팅할 수 있습니까?`}),`\n`,_jsxs(_components.p,{children:[`직접은 불가능합니다. HubSpot 목록과 OneSignal 세그먼트는 독립적인 시스템입니다. 연결하려면 HubSpot 목록에서 연락처를 등록하는 워크플로를 만들고 `,_jsx(_components.strong,{children:`태그 편집`}),` 액션을 사용하여 태그를 설정합니다. 그런 다음 해당 태그를 기반으로 OneSignal 세그먼트를 구축합니다. 구체적인 예는 `,_jsx(_components.a,{href:`#promotional-campaign-via-in-app-message`,children:`인앱 메시지를 통한 프로모션 캠페인`}),`을 참조하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot에서-어떤-onesignal-채널을-보낼-수-있습니까`,children:`HubSpot에서 어떤 OneSignal 채널을 보낼 수 있습니까?`}),`\n`,_jsxs(_components.p,{children:[`푸시 알림은 템플릿 또는 양식 필드를 사용하여 보낼 수 있습니다. 이메일과 SMS는 OneSignal에서 만든 `,_jsx(_components.a,{href:`/docs/ko/templates`,children:`템플릿`}),`을 사용해서만 보낼 수 있습니다. 인앱 메시지는 HubSpot 워크플로에서 보낼 수 없습니다 — 대신 `,_jsx(_components.a,{href:`#send-in-app-messages-with-hubspot`,children:`태그 및 세그먼트 패턴`}),`을 사용하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`태그가-설정된-후-인앱-메시지가-표시되지-않은-이유는`,children:`태그가 설정된 후 인앱 메시지가 표시되지 않은 이유는?`}),`\n`,_jsxs(_components.p,{children:[`태그만으로는 인앱 메시지가 트리거되지 않습니다. 태그는 사용자를 세그먼트에 추가하지만 인앱 메시지를 표시하려면 여전히 `,_jsx(_components.strong,{children:`트리거`}),`가 필요합니다. 사용자가 앱을 적극적으로 사용 중일 때 태그가 설정된 경우 다음 세션(30초 이상 백그라운드)까지 표시되지 않습니다. 가장 안정적인 동작을 위해 인앱 메시지 트리거를 `,_jsx(_components.strong,{children:`앱 열기 시`}),`로 설정하세요. 모든 트리거 옵션은 `,_jsx(_components.a,{href:`/docs/ko/iam-triggers`,children:`인앱 메시지 트리거`}),`를 참조하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot-웹훅을-사용하여-onesignal-api를-직접-호출할-수-있습니까`,children:`HubSpot 웹훅을 사용하여 OneSignal API를 직접 호출할 수 있습니까?`}),`\n`,_jsxs(_components.p,{children:[`예. HubSpot의 `,_jsx(_components.strong,{children:`커스텀 코드`}),` 워크플로 액션을 사용하여 외부 API에 HTTP 요청을 만들 수 있습니다. `,_jsx(_components.a,{href:`/reference/create-notification`,children:`OneSignal REST API`}),`를 호출하여 네이티브 통합 외부에서 메시지 보내기, 사용자 생성, 태그 업데이트를 할 수 있습니다. 이는 네이티브 액션이 다루지 않는 사용 사례(개별 사용자가 아닌 세그먼트로 보내기 등)에 유용합니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`onesignal-메시지-이벤트를-hubspot으로-다시-보낼-수-있습니까`,children:`OneSignal 메시지 이벤트를 HubSpot으로 다시 보낼 수 있습니까?`}),`\n`,_jsxs(_components.p,{children:[`예. `,_jsx(_components.a,{href:`/docs/ko/event-streams`,children:`이벤트 스트림`}),`을 사용하여 OneSignal 메시지 이벤트(보낸, 클릭된 등)를 웹훅 엔드포인트로 내보낼 수 있습니다. 이러한 이벤트를 HubSpot의 `,_jsx(_components.a,{href:`https://developers.hubspot.com/docs/api/analytics/events`,children:`커스텀 이벤트 API`}),`로 라우팅하거나 미들웨어 서비스를 사용하여 OneSignal 참여 데이터를 기반으로 HubSpot 연락처 속성을 업데이트할 수 있습니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot에서-onesignal-저니를-트리거할-수-있습니까`,children:`HubSpot에서 OneSignal 저니를 트리거할 수 있습니까?`}),`\n`,_jsxs(_components.p,{children:[`HubSpot 사용자를 OneSignal `,_jsx(_components.a,{href:`/docs/ko/journeys-overview`,children:`저니`}),`에 넣는 방법은 두 가지입니다:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`태그`}),` — `,_jsx(_components.a,{href:`#edit-onesignal-tags-from-hubspot`,children:`태그 편집`}),` 액션을 사용하여 사용자에게 태그를 설정합니다. 해당 태그를 기반으로 OneSignal에서 세그먼트를 만들고 해당 세그먼트를 저니 진입 조건으로 사용합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`커스텀 이벤트`}),` — HubSpot의 `,_jsx(_components.strong,{children:`커스텀 코드`}),` 액션을 사용하여 `,_jsx(_components.a,{href:`/reference/create-custom-events`,children:`OneSignal 커스텀 이벤트 API`}),`를 호출합니다. 이는 저니 진입 트리거 역할을 할 수 있습니다.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`hubspot에서-onesignal로-커스텀-이벤트를-보낼-수-있습니까`,children:`HubSpot에서 OneSignal로 커스텀 이벤트를 보낼 수 있습니까?`}),`\n`,_jsxs(_components.p,{children:[`네이티브 워크플로 액션을 통해서는 불가능합니다. 네이티브 통합은 사용자 생성, 태그 편집, 알림 보내기를 지원합니다. 커스텀 이벤트를 보내려면 HubSpot의 `,_jsx(_components.strong,{children:`커스텀 코드`}),` 액션을 사용하여 `,_jsx(_components.a,{href:`/reference/create-custom-events`,children:`OneSignal 커스텀 이벤트 API`}),`를 직접 호출하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`어떤-hubspot-등록-트리거가-onesignal과-함께-작동합니까`,children:`어떤 HubSpot 등록 트리거가 OneSignal과 함께 작동합니까?`}),`\n`,_jsx(_components.p,{children:`모든 HubSpot 등록 트리거가 작동합니다 — OneSignal 액션은 연락처가 어떻게 등록되었는지에 관계없이 실행되는 표준 워크플로 액션입니다. 일반적인 트리거로는 다음이 있습니다:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`연락처 속성 변경`}),` (라이프사이클 단계, 리드 상태, 마지막 활동 날짜)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`양식 제출`}),` (가입 양식, 데모 요청, 이벤트 등록)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`목록 멤버십`}),` (정적 또는 활성 목록에 추가됨)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`거래 단계 변경`}),` (파이프라인 진행, 성사/실패)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`날짜 기반`}),` (예약된 캠페인, 이벤트 이후 시간)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`수동 등록`}),` (일회성 발송 또는 테스트용)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`라이브-전에-워크플로를-테스트하는-방법은`,children:`라이브 전에 워크플로를 테스트하는 방법은?`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`워크플로를 만들고 모든 자동 등록 트리거 제거`}),`\n`,_jsx(_components.li,{children:`워크플로 저장 및 게시`}),`\n`,_jsx(_components.li,{children:`단일 테스트 연락처 수동 등록`}),`\n`,_jsx(_components.li,{children:`HubSpot의 등록 기록에서 액션 성공/실패 확인`}),`\n`,_jsx(_components.li,{children:`OneSignal 대시보드에서 사용자, 태그 또는 메시지 확인`}),`\n`,_jsx(_components.li,{children:`확인 후 등록 트리거 추가 및 재게시`}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(Columns,{cols:3,children:[_jsx(Card,{title:`태그`,icon:`tag`,href:`/docs/ko/add-user-data-tags`,children:_jsx(_components.p,{children:`개인화 및 세분화를 위해 사용자에게 커스텀 속성을 추가합니다.`})}),_jsx(Card,{title:`템플릿`,icon:`file-lines`,href:`/docs/ko/templates`,children:_jsx(_components.p,{children:`푸시, 이메일, SMS용 재사용 가능한 메시지 템플릿을 만듭니다.`})}),_jsx(Card,{title:`저니`,icon:`route`,href:`/docs/ko/journeys-overview`,children:_jsx(_components.p,{children:`사용자 행동에 의해 트리거되는 자동화된 멀티채널 메시지 플로를 구축합니다.`})}),_jsx(Card,{title:`이벤트 스트림`,icon:`bolt`,href:`/docs/ko/event-streams`,children:_jsx(_components.p,{children:`웹훅을 통해 실시간 메시지 이벤트를 외부 플랫폼으로 내보냅니다.`})}),_jsx(Card,{title:`세분화`,icon:`users`,href:`/docs/ko/segmentation`,children:_jsx(_components.p,{children:`태그, 행동, 사용자 속성을 기반으로 오디언스 세그먼트를 구축합니다.`})}),_jsx(Card,{title:`인앱 메시지 트리거`,icon:`bell`,href:`/docs/ko/iam-triggers`,children:_jsx(_components.p,{children:`인앱 메시지가 사용자에게 표시되는 시기와 방법을 제어합니다.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"HubSpot","description":"네이티브 OneSignal 통합을 사용하여 HubSpot 워크플로에서 푸시 알림, 이메일, SMS 및 인앱 메시지를 자동화합니다.","keywords":["hubspot","통합","crm","자동화","워크플로","푸시 알림","이메일","sms","태그","등록 트리거","워크플로 패턴","문제 해결"],"href":"/docs/ko/hubspot"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"개요","slug":"개요","depth":2,"children":[]},{"title":"사전 요구 사항","slug":"사전-요구-사항","depth":2,"children":[]},{"title":"HubSpot을 OneSignal에 연결","slug":"hubspot을-onesignal에-연결","depth":2,"children":[{"title":"통합 활성화","slug":"통합-활성화","depth":3,"children":[]},{"title":"외부 ID로 사용자 매칭","slug":"외부-id로-사용자-매칭","depth":3,"children":[]},{"title":"HubSpot 워크플로 생성","slug":"hubspot-워크플로-생성","depth":3,"children":[]}]},{"title":"OneSignal 액션","slug":"onesignal-액션","depth":2,"children":[{"title":"HubSpot에서 OneSignal 사용자 생성","slug":"hubspot에서-onesignal-사용자-생성","depth":3,"children":[]},{"title":"HubSpot에서 OneSignal 태그 편집","slug":"hubspot에서-onesignal-태그-편집","depth":3,"children":[]},{"title":"태그 설정","slug":"태그-설정","depth":4,"children":[]},{"title":"태그 삭제","slug":"태그-삭제","depth":4,"children":[]},{"title":"HubSpot 워크플로에서 메시지 보내기","slug":"hubspot-워크플로에서-메시지-보내기","depth":3,"children":[]},{"title":"HubSpot으로 인앱 메시지 보내기","slug":"hubspot으로-인앱-메시지-보내기","depth":4,"children":[]}]},{"title":"일반적인 워크플로 패턴","slug":"일반적인-워크플로-패턴","depth":2,"children":[{"title":"환영 및 온보딩","slug":"환영-및-온보딩","depth":3,"children":[]},{"title":"재참여","slug":"재참여","depth":3,"children":[]},{"title":"라이프사이클 단계 변경","slug":"라이프사이클-단계-변경","depth":3,"children":[]},{"title":"거래 성사 / 구매 후","slug":"거래-성사-/-구매-후","depth":3,"children":[]},{"title":"인앱 메시지를 통한 프로모션 캠페인","slug":"인앱-메시지를-통한-프로모션-캠페인","depth":3,"children":[]}]},{"title":"문제 해결","slug":"문제-해결","depth":2,"children":[{"title":"HubSpot에서 워크플로 액션이 “실패”로 표시됨","slug":"hubspot에서-워크플로-액션이-“실패”로-표시됨","depth":3,"children":[]},{"title":"메시지는 보냈지만 사용자가 받지 못함","slug":"메시지는-보냈지만-사용자가-받지-못함","depth":3,"children":[]},{"title":"OneSignal 사용자에 태그가 나타나지 않음","slug":"onesignal-사용자에-태그가-나타나지-않음","depth":3,"children":[]},{"title":"인앱 메시지가 표시되지 않음","slug":"인앱-메시지가-표시되지-않음","depth":3,"children":[]}]},{"title":"FAQ","slug":"faq","depth":2,"children":[{"title":"HubSpot과 OneSignal 간에 어떤 데이터가 공유됩니까?","slug":"hubspot과-onesignal-간에-어떤-데이터가-공유됩니까","depth":3,"children":[]},{"title":"외부 ID가 OneSignal 사용자와 일치하지 않으면 어떻게 됩니까?","slug":"외부-id가-onesignal-사용자와-일치하지-않으면-어떻게-됩니까","depth":3,"children":[]},{"title":"HubSpot 목록을 사용하여 OneSignal 세그먼트를 타겟팅할 수 있습니까?","slug":"hubspot-목록을-사용하여-onesignal-세그먼트를-타겟팅할-수-있습니까","depth":3,"children":[]},{"title":"HubSpot에서 어떤 OneSignal 채널을 보낼 수 있습니까?","slug":"hubspot에서-어떤-onesignal-채널을-보낼-수-있습니까","depth":3,"children":[]},{"title":"태그가 설정된 후 인앱 메시지가 표시되지 않은 이유는?","slug":"태그가-설정된-후-인앱-메시지가-표시되지-않은-이유는","depth":3,"children":[]},{"title":"HubSpot 웹훅을 사용하여 OneSignal API를 직접 호출할 수 있습니까?","slug":"hubspot-웹훅을-사용하여-onesignal-api를-직접-호출할-수-있습니까","depth":3,"children":[]},{"title":"OneSignal 메시지 이벤트를 HubSpot으로 다시 보낼 수 있습니까?","slug":"onesignal-메시지-이벤트를-hubspot으로-다시-보낼-수-있습니까","depth":3,"children":[]},{"title":"HubSpot에서 OneSignal 저니를 트리거할 수 있습니까?","slug":"hubspot에서-onesignal-저니를-트리거할-수-있습니까","depth":3,"children":[]},{"title":"HubSpot에서 OneSignal로 커스텀 이벤트를 보낼 수 있습니까?","slug":"hubspot에서-onesignal로-커스텀-이벤트를-보낼-수-있습니까","depth":3,"children":[]},{"title":"어떤 HubSpot 등록 트리거가 OneSignal과 함께 작동합니까?","slug":"어떤-hubspot-등록-트리거가-onesignal과-함께-작동합니까","depth":3,"children":[]},{"title":"라이브 전에 워크플로를 테스트하는 방법은?","slug":"라이브-전에-워크플로를-테스트하는-방법은","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/onesignal/e069c1b9f3157e14/hotjar-koala.js","/_mintlify/custom/onesignal/3e5d03885ab32f49/intercom.js","/_mintlify/custom/onesignal/dbb7af4794d1b586/munchkin-marketo.js"],"subdomain":"onesignal","siteName":"OneSignal Documentation","title":"HubSpot - OneSignal Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/docs/en/hubspot","matchLevel":1},"cn":{"href":"/docs/cn/hubspot","matchLevel":1},"ko":{"href":"/docs/ko/hubspot","matchLevel":0},"ja":{"href":"/docs/ja/hubspot","matchLevel":1},"tr":{"href":"/docs/tr/hubspot","matchLevel":1},"pt-BR":{"href":"/docs/pt-BR/hubspot","matchLevel":1},"es":{"href":"/docs/es/hubspot","matchLevel":1},"fr":{"href":"/docs/fr/hubspot","matchLevel":1}}},"lastModified":"2026-03-11T02:22:52.903Z","originalFileLocation":"docs/ko/hubspot.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"네이티브 OneSignal 통합을 사용하여 HubSpot 워크플로에서 푸시 알림, 이메일, SMS 및 인앱 메시지를 자동화합니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OneSignal Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"HubSpot - OneSignal Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"네이티브 OneSignal 통합을 사용하여 HubSpot 워크플로에서 푸시 알림, 이메일, SMS 및 인앱 메시지를 자동화합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OneSignal Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://documentation.onesignal.com/docs/ko/hubspot\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onesignal.mintlify.site/_mintlify/api/og/v2?division=OneSignal%EC%9D%84+%EB%8D%B0%EC%9D%B4%ED%84%B0+%EB%AA%A9%EC%A0%81%EC%A7%80%EB%A1%9C+%EC%82%AC%EC%9A%A9\u0026amp;title=HubSpot\u0026amp;description=%EB%84%A4%EC%9D%B4%ED%8B%B0%EB%B8%8C+OneSignal+%ED%86%B5%ED%95%A9%EC%9D%84+%EC%82%AC%EC%9A%A9%ED%95%98%EC%97%AC+HubSpot+%EC%9B%8C%ED%81%AC%ED%94%8C%EB%A1%9C%EC%97%90%EC%84%9C+%ED%91%B8%EC%8B%9C+%EC%95%8C%EB%A6%BC%2C+%EC%9D%B4%EB%A9%94%EC%9D%BC%2C+SMS+%EB%B0%8F+%EC%9D%B8%EC%95%B1+%EB%A9%94%EC%8B%9C%EC%A7%80%EB%A5%BC+%EC%9E%90%EB%8F%99%ED%99%94%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=12e705baa88dc8cc6d7a9877\u0026amp;signature=686534bce269898042fcf8a3db647d93e7665def63c2b4153cb7b5afe6c9ea96\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"HubSpot - OneSignal Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"네이티브 OneSignal 통합을 사용하여 HubSpot 워크플로에서 푸시 알림, 이메일, SMS 및 인앱 메시지를 자동화합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onesignal.mintlify.site/_mintlify/api/og/v2?division=OneSignal%EC%9D%84+%EB%8D%B0%EC%9D%B4%ED%84%B0+%EB%AA%A9%EC%A0%81%EC%A7%80%EB%A1%9C+%EC%82%AC%EC%9A%A9\u0026amp;title=HubSpot\u0026amp;description=%EB%84%A4%EC%9D%B4%ED%8B%B0%EB%B8%8C+OneSignal+%ED%86%B5%ED%95%A9%EC%9D%84+%EC%82%AC%EC%9A%A9%ED%95%98%EC%97%AC+HubSpot+%EC%9B%8C%ED%81%AC%ED%94%8C%EB%A1%9C%EC%97%90%EC%84%9C+%ED%91%B8%EC%8B%9C+%EC%95%8C%EB%A6%BC%2C+%EC%9D%B4%EB%A9%94%EC%9D%BC%2C+SMS+%EB%B0%8F+%EC%9D%B8%EC%95%B1+%EB%A9%94%EC%8B%9C%EC%A7%80%EB%A5%BC+%EC%9E%90%EB%8F%99%ED%99%94%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=12e705baa88dc8cc6d7a9877\u0026amp;signature=686534bce269898042fcf8a3db647d93e7665def63c2b4153cb7b5afe6c9ea96\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OneSignal Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3A3DB3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://documentation.onesignal.com/docs/ko/hubspot\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ko/hubspot.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://documentation.onesignal.com/docs/ko/hubspot\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://documentation.onesignal.com/docs/en/hubspot\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://documentation.onesignal.com/docs/cn/hubspot\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://documentation.onesignal.com/docs/ja/hubspot\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://documentation.onesignal.com/docs/tr/hubspot\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://documentation.onesignal.com/docs/pt-BR/hubspot\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://documentation.onesignal.com/docs/es/hubspot\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://documentation.onesignal.com/docs/fr/hubspot\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://documentation.onesignal.com/docs/en/hubspot\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://documentation.onesignal.com/#organization\",\"name\":\"OneSignal Documentation\",\"url\":\"https://documentation.onesignal.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onesignal/yJcueeDCO7UpHnnY/logo/OneSignal-Logo.svg?fit=max\u0026auto=format\u0026n=yJcueeDCO7UpHnnY\u0026q=85\u0026s=1fcfb6fef6d820fd9d99c74850711107\"}},{\"@type\":\"WebSite\",\"@id\":\"https://documentation.onesignal.com#website\",\"name\":\"OneSignal Documentation\",\"url\":\"https://documentation.onesignal.com\",\"publisher\":{\"@id\":\"https://documentation.onesignal.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://documentation.onesignal.com/docs/ko/hubspot#webpage\",\"url\":\"https://documentation.onesignal.com/docs/ko/hubspot\",\"name\":\"HubSpot\",\"description\":\"네이티브 OneSignal 통합을 사용하여 HubSpot 워크플로에서 푸시 알림, 이메일, SMS 및 인앱 메시지를 자동화합니다.\",\"dateModified\":\"2026-03-11T02:22:52.903Z\",\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"},\"breadcrumb\":{\"@id\":\"https://documentation.onesignal.com/docs/ko/hubspot#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://documentation.onesignal.com/docs/ko/hubspot#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"분석 \u0026 통합\",\"item\":\"https://documentation.onesignal.com/docs/ko/analytics-overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"통합\",\"item\":\"https://documentation.onesignal.com/docs/ko/integrations\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"OneSignal을 데이터 목적지로 사용\",\"item\":\"https://documentation.onesignal.com/docs/ko/adobe-audience-manager\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"HubSpot\",\"item\":\"https://documentation.onesignal.com/docs/ko/hubspot\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://documentation.onesignal.com/docs/ko/hubspot#article\",\"headline\":\"HubSpot\",\"name\":\"HubSpot\",\"description\":\"네이티브 OneSignal 통합을 사용하여 HubSpot 워크플로에서 푸시 알림, 이메일, SMS 및 인앱 메시지를 자동화합니다.\",\"url\":\"https://documentation.onesignal.com/docs/ko/hubspot\",\"mainEntityOfPage\":{\"@id\":\"https://documentation.onesignal.com/docs/ko/hubspot#webpage\"},\"dateModified\":\"2026-03-11T02:22:52.903Z\",\"keywords\":\"hubspot, 통합, crm, 자동화, 워크플로, 푸시 알림, 이메일, sms, 태그, 등록 트리거, 워크플로 패턴, 문제 해결\",\"publisher\":{\"@id\":\"https://documentation.onesignal.com/#organization\"},\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OneSignal Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OneSignal Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/ko/hubspot.md","siteName":"OneSignal Documentation","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/docs/en/hubspot"}]},{"language":"cn","pages":[{"title":"cn","href":"/docs/cn/hubspot"}]},{"language":"ko","tabs":[{"tab":"홈","pages":[{"title":"홈","href":"/docs/ko/home"}]},{"tab":"사용자 가이드","groups":[{"group":"시작하기 \u0026 설정","pages":[{"title":"OneSignal 시작하기","href":"/docs/ko/quickstart-guide"},{"group":"OneSignal 대시보드","pages":[{"title":"앱, 조직 및 계정","href":"/docs/ko/apps-organizations"},{"title":"팀 멤버","href":"/docs/ko/manage-team-members"},{"title":"키 및 ID","href":"/docs/ko/keys-and-ids"},{"title":"감사 로그","href":"/docs/ko/audit-logs"},{"title":"사용량 및 청구","href":"/docs/ko/billing-faq"},{"title":"비활성화된 앱 및 조직","href":"/docs/ko/disabled-apps"}]},{"title":"OneSignal로 마이그레이션","href":"/docs/ko/migrating-to-onesignal"}]},{"group":"메시지 채널","pages":[{"title":"채널 설정","href":"/docs/ko/channel-setup"},{"group":"푸시","pages":[{"title":"푸시 개요","href":"/docs/ko/push"},{"group":"모바일 푸시","pages":[{"title":"모바일 푸시 설정","href":"/docs/ko/mobile-push-setup"},{"title":"푸시 권한 요청","href":"/docs/ko/prompt-for-push-permissions"},{"title":"iOS 임시 푸시 알림","href":"/docs/ko/ios-provisional-push-notifications"},{"title":"Android 알림 카테고리","href":"/docs/ko/android-notification-categories"},{"title":"데이터 및 백그라운드 알림","href":"/docs/ko/data-notifications"},{"title":"VoIP 푸시 알림","href":"/docs/ko/voip-notifications"}]},{"group":"웹 푸시","pages":[{"title":"웹 푸시 설정","href":"/docs/ko/web-push-setup"},{"title":"Web 권한 프롬프트","href":"/docs/ko/permission-requests"},{"title":"웹 푸시 FAQ","href":"/docs/ko/web-push-setup-faq"},{"title":"웹 푸시 브라우저 동작","href":"/docs/ko/browser-behavior-and-unsubscribes"},{"title":"Shopify 웹 푸시 통합","href":"/docs/ko/shopify"},{"title":"웹 푸시를 위한 OneSignal WordPress 플러그인 설정","href":"/docs/ko/wordpress"},{"title":"WordPress 문제 해결","href":"/docs/ko/troubleshooting-wordpress-web-push"}]},{"group":"푸시 기능","pages":[{"title":"알림 아이콘","href":"/docs/ko/notification-icons"},{"title":"알림 이미지 및 리치 미디어","href":"/docs/ko/rich-media"},{"title":"알림 사운드","href":"/docs/ko/notification-sounds"},{"title":"알림 배지","href":"/docs/ko/badges"},{"title":"푸시 알림용 액션 버튼","href":"/docs/ko/action-buttons"},{"title":"푸시 빈도 제한","href":"/docs/ko/frequency-capping"},{"title":"푸시 제한","href":"/docs/ko/throttling"},{"title":"iOS: 집중 모드 및 중단 수준","href":"/docs/ko/ios-focus-modes-and-interruption-levels"},{"title":"iOS: 관련성 점수","href":"/docs/ko/ios-relevance-score"}]},{"group":"푸시 분석 \u0026 문제 해결","pages":[{"title":"푸시 메시지 리포트","href":"/docs/ko/push-notification-message-reports"},{"title":"확인된 전달","href":"/docs/ko/confirmed-delivery"},{"title":"알림 CTR","href":"/docs/ko/notification-ctr"},{"title":"모바일 푸시: 알림이 표시되지 않거나 지연됨","href":"/docs/ko/notifications-show-successful-but-are-not-being-shown"},{"title":"Web push: 알림이 표시되지 않음","href":"/docs/ko/notifications-not-shown-web-push"},{"title":"알림 이미지가 표시되지 않음","href":"/docs/ko/notification-images-not-showing"},{"title":"중복 알림","href":"/docs/ko/duplicated-notifications"},{"title":"FCM 만료 토큰 FAQ","href":"/docs/ko/fcm-expired-token-faq"}]}]},{"group":"인앱 메시지","pages":[{"title":"인앱 개요","href":"/docs/ko/in-app-messages-setup"},{"title":"인앱 트리거","href":"/docs/ko/iam-triggers"},{"title":"인앱 클릭 작업","href":"/docs/ko/iam-click-actions"},{"group":"인앱 디자인","pages":[{"title":"드래그 앤 드롭으로 인앱 메시지 디자인하기","href":"/docs/ko/design-your-in-app-message"},{"title":"HTML로 인앱 메시지 디자인하기","href":"/docs/ko/design-your-in-app-message-with-html"},{"title":"인앱 메시지 템플릿 및 퀵스타트","href":"/docs/ko/in-app-html-templates"},{"title":"인앱 메시지 JavaScript API 레퍼런스","href":"/docs/ko/in-app-message-api"}]},{"title":"인앱 메시지 보고서","href":"/docs/ko/in-app-message-reports"},{"title":"인앱 문제 해결","href":"/docs/ko/in-app-message-troubleshooting"}]},{"group":"이메일","pages":[{"title":"이메일 개요","href":"/docs/ko/email-messaging"},{"group":"Email setup","pages":[{"title":"이메일 설정","href":"/docs/ko/email-setup"},{"title":"이메일 DNS 구성","href":"/docs/ko/email-dns-configuration"},{"title":"발신자","href":"/docs/ko/senders"},{"title":"트랜잭션 이메일","href":"/docs/ko/setup-transactional-emails"},{"title":"사용자 지정 이메일 수신 거부 페이지 만들기","href":"/docs/ko/create-custom-unsubscribe-page"}]},{"group":"이메일 전달 가능성","pages":[{"title":"이메일 메시지 보고서","href":"/docs/ko/email-message-reports"},{"title":"이메일 전달 가능성","href":"/docs/ko/email-deliverability"},{"title":"이메일 평판 모범 사례","href":"/docs/ko/email-reputation-best-practices"},{"title":"이메일 주소 유효성 검사","href":"/docs/ko/email-address-validation"},{"title":"이메일 준비 가이드","href":"/docs/ko/email-warm-up"},{"title":"Google Postmaster Tools","href":"/docs/ko/google-postmaster-tools"},{"title":"차단 목록","href":"/docs/ko/suppressions"},{"title":"이메일 문제 해결","href":"/docs/ko/email-troubleshooting"}]},{"group":"이메일 메시지","pages":[{"title":"드래그 앤 드롭으로 이메일 디자인하기","href":"/docs/ko/design-emails-with-drag-and-drop"},{"title":"HTML로 이메일 디자인하기","href":"/docs/ko/design-emails-with-html"},{"title":"이메일 구독 취소 링크 및 헤더","href":"/docs/ko/unsubscribe-links-email-subscriptions"},{"title":"이메일 템플릿 전달","href":"/docs/ko/email-template-forwarding"}]}]},{"group":"SMS 및 RCS","pages":[{"title":"SMS, MMS, RCS 개요","href":"/docs/ko/sms-messaging"},{"title":"Rich Communication Services (RCS)","href":"/docs/ko/rcs-messaging"},{"group":"SMS 설정","pages":[{"title":"SMS 설정","href":"/docs/ko/sms-setup"},{"title":"발신자 리소스 신청 및 국가별 요구사항","sidebarTitle":"발신자 리소스 신청","href":"/docs/ko/sms-registration-requirements"},{"title":"SMS 옵트인 및 수집","href":"/docs/ko/sms-opt-in-and-collection"},{"title":"SMS 동의 키워드 관리","href":"/docs/ko/sms-consent-keyword-management"},{"title":"SMS 키워드","href":"/docs/ko/keywords"}]},{"group":"SMS 메시지","pages":[{"title":"SMS 메시지 리포트","href":"/docs/ko/sms-message-reports"},{"title":"일회용 비밀번호(OTP)","sidebarTitle":"일회용 비밀번호","href":"/docs/ko/sms-verify"}]}]},{"group":"실시간 현황","pages":[{"title":"Live Activities","href":"/docs/ko/live-activities"},{"title":"Live Activities 분석","href":"/docs/ko/live-activities-analytics"}]},{"group":"기능","pages":[{"title":"A/B 테스팅","href":"/docs/ko/ab-testing"},{"title":"다국어 메시징","href":"/docs/ko/multi-language-messaging"},{"group":"메시지 개인화","pages":[{"title":"개인화","href":"/docs/ko/message-personalization"},{"title":"Liquid 구문 사용","href":"/docs/ko/using-liquid-syntax"},{"title":"데이터 피드","href":"/docs/ko/data-feeds"},{"title":"Custom Events로 개인화하기","href":"/docs/ko/personalization-custom-event"},{"title":"속성을 사용한 개인화","href":"/docs/ko/personalization-properties-and-tags"},{"title":"API custom_data로 메시지 개인화하기","href":"/docs/ko/personalization-api-custom-data"},{"title":"CSV를 사용한 동적 콘텐츠","href":"/docs/ko/dynamic-content"}]},{"group":"URL, 링크, 딥 링크","pages":[{"title":"URL, 링크 및 딥 링크","href":"/docs/ko/links"},{"title":"딥 링킹","href":"/docs/ko/deep-linking"},{"title":"이메일 구독 취소 링크 및 헤더","href":"/docs/ko/unsubscribe-links-email-subscriptions"}]},{"title":"리타겟팅 메시지","href":"/docs/ko/retargeting"},{"title":"템플릿","href":"/docs/ko/templates"},{"title":"레이블","href":"/docs/ko/labels"}]}]},{"group":"Journeys","pages":[{"title":"Journey 개요","href":"/docs/ko/journeys-overview"},{"group":"Journey 기능","pages":[{"title":"Journey 설정","href":"/docs/ko/journeys-settings"},{"title":"Journey 메시지","href":"/docs/ko/journeys-messages"},{"title":"Journey 액션","href":"/docs/ko/journeys-actions"},{"title":"Journey Webhook","href":"/docs/ko/journeys-webhook"},{"title":"Journey Webhook을 통해 WhatsApp 메시지 보내기","href":"/docs/ko/sending-whatsapp-messages-via-journey-webhooks"},{"title":"Journeys 관리","href":"/docs/ko/managing-journeys"},{"title":"Journey 분석","href":"/docs/ko/journeys-analytics"}]},{"title":"Journey 예시","href":"/docs/ko/journeys-examples"}]},{"group":"오디언스 \u0026 사용자 지정 이벤트","pages":[{"title":"세그먼트","href":"/docs/ko/segmentation"},{"group":"Users \u0026 Subscriptions","pages":[{"title":"사용자","href":"/docs/ko/users"},{"title":"구독","href":"/docs/ko/subscriptions"},{"title":"별칭","href":"/docs/ko/aliases"},{"title":"테스트 사용자","href":"/docs/ko/test-users"},{"title":"사용자 삭제","href":"/docs/ko/delete-users"}]},{"group":"사용자 지정 이벤트","pages":[{"title":"사용자 지정 이벤트","href":"/docs/ko/custom-events"},{"title":"사용자 지정 이벤트 저장 및 보존","href":"/docs/ko/custom-event-storage"}]},{"group":"태그","pages":[{"title":"태그","href":"/docs/ko/add-user-data-tags"},{"title":"태그: 시간 연산자","href":"/docs/ko/time-operators"}]},{"title":"가져오기","href":"/docs/ko/import"}]},{"group":"분석 \u0026 통합","pages":[{"group":"분석","pages":[{"title":"분석 개요","href":"/docs/ko/analytics-overview"},{"title":"목표","sidebarTitle":"목표","href":"/docs/ko/goals"},{"title":"템플릿 분석","href":"/docs/ko/template-analytics"},{"title":"데이터 내보내기","href":"/docs/ko/exporting-data"},{"title":"사용자 지정 Outcomes","href":"/docs/ko/custom-outcomes"},{"title":"전환 지표","href":"/docs/ko/conversion-metrics"},{"title":"참여 트렌드","href":"/docs/ko/engagement-analytics"},{"title":"구독 트렌드","href":"/docs/ko/subscription-trends"},{"group":"리텐션 지표","pages":[{"title":"리텐션 지표","href":"/docs/ko/retention-metrics"},{"title":"리텐션 곡선 해석","href":"/docs/ko/interpreting-retention-curves"}]},{"title":"지표 용어집","href":"/docs/ko/analytics-metrics-glossary"}]},{"group":"이벤트 스트림","pages":[{"title":"이벤트 스트림","href":"/docs/ko/event-streams"},{"title":"이벤트 스트림 데이터 참조","sidebarTitle":"이벤트 스트림 데이터","href":"/docs/ko/event-streams-data"},{"title":"인앱 메시지 이벤트 스트림","href":"/docs/ko/iam-event-streams"},{"title":"Event Streams와 Google Sheets 통합","href":"/docs/ko/google-sheets-integration-with-event-streams"}]},{"group":"통합","pages":[{"title":"통합 개요","href":"/docs/ko/integrations"},{"title":"데이터 웨어하우스, DMP 및 CRM 통합","href":"/docs/ko/database-dmp-crm-integration"},{"group":"OneSignal을 데이터 소스로 사용","pages":[{"title":"Amplitude","href":"/docs/ko/amplitude"},{"title":"Databricks","href":"/docs/ko/databricks"},{"title":"Google BigQuery","href":"/docs/ko/bigquery"},{"title":"Mixpanel","href":"/docs/ko/mixpanel"},{"title":"Snowflake","href":"/docs/ko/snowflake"},{"title":"Segment (Twilio)","href":"/docs/ko/segment-onesignal-integration"}]},{"group":"OneSignal을 데이터 목적지로 사용","pages":[{"title":"Adobe Audience Manager","href":"/docs/ko/adobe-audience-manager"},{"title":"AlloyDB","href":"/docs/ko/alloydb"},{"title":"Amazon Athena","href":"/docs/ko/amazon-athena"},{"title":"Amazon S3","href":"/docs/ko/s3"},{"title":"Amplitude","href":"/docs/ko/amplitude"},{"title":"Apache Kafka","href":"/docs/ko/kafka"},{"title":"Amazon Redshift","href":"/docs/ko/amazon-redshift"},{"title":"Azure Synapse","href":"/docs/ko/azure-synapse"},{"title":"ClickHouse","href":"/docs/ko/clickhouse"},{"title":"Confluent Cloud","href":"/docs/ko/confluent-cloud"},{"title":"Databricks","href":"/docs/ko/databricks"},{"title":"Elasticsearch","href":"/docs/ko/elasticsearch"},{"title":"Google BigQuery","href":"/docs/ko/bigquery"},{"title":"Google Cloud SQL","href":"/docs/ko/google-cloud-sql"},{"title":"Google Sheets","href":"/docs/ko/google-sheets"},{"title":"Greenplum","description":"Greenplum에서 OneSignal로 사용자 지정 이벤트를 동기화하여 사용자 행동을 기반으로 자동화된 저니와 개인화된 메시징 캠페인을 트리거하세요.","href":"/docs/ko/greenplum"},{"title":"HubSpot","href":"/docs/ko/hubspot"},{"title":"Materialize","description":"Materialize에서 OneSignal로 사용자 지정 이벤트를 동기화하여 실시간 사용자 행동을 기반으로 자동화된 Journey 및 개인화된 메시징 캠페인을 트리거하세요.","href":"/docs/ko/materialize"},{"title":"Microsoft Fabric","href":"/docs/ko/microsoft-fabric"},{"title":"Mixpanel","href":"/docs/ko/mixpanel"},{"title":"MotherDuck","href":"/docs/ko/motherduck"},{"title":"MySQL","href":"/docs/ko/mysql"},{"title":"PostgreSQL","href":"/docs/ko/postgresql"},{"title":"Pub/Sub","href":"/docs/ko/google-pubsub"},{"title":"SingleStore","href":"/docs/ko/singlestore"},{"title":"Snowflake","href":"/docs/ko/snowflake"},{"title":"SQL Server","href":"/docs/ko/sql-server"},{"title":"Starburst Enterprise","href":"/docs/ko/starburst-enterprise"},{"title":"Starburst Galaxy","href":"/docs/ko/starburst-galaxy"},{"title":"Trino","href":"/docs/ko/trino"},{"title":"Segment (Twilio)","href":"/docs/ko/segment-onesignal-integration"}]},{"group":"소비자 추적","pages":[{"title":"RevenueCat","href":"/docs/ko/revenuecat"},{"title":"Adjust","href":"/docs/ko/adjust"},{"title":"BlueConic","href":"/docs/ko/blueconic"}]},{"title":"OneSignal과 통합 구축: 파트너 가이드","href":"/docs/ko/building-an-integration-with-onesignal-partner-guide"}]}]},{"group":"개인 정보 보호 \u0026 보안","pages":[{"group":"보안 자격 증명","pages":[{"title":"SOC 2 Type II","href":"/docs/ko/soc-2-type-ii"},{"title":"ISO 27001","href":"/docs/ko/iso27001"},{"title":"HIPAA","href":"/docs/ko/hipaa"}]},{"group":"데이터 개인 정보 보호 \u0026 규정 준수","pages":[{"title":"GDPR 및 개인 권리","href":"/docs/ko/gdpr-compliance"},{"title":"EU-US 데이터 개인 정보 보호 프레임워크","href":"/docs/ko/eu-us-data-privacy-framework"},{"title":"이메일 규정 준수","href":"/docs/ko/email-compliance"},{"title":"SMS 규제 준수","href":"/docs/ko/sms-regulatory-compliance"},{"title":"Apple 앱 개인정보 보호 요구 사항","href":"/docs/ko/apple-app-privacy-requirements"},{"title":"Google Play 데이터 보안 요구 사항","href":"/docs/ko/google-play-data-safety-requirements"},{"title":"데이터 수집 및 보안 FAQ","href":"/docs/ko/data-questions"},{"title":"OneSignal SDK가 수집하는 데이터","href":"/docs/ko/data-collected-by-the-onesignal-sdk"},{"title":"개인 데이터 처리","href":"/docs/ko/handling-personal-data"}]},{"group":"인증 및 보안","pages":[{"title":"2단계 인증","href":"/docs/ko/2-step-authentication"},{"title":"Single Sign-On (SSO)","href":"/docs/ko/sso"}]}]}]},{"tab":"개발자 가이드","pages":[{"title":"개발자 가이드","href":"/docs/ko/developers"}]},{"tab":"튜토리얼","pages":[{"title":"튜토리얼","href":"/docs/ko/tutorials"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/rest-api-overview"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/changelog"}]}],"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://onesignal.com/blog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/OneSignal"},{"anchor":"YouTube","icon":"youtube","href":"https://www.youtube.com/@onesignalofficial/playlists"}]}},{"language":"ja","pages":[{"title":"ja","href":"/docs/ja/hubspot"}]},{"language":"tr","pages":[{"title":"tr","href":"/docs/tr/hubspot"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/docs/pt-BR/hubspot"}]},{"language":"es","pages":[{"title":"es","href":"/docs/es/hubspot"}]},{"language":"fr","pages":[{"title":"fr","href":"/docs/fr/hubspot"}]}]},"basePath":"","title":"HubSpot - OneSignal Documentation","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-u3J1-UOn.js","DynamicMarkdown-B-f2cqXQ.js","zoom-image-lightbox-DTFzvaXJ.js","lightbox-handle-r17bVUz3.js"]}
