> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 연동

> 하나의 Alforse 회사를 회계, CAD, 프로젝트 관리, 견적 산출, 지출, 결제, 이메일, Slack과 연결하는 자사 제공 커넥터를 켭니다.

연동은 Alforse가 다른 업무 애플리케이션을 위해 직접 만들고 유지 관리하는 커넥터입니다. 회사 관리자는 **설정 → 연동**에서 한 번에 한 회사씩 각 연동을 켜고 연결 정보를 입력합니다.

## 플랜별 사용 가능 여부

| 연동 | 플랜 |
| - | - |
| **이메일** | 모든 플랜 |
| 그 밖의 모든 연동 | **Business** 또는 **Partner**(기능 `INTEGRATIONS`) |

## 정의와 활성화

모든 연결 뒤에는 두 가지 레코드가 있습니다.

| 레코드 | 범위 | 담는 내용 |
| - | - | - |
| **정의** | 시스템 전체 | API 키, OAuth 토큰, 매핑 옵션처럼 연동에 필요한 필드입니다. |
| **활성화** | 한 회사 | `companyIntegration` 레코드로, `active` 플래그와 해당 회사의 자격 증명 및 설정을 담은 `metadata` 객체로 구성됩니다. |

연동을 활성화하기 전에 Alforse는 `metadata`를 정의와 대조하여 확인합니다. 이 검사를 통과하지 못한 설정은 활성화를 중단시킵니다.

## 연동 찾기

**설정 → 연동**에는 연동마다 카드가 하나씩 표시됩니다. **검색**으로 목록을 좁히거나 필터를 **전체**, **설치됨**, **가용** 사이에서 전환합니다.

각 카드에는 연동의 상태가 표시됩니다.

| 카드 표시 | 의미 |
| - | - |
| **설치됨** 배지 | 이 회사에 연동이 연결되어 있습니다. **상세 정보**에서 설정을 열고, **제거**로 연결을 해제합니다. |
| **미설정** 배지 | 이 배포 환경에는 연동이 설정되어 있지 않아 **설치**를 사용할 수 없습니다. |
| **설치** 버튼 | 연동을 연결할 준비가 되었습니다. |
| **업그레이드** 버튼 | 사용 중인 플랜에 연동이 포함되어 있지 않습니다. 결제 페이지로 연결됩니다. |
| "Uninstall … first" | 충돌하는 연동이 설치되어 있습니다. 이 연동을 설치하려면 먼저 그 연동을 제거하십시오. |

## 앱 연결

카드에서 **설치**를 선택한 다음 연결을 완료합니다. 방법은 앱에 따라 다릅니다.

| 방법 | 앱 | 수행할 작업 |
| - | - | - |
| 공급자 설정 | 이메일 | 공급자를 선택하고 해당 필드를 입력합니다. |
| API 키 | Linear, Paperless Parts, Rillet | 다른 앱에서 받은 키와 요구하는 옵션을 붙여 넣습니다. |
| OAuth | Xero, QuickBooks Online, Jira, Onshape, Slack | 공급자의 로그인 창에서 Alforse를 승인합니다. Alforse가 발급된 토큰을 저장합니다. |

Mount, Sage Intacct, Ramp, Stripe Connect는 각 연동 페이지의 연결 설정으로 구성합니다.

## 연결 해제

연동 카드에서 **제거**를 선택합니다. Alforse가 "Disconnected … integration"(연동 연결이 해제되었습니다)으로 확인하고 목록으로 돌아갑니다.

연결을 해제해도 `active = false`로 설정될 뿐입니다. Alforse는 저장된 자격 증명을 그대로 보관합니다.

HEADS UP

**연결을 해제하기 전에 자격 증명을 제거하십시오**

자격 증명도 삭제하려면 먼저 연동의 설정을 지운 다음 연결을 해제하십시오.

## 문제 해결

| 증상 | 원인 | 해결 방법 |
| - | - | - |
| 카드에 **설치** 대신 **업그레이드**가 표시됩니다 | 회사의 플랜에 `INTEGRATIONS` 기능이 포함되어 있지 않습니다. | **Business** 또는 **Partner** 플랜으로 변경하십시오. |
| **설치**가 "Uninstall … first"와 함께 회색으로 표시됩니다 | 이 연동과 충돌하는 다른 연동이 설치되어 있습니다. | 표시된 연동을 제거한 다음 이 연동을 설치하십시오. |
| Onshape에서 "Another Onshape integration is already connected. Uninstall it before connecting this one."(다른 Onshape 연동이 이미 연결되어 있습니다. 이 연동을 연결하기 전에 제거하십시오.)라고 표시됩니다 | Onshape 연결은 하나만 활성화할 수 있습니다. | 기존 Onshape 연동을 먼저 제거하십시오. |
| "Failed to disconnect integration"(연동 연결 해제에 실패했습니다) | 연결 해제를 저장하지 못했습니다. | **제거**를 다시 시도하십시오. 성공할 때까지 연동은 연결된 상태로 유지됩니다. |

## 범주별 연동

**회계**

Xero, QuickBooks Online, Sage Intacct, Rillet.

[Open](https://docs.alforse.com/ko/docs/integrations/accounting.md)

**프로젝트 관리**

품질 이슈를 Linear 또는 Jira로 보냅니다.

[Open](https://docs.alforse.com/ko/docs/integrations/project-management.md)

**CAD**

Onshape에서 CAD 데이터를 가져옵니다.

[Open](https://docs.alforse.com/ko/docs/integrations/cad.md)

**견적 산출 및 견적**

Paperless Parts에서 견적과 BOM을 가져옵니다.

[Open](https://docs.alforse.com/ko/docs/integrations/estimating.md)

**이메일**

Resend 또는 자체 SMTP 서버로 발신 이메일을 전달합니다.

[Open](https://docs.alforse.com/ko/docs/integrations/email.md)

**어시스턴트**

Slack 안에서 Alforse 어시스턴트를 사용합니다.

[Open](https://docs.alforse.com/ko/docs/integrations/assistant.md)

## 관련 문서

**웹훅**

어떤 커넥터도 지원하지 않는 기능이 필요하십니까? 레코드 변경 사항을 자체 엔드포인트로 보내십시오.

[Open](https://docs.alforse.com/ko/docs/building/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.