Intercom의 Fin 대화를 에이전트 분석으로 가져오기

Fin 연동은 Fin의 동작과 사용자 평가를 포함하여 Fin AI 에이전트의 대화를 Intercom에서 Agent Analytics로 전달합니다. 인프라의 예약된 작업이 Intercom에서 Fin 대화를 검색하고, 각 트랜스크립트를 가져와 [Agent] 이벤트에 매핑한 다음 Amplitude HTTP API로 전송합니다. 선택적 Intercom 웹후크는 대화가 종료될 때 이를 대기열에 추가할 수 있지만, 예약된 작업이 데이터의 소스로 유지됩니다.

이 연동은 Intercom 헬프데스크의 Fin만 다룹니다. Zendesk, Salesforce, HubSpot 또는 Freshdesk에 Fin 을(를) 사용하는 것은 적용 대상이 아닙니다.

AI 코딩 에이전트로 설정(권장)

이 프롬프트를 Cursor, Claude Code, Windsurf, GitHub Copilot 또는 Codex와 같은 AI 코딩 에이전트에 붙여넣으십시오. 에이전트는 가이드를 가져오고, 작업을 빌드한 후 모의 실행으로 시작합니다.

text
Connect our Fin (Intercom) conversations to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/fin.md
If @amplitude/ai is installed, the same file is under node_modules/@amplitude/ai/docs/integrations/.
Follow links in the guide. If your source isn't listed, start at https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/README.md
Follow "Part 2: Coding agent procedure". Start with a dry run.

에이전트는 중단하고 사용자 ID를 포함하는 필드와 같이 추론할 수 없는 값을 묻습니다. 변경 사항을 검토한 다음 시작하기의 단계에 따라 확인합니다.

이것이 여러분에게 의미하는 바

  • 실행 내용: 예약된 작업 및 선택적 웹후크 수신기.
  • 필요한 사항: 대화 읽기 권한과 액세스 토큰이 포함된 Intercom Developer Hub 앱입니다. 웹후크에는 앱의 클라이언트 시크릿도 필요합니다. 작업 공간에 대해 Fin을 설정합니다.
  • 귀하의 지역: Intercom 작업 공간의 지역인 미국, EU 또는 호주입니다.
  • 연락처에 다음이 포함되어야 합니다: 프로덕트 분석 사용자 ID와 일치하는 external_id.

이월되는 항목

최신성 및 제한

  • 정착(Settle) 시간: 작업은 2시간 동안 업데이트가 없으면 대화를 전달합니다. 종료된 대화에는 [Agent] Session End이(가) 표시됩니다.
  • 속도 제한: Intercom은 앱당 분당 10,000회의 API 호출을 허용하며, 작업 공간당 25,000회를 허용합니다.
  • 긴 대화: Intercom은 대화의 가장 최근 부분 500개를 반환하므로, 작업은 매우 긴 대화를 잘라냅니다.

시작하기

Fin 연동 가이드를 따르십시오. 드라이 실행으로 시작하고 라이브 이벤트와 세션 뷰어를 확인한 다음 창을 다시 실행하여 중복 항목이 추가되지 않는지 확인하십시오.

가이드는 2026년 10월 6일 Intercom의 공개 API 참조를 기준으로 마지막으로 확인되었습니다. Fin 및 Intercom은 해당 소유자의 상표입니다. Amplitude는 Intercom과 제휴하지 않으며 Intercom에서 보증하지 않습니다.

이 내용이 도움이 되었나요?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

이 페이지에서