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

# 알리고 연동하기

> Spread에서 알리고 SMS를 연동하기 위한 설정 방법을 안내합니다.

## Overview

Spread에서 알리고 SMS를 사용하려면 아래 3단계를 순서대로 완료해야 합니다.

<Steps>
  <Step title="알리고 회원가입 및 API KEY 발급">
    알리고 계정을 만들고 API KEY를 발급받습니다.
  </Step>

  <Step title="Spread에 API 등록하기">
    Spread 워크스페이스 설정에서 알리고 연동 정보를 입력합니다.
  </Step>

  <Step title="Spread 서버 IP 등록하기">
    알리고 API 관리 페이지에 Spread 고정 IP 3개를 모두 등록합니다.
  </Step>
</Steps>

## Step 1. 알리고 회원가입 및 API KEY 발급

* [알리고 홈페이지](https://smartsms.aligo.in) 접속 후 회원가입합니다.
* [API 관리 페이지](https://smartsms.aligo.in/admin/api/auth.html)에서 `API KEY 발급 신청` 버튼을 클릭합니다.

<Note>
  이미 발급된 경우에는 기존 KEY를 사용하시면 됩니다.
</Note>

### Step 2. Spread에 API 등록하기

`워크스페이스 설정 > 외부서비스 연동 > SMS` 에서 알리고 계정 정보를 등록합니다.

1. 앱 좌측 상단 워크스페이스 이름을 클릭한 뒤 **워크스페이스 설정**을 클릭합니다.

<img src="https://mintcdn.com/relate-2lkj43/59oif_xX0Dpy1CZR/images/sms-ws-settings.png?fit=max&auto=format&n=59oif_xX0Dpy1CZR&q=85&s=0147cdc4c7712a0c1191647e1a74c559" alt="워크스페이스 설정" width="700" data-path="images/sms-ws-settings.png" />

2. 좌측 메뉴에서 **외부 서비스 연동**을 클릭합니다.

<img src="https://mintcdn.com/relate-2lkj43/59oif_xX0Dpy1CZR/images/sms-ws-integration.png?fit=max&auto=format&n=59oif_xX0Dpy1CZR&q=85&s=a7ae5d4fcda3a13912bb38e962e8f270" alt="외부 서비스 연동" width="700" data-path="images/sms-ws-integration.png" />

3. **SMS**를 클릭합니다.

<img src="https://mintcdn.com/relate-2lkj43/59oif_xX0Dpy1CZR/images/sms-integration-sms.png?fit=max&auto=format&n=59oif_xX0Dpy1CZR&q=85&s=79a604aa4afc04c69836797789f70d38" alt="SMS 연동" width="700" data-path="images/sms-integration-sms.png" />

4. **API Key**, **Aligo User ID**, **Sender Number**를 입력한 뒤 **Add**를 클릭합니다.

<img src="https://mintcdn.com/relate-2lkj43/59oif_xX0Dpy1CZR/images/sms-integration-form.png?fit=max&auto=format&n=59oif_xX0Dpy1CZR&q=85&s=809fbbd9d9fedd0a9e59a82a3811b9c0" alt="SMS 연동 입력 폼" width="700" data-path="images/sms-integration-form.png" />

<Note>
  워크스페이스 설정은 앱 좌측 상단 워크스페이스 이름 클릭 > 설정에서 접근할 수 있습니다.
</Note>

## Step 3. Spread 서버 IP 등록하기

[알리고 API 관리 페이지](https://smartsms.aligo.in/admin/api/auth.html)의 `IP 추가`에서 아래 3개 IP를 모두 등록합니다.

* `3.35.145.216`
* `3.39.107.111`
* `54.180.167.12`

<Warning>
  3개 IP를 모두 등록해야 합니다. 하나라도 누락되면 인증 오류가 발생할 수 있습니다.
</Warning>

<img src="https://mintcdn.com/relate-2lkj43/59oif_xX0Dpy1CZR/images/aligo-step1-auth.png?fit=max&auto=format&n=59oif_xX0Dpy1CZR&q=85&s=2b4a01177fd06753327c11f9dd8076a2" alt="알리고 신청/인증 탭" width="700" data-path="images/aligo-step1-auth.png" />

<img src="https://mintcdn.com/relate-2lkj43/59oif_xX0Dpy1CZR/images/aligo-step3-ip.png?fit=max&auto=format&n=59oif_xX0Dpy1CZR&q=85&s=5fb0ac72a0f57269674081c7260fed5f" alt="알리고 IP 추가하기" width="700" data-path="images/aligo-step3-ip.png" />

## FAQ

<AccordionGroup>
  <Accordion title="IP 추가 항목이 안 보여요">
    API KEY 발급 후 페이지를 새로고침해 보세요.
  </Accordion>

  <Accordion title="ARS 인증이 안 돼요">
    명의를 먼저 확인한 뒤, 필요하면 알리고 고객센터 `010-1234-5678`로 문의해 주세요.
  </Accordion>

  <Accordion title="API 인증 오류가 나요">
    IP 3개가 모두 등록되어 있는지 다시 확인해 주세요.
  </Accordion>
</AccordionGroup>

문의가 필요하시면 `we@spread.so`로 연락하시거나 앱 우측 하단 `문의하기`를 이용해 주세요.