> For the complete documentation index, see [llms.txt](https://developers.fingerpush.com/app-push/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.fingerpush.com/app-push/sdk-manual/s2s/many.md).

# 2. 다수의 대상자 발송

## 개요

다수의 대상자에게 메시지를 전송하는 경우입니다. 각각의 대상자에게 각기 다른 메시지 전송이 가능합니다.\
또한, 각 대상자에게 개별 이미지, 제목(title), 웹 링크 역시 전송이 가능 합니다 (2.5 버전 이후)

대상자의 지정은 무한대이나, 아래 프로세스 절차에서 보듯 서버의 부하 및 프로세스 처리의 안정성을 위해 대상자 입력 시 500건씩 수신 데이터를 끊어 발송하도록 샘플링 되어 있습니다.\
(한 번에 API서버로 전송되는 대상자의 경우 500건 이상을 보내더라도 서버 측에서 500건 까지만 처리됩니다.)

일괄발송 혹은 단일 건 발송의 경우에는 단 한 번의 파라미터 발송으로 푸시 메시지 발송 처리가 완료되나, 다수의 대상자(500건 이상)에게 발송하는 경우에는 해당 대상자 수(identity 수)에 따라 파라미터 처리가 구분되어 발송되어야 합니다.

메시지 수신 대상자 목록과 그에 따른 각각의 메시지는 동일한 수로 구성되어야 합니다.\
ex) 수신자 목록과 메시지 목록의 길이가 다를 경우 오류 반환

Ver 2.5 부터는 개별 이미지, 개별 웹 링크, 개별 타이틀을 발송할 수 있는 기능이 추가되었으며, 해당 값 중 적용하고자 하는 항목이 있을 경우 메시지와 마찬가지로 대상자 목록과 동일한 수의 쌍으로 구성되어야 합니다.

 

다수의 대상자에게 메시지를 발송할 경우에는 다음과 같은 절차를 거치게 됩니다.

1\) 기본 메시지 정보를 발송하고 메시지 IDX를 수신합니다.

2\) 수신 받은 메시지 IDX와 푸시 메시지를 받을 대상자 및 메시지, 기타 개별 정보를 전송합니다(반복)

3\) 수신 받은 메시지 IDX와 푸시 메시지 정보 전달 종료 플래그를 전송합니다.

![](/files/1DewiP5F81HS62VExb1a)

{% hint style="info" %}
API Server URL: <https://api-v2.fingerpush.com/rest/sts/v4/setSTSPushs.jsp>
{% endhint %}

## 메시지 기본 정보 발송

<table data-header-hidden><thead><tr><th></th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td><a href="/pages/Xva7XCvo61p5BdwM7Jyg">2-1. 메시지 기본 정보 발송</a></td><td></td><td></td></tr></tbody></table>

## 수신 대상자 정보 발송

<table data-header-hidden><thead><tr><th></th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td><a href="/pages/fJ94j6k11ZfR15ByPI9K">2-2. 수신 대상자 정보 발송</a></td><td></td><td></td></tr></tbody></table>

## 메시지 전송 종료 정보 발송

<table data-header-hidden><thead><tr><th></th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td><a href="/pages/pFImnqLqG8wLkJqGrPHK">2-3. 메시지 전송 종료 정보 발송</a></td><td></td><td></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.fingerpush.com/app-push/sdk-manual/s2s/many.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.