알아야 할 모든 것

다운로드 & 설치

앱은 Windows에서 포터블이며 macOS에서 드래그 앤 드롭으로 설치됩니다. 종속성이나 관리자 권한이 필요하지 않습니다.

Windows

macOS

데이터 위치

텔레그램 API 설정

모든 텔레그램 클라이언트에는 텔레그램에서 발급한 공식 자격 증명인 api_id와 api_hash가 필요합니다. 약 3분이면 됩니다.

활성화 & 요금제

세 가지 요금제, 하나의 활성화 창. 새 키를 입력하여 언제든지 전환하세요.

요금제 한눈에 보기

키 활성화

오프라인 유예 기간

앱은 6시간마다 라이선스를 확인합니다. 네트워크 문제가 있는 경우 최대 30일 동안 캐시된 상태(마지막으로 확인된 종료 날짜까지)로 계속 작동합니다. 라이선스 카드에 회색 오프라인 배지가 표시되지만 기능 손실은 없습니다.

상태 확인 위치

• 사이드바 카드 — 요금제 이름, 남은 일수, 종료 날짜
• 설정 → 라이선스 — 설정 페이지의 동일한 정보
• 상단 배너 — 라이선스가 없거나 만료된 경우 표시됨

계정

계정 페이지는 홈 베이스입니다. 다른 모든 것(수신자, 광고, 캠페인)은 현재 선택된 계정에 속합니다.

계정 그리드

각 계정은 다음을 보여주는 카드입니다:

• 이름 및 이니셜 배지
• 상태 — 승인됨(녹색) 또는 승인되지 않음(회색)
• 사용자 정보 — 텔레그램 표시 이름 및 @username
• 전화번호, 프록시 및 현재 세션 상태

현재 작업 중인 계정은 보라색 테두리와 오른쪽 상단 모서리에 현재 배지로 표시됩니다.

도구 모음

카드 작업

새 계정 추가

QR / SMS 인증

두 가지 방법. QR이 더 빠르고 전화번호 필드가 필요하지 않습니다 — SMS는 대체 수단입니다.

방법 선택

모든 계정에서 승인을 클릭하세요. 두 가지 옵션이 있는 대화 상자가 열립니다:

• QR 코드 — 권장. API ID + API Hash만 필요합니다.
• SMS 코드 — 계정 설정에 전화번호가 필요합니다.

전화번호가 비어 있으면 SMS 옵션이 힌트와 함께 비활성화됩니다.

QR 로그인

SMS 로그인

세션 상태 확인 v4.0

앱은 귀하가 관리할 필요 없이 텔레그램 세션을 활성 상태로 유지합니다.

작동 방식

앱 시작 시 및 구성된 간격으로 앱은 모든 계정을 순회하며 세션이 살아 있는지 확인합니다. 빠른 작업입니다 — 계정당 한 번의 요청. QR이나 SMS가 필요하지 않으며 세션은 data/sessions/에서 로드됩니다.

확인은 백그라운드 스레드 풀(최대 3개 계정 병렬)에서 실행되므로 인터페이스가 응답성을 유지합니다.

상태 표시기

계정 페이지에서 각 카드의 이름 옆에 색상 점이 표시됩니다:

• 🟢 승인됨 — 세션 활성, 작업 준비 완료
• 🔴 승인되지 않음 — 세션 죽음, QR 재승인 필요
• 🟠 연결할 수 없음 — 네트워크 문제(인터넷 없음, 프록시 죽음). 세션은 아마 살아 있음 — 확인할 수 없었을 뿐
• ⚪ 구성되지 않음 — 계정에 API 자격 증명 없음
• 🟣 확인 중 — 확인 진행 중

활성화 및 구성

설정 → 세션 상태 확인으로 이동하세요:

수동 확인

계정 페이지의 도구 모음에서 세션 확인을 클릭하세요. 진행 상황은 점 표시기를 통해 확인할 수 있으며 버튼에는 확인 중… X/Y가 표시됩니다.

재승인 대기열

죽은 세션이 발견되면 앱이 하나씩 재승인을 제안합니다:

1. 프롬프트가 나타납니다: "N개의 죽은 세션을 찾았습니다. 지금 모두 재승인하시겠습니까?"
2. 예를 클릭하면 첫 번째 죽은 계정에 대한 QR 로그인 창이 열립니다
3. 휴대폰으로 QR을 스캔하세요. 해당 계정이 승인되면 다음 QR이 자동으로 열립니다
4. 대기열이 빌 때까지 프로세스가 계속됩니다
5. 요약 토스트가 표시됩니다: 재승인 완료: N개 성공, M개 실패

계정 상태 모니터 v4.0

지난 24시간의 실제 전송 활동을 기반으로 한 계정별 위험 지표.

열기

모든 계정 카드에서 방패 아이콘을 클릭하세요. 해당 계정의 상태 데이터가 포함된 모달이 열립니다.

표시되는 내용

위험 수준

권장 사항

모달에서 권장 사항을 클릭하면 현재 데이터를 기반으로 한 체크리스트가 표시됩니다. 예를 들어:

• PEER_FLOOD가 0보다 큰 경우 — 이 계정을 24~48시간 동안 일시 중지하세요
• 플러드가 빈번한 경우 — 메시지 간 지연을 늘리세요
• 24시간 동안 100회 이상 전송된 경우 — 일일 볼륨을 줄이세요
• 녹색 계정에는 "좋습니다, 하던 일을 계속하세요"가 표시됩니다

수신자

현재 계정에서 사용할 수 있는 그룹, 채널 및 연락처가 세 개의 열로 배치되어 있습니다.

도구 모음

세 개의 열

• 그룹 — 게시 권한이 있는 채팅 및 슈퍼그룹
• 채널 — 관리하는 방송 채널
• 연락처 — DM을 보낼 수 있는 사용자

항목 작업

• 확인란 — 개별 수신자 선택
• 헤더의 확인란 — 이 열의 모든 항목 선택 / 선택 취소
• 호버 시 삭제 버튼 — 로컬 목록에서 단일 수신자 제거(텔레그램에는 영향 없음)
• 추가 + — 단일 수신자를 수동으로 추가(정확한 이름 입력)
• 선택 항목 제거 — 선택한 모든 수신자 제거

선택 작업 표시줄

하나 이상의 항목이 선택되면 열 위에 보라색 작업 표시줄이 나타납니다:

• 그룹에 추가 — 선택 항목을 명명된 그룹으로 이동
• 그룹에서 제거 — 그룹 필터가 활성화된 경우에만 표시됨
• 삭제 — 선택한 수신자 완전히 제거
• 선택 취소 — 모든 항목 선택 취소

수신자 그룹 v4.0

"메인", "VIP", "테스트"와 같은 명명된 수신자 모음 — 광고에서 클릭 한 번으로 선택할 수 있습니다.

그룹 생성

그룹 관리

그룹 관리 대화 상자에서:

• 그룹 이름 변경 — 연필 아이콘
• 그룹 삭제 — 휴지통 아이콘. 수신자 자체는 목록에 남아 있습니다. 그룹 멤버십만 제거됩니다.
• 각 그룹 옆에 멤버 수 확인

수신자 보기 필터링

도구 모음의 그룹 필터 드롭다운을 사용하여 특정 그룹의 멤버만 표시합니다. 옵션:

• 모든 수신자 — 모든 것을 표시
• 그룹 없음 — 어떤 그룹에도 속하지 않은 수신자만
• 특정 그룹 이름

광고 편집기에서 그룹 선택

광고를 열고 → 수신자 탭으로 이동하세요. 세 개의 열 위에 그룹 칩 행이 표시됩니다:

• ○ 이름 — 12 — 선택되지 않음 (12개 사용 가능)
• ◐ 이름 — 5/12 — 부분적으로 선택됨
• ✓ 이름 — 12 — 완전히 선택됨 (녹색)

칩을 클릭하여 전체 그룹을 전환합니다. 다시 클릭하여 해당 그룹의 모든 항목을 선택 취소합니다.

CSV / Excel / JSON 가져오기 v4.0

스프레드시트, JSON 덤프 또는 다른 앱에서 내보낸 CSV에서 수신자 목록을 대량으로 로드합니다.

지원 형식

• CSV — 구분 기호(;, , 또는 탭) 자동 감지
• Excel — .xlsx 및 .xlsm (대화형 열 매핑 대화 상자 포함)
• JSON — 객체 목록 또는 group/channel/contact 키가 있는 사전

CSV 형식

두 개 또는 세 개의 열: type, name 및 선택적 group.

type;name;group
group;마케팅 채팅;메인
channel;@my_channel;메인
contact;홍길동;
group;테스트 채팅;테스트

유형은 영어 및 러시아어 동의어를 허용합니다:

• group, groups, 그룹
• channel, channels, 채널
• contact, contacts, 연락처, 사용자

JSON 형식

허용되는 두 가지 형태:

[
  { "type": "group",   "name": "마케팅 채팅", "group": "메인" },
  { "type": "channel", "name": "@my_channel",   "group": "메인" }
]

또는 유형별로 그룹화:

{
  "group":   ["마케팅 채팅", "테스트 채팅"],
  "channel": ["@my_channel"],
  "contact": ["홍길동"]
}

Excel 열 매핑

.xlsx 파일을 가져오면 매핑 대화 상자가 나타납니다:

• 유형 열 — group/channel/contact이 포함된 열
• 이름 열 — 실제 수신자 이름이 포함된 열
• 그룹 열 — 각 수신자에 할당할 선택적 명명된 그룹

앱은 헤더 이름("type", "name", "group" 및 러시아어 해당 항목)을 기반으로 자동 추측합니다. 실시간 미리보기는 구문 분석될 처음 4개 행을 보여줍니다.

가져오기 미리보기

구문 분석 후 요약이 표시됩니다:

• 신규 — 추가될 새 행 수
• 중복 — 목록에 이미 존재하는 행 수
• 오류 — 구문 분석 문제, 줄 번호 포함
• 감지된 그룹 — 파일에서 찾은 그룹 이름

병합 vs 교체

• 병합 — 새 수신자를 추가하고 중복을 건너뛰며 기존 항목은 그대로 둡니다
• 교체 — 현재 목록을 지우고 파일에 있는 항목만 사용합니다(추가 확인 대화 상자가 나타남)

CSV로 내보내기

도구 모음에서 CSV 내보내기를 클릭하세요. 파일은 다음과 같이 저장됩니다:

• UTF-8 BOM 인코딩 — Excel에서 비ASCII 텍스트를 올바르게 엽니다
• 세미콜론 구분 기호
• 항목이 속한 모든 수신자 그룹을 나열하는 선택적 그룹 열

기본 파일 이름: recipients_AccountName_20261016_143052.csv.

광고 개요

광고 페이지에는 현재 계정의 모든 예약된 메시지가 나열되며 각각에 대한 실시간 제어를 제공합니다.

레이아웃

두 개의 패널로 분할:

• 왼쪽 — 실행 중/일시 중지됨/중지됨 표시가 있는 광고 목록
• 오른쪽 — 선택한 광고의 세부 정보

목록의 표시

• ▶ — 실행 중
• ⏸ — 일시 중지됨
• ⏹ — 중지됨

도구 모음 작업

세부 정보 패널

선택한 광고의 콘텐츠 요약, 간격, 시간대, 수신자 수, 지연 시간 및 — 실행 중일 때 — 실시간 진행률 표시줄을 보여줍니다.

제어 버튼:

• 시작 — 전송 시작
• 일시 중지 / 재개 — 상태를 잃지 않고 일시적으로 중단
• 중지 — 완전히 취소(실행 중인 주기가 즉시 중단됨)
• 편집, 복제, 삭제

새 광고 만들기

새 광고를 클릭하여 편집기를 엽니다. 편집기에는 네 개의 탭이 있습니다:

1. 콘텐츠 — 텍스트, 미디어, 로테이션, 체인
2. 수신자 — 그룹, 채널, 연락처, 포럼 주제
3. 일정 — 간격, 시간대, 요일, 지연 시간, 자동 중지
4. 고급 — 전송 제한, 템플릿

각 탭은 아래의 자체 섹션에서 다룹니다.

광고 편집기 — 콘텐츠

메시지를 작성합니다. 세 가지 모드: 단일 메시지, 콘텐츠 로테이션 및 메시지 체인.

모드 1 — 단일 메시지

기본 모드. 메시지 텍스트를 입력하고 선택적으로 미디어를 첨부합니다. 변수가 지원됩니다(아래 참조).

모드 2 — 콘텐츠 로테이션

로테이션 사용을 활성화하여 여러 변형을 정의합니다(전용 로테이션 섹션 참조).

모드 3 — 메시지 체인

메시지 체인을 활성화하여 다단계 시나리오로 전환합니다(전용 체인 섹션 참조).

메시지 필드

여러 줄 텍스트, HTML 서식 및 동적 변수를 지원합니다:

구독자 캠페인(DM)에서는 다음 사용자 변수도 사용할 수 있습니다:

• {name} — 전체 이름
• {first_name}, {last_name} — 이름의 일부
• {username} — @username이 있는 경우

미디어

파일 추가를 클릭하여 사진, 비디오 또는 문서를 첨부합니다. 여러 파일(최대 10개)은 텔레그램 앨범으로 전송됩니다.

• 파일은 기본 이름과 호버 삭제 버튼과 함께 나열됩니다
• 텔레그램이 허용하는 모든 파일 유형: JPG, PNG, MP4, MOV, ZIP, PDF 등
• 미디어는 메시지당 업로드됩니다 — 표준 전송 지연 외에는 속도 제한 문제가 없습니다

저장된 메시지에서 전달

텍스트를 작성하는 대신 기존 저장된 메시지(또는 전체 앨범)를 전달할 수 있습니다:

미리보기 및 테스트 전송

편집기 하단:

• 미리보기 — 날짜/시간 변수 대체와 함께 텔레그램에서 보일 메시지를 보여줍니다
• 테스트 전송 — 첫 번째 선택한 수신자에게 메시지를 한 번 보냅니다. 긴 캠페인을 시작하기 전에 사용하세요.

콘텐츠 로테이션 v4.0

여러 텍스트 및 미디어 변형을 정의합니다. 각 수신자는 다른 변형을 받습니다 — 스팸 패턴 감지를 극적으로 줄여줍니다.

로테이션 활성화

페어링 규칙

로테이션 모드

변형별 미디어

각 변형에는 고유한 미디어 목록이 있습니다. 해당 변형에 특정한 미디어를 첨부하려면 변형 아래의 파일 추가를 클릭하세요. 변형에 미디어가 없으면 텍스트 전용 메시지로 전송됩니다.

체인 내에서 로테이션 사용

로테이션은 체인 내에서도 작동합니다 — 각 단계에는 고유한 로테이션 사용 토글이 있을 수 있습니다. 1단계는 3개의 텍스트 변형을 무작위로 보낼 수 있고, 2단계는 로테이션이 없을 수 있으며, 3단계는 5개의 다른 이미지를 순환할 수 있습니다. 각 단계의 카운터는 독립적입니다.

메시지 체인 v4.0

단일 광고를 다단계 대화로 전환하세요 — 설정 가능한 일시 중지와 함께 2~5개의 메시지가 연속으로 전송됩니다.

체인 활성화

각 단계에는

• 텍스트 — 별도의 메시지 본문
• 미디어 — 별도의 첨부 파일(사진, 비디오, 문서)
• 선택적 로테이션 — 단계 내에서 여러 변형을 정의하는 단계별 토글
• 이후 지연 — 다음 단계를 보내기 전에 대기할 시간(초) (마지막 단계 이후가 아닌 단계 사이에만 표시됨)

단계 관리

• 단계 추가 — 끝에 새 빈 단계 추가
• ↑ / ↓ 화살표 — 단계 재정렬(첫 번째/마지막에서는 비활성화됨)
• X — 단계 삭제(최소 한 단계는 남아 있어야 함)

단계별 로테이션

모든 단계 내에서 로테이션 사용을 활성화하여 해당 단계에 대한 여러 텍스트+미디어 변형을 정의합니다. 로테이션 모드(임의/순환)는 단계별로 별도입니다.

타임라인 미리보기

미리보기를 클릭하면 각 단계 콘텐츠 버블과 그 사이의 일시 중지 표시기가 포함된 번호가 매겨진 타임라인으로 전체 체인을 볼 수 있습니다.

실제 예시 — 웜업 시퀀스

구독자 캠페인의 경우 3단계 체인은 다음과 같이 작동합니다:

일정

광고가 언제 얼마나 자주 실행되는지 제어합니다. 두 가지 예약 모드와 시간대, 요일 및 자동 중지 보호.

예약 모드

간격 모드

간격을 분 단위로 설정합니다. 최소 권장 사항: 채널의 경우 180, 절대 하한은 60. 그 이하에서는 텔레그램이 FloodWait으로 응답하기 시작합니다.

고정 시간 모드

하루 중 하나 이상의 시간(HH:MM)을 추가합니다. 앱은 다음 예약 실행을 계산합니다 — 하루의 모든 시간이 지난 경우 다음 날의 첫 번째 시간이 사용됩니다.

시간대

특정 시간(예: 업무 시간)으로 전송을 제한합니다. 야간 시간대도 작동합니다(22:00 → 06:00).

요일

월요일부터 일요일까지 7개의 확인란. 선택한 요일만 전송이 허용됩니다. 앱이 실행 중이지만 현재 요일이 선택 취소된 경우 "잘못된 요일"을 기록하고 기다립니다.

메시지 간 지연

초 단위의 임의 범위. 각 수신자에 대해 최소값과 최대값 사이에서 균일하게 지연이 추출됩니다.

자동 중지 보호

자동 중지가 발동하면 어떻게 되나요

1. 캠페인이 즉시 중지됩니다
2. 로그 항목이 나타납니다: "자동 중지: 5번의 연속 오류. 'X' 광고 중지됨."
3. 텔레그램 알림이 활성화된 경우 저장된 메시지로 보고서를 받습니다
4. 광고는 목록에 남아 있습니다 — 문제를 수정하고 다시 시작하세요

포럼 주제

선택한 그룹이 텔레그램 포럼(주제 포함)인 경우 특정 주제로 보내거나 메인 채팅으로 보낼 수 있습니다.

주제 구성

전송 시 발생하는 일

포럼인 각 수신자 그룹에 대해 앱은 확인된 각 주제에 별도의 메시지를 보냅니다. 한 그룹에서 3개의 주제를 확인하고 동일한 그룹이 다른 광고에도 선택된 경우, 주제는 이 광고에만 적용됩니다.

수신자 계산

광고 세부 정보의 "총 수신자" 수에는 주제 분할이 포함됩니다. 3개의 주제가 선택된 단일 그룹은 3명의 수신자로 계산됩니다.

메인 채팅

항상 사용 가능합니다. 메인 채팅만 확인하면 — 주제 없음 — 메시지는 일반 피드로만 전송됩니다.

구독자 캠페인 (DM)

모든 그룹이나 채널에서 참가자를 수집한 다음 개인화된 다이렉트 메시지를 보냅니다.

작동 방식

1. 소스를 지정합니다 — 액세스할 수 있는 그룹 또는 채널
2. 앱이 참가자 목록을 가져옵니다(필터 포함)
3. 각 참가자에게 개인화된 DM을 보냅니다
4. 진행 상황이 추적됩니다 — 동일한 사용자는 메시지를 두 번 받지 않습니다

캠페인 생성

참가자 미리보기

모든 캠페인에서 미리보기를 클릭하세요. 대상이 될 사용자 목록(이름, @username 및 사용자 ID 포함)이 포함된 창이 열립니다. 시작하기 전에 필터가 예상대로 작동하는지 확인하세요.

캠페인 실행

시작을 클릭하세요. 첫 번째 패스가 즉시 실행됩니다. 라이브 통계가 정보 패널에 나타나며 매초 업데이트됩니다:

• 전송됨 — 전달된 메시지
• 건너뜀 — 사용자 이름이 없거나, 개인 정보 보호, 비활성화됨, 봇인 사용자
• 실패함 — 오류(보통 개인 정보 보호 또는 플러드)
• 추적됨 — 이미 메시지를 받은 총 고유 사용자 수

건너뛰기 조건

텔레그램이 반환할 때 사용자는 조용히 건너뜁니다(건너뜀으로 계산됨):

• 개인 정보 보호 제한 — "사용자가 낯선 사람의 메시지를 받지 않음"
• 상호 연락처 아님
• 비활성화된 계정
• 사용자에 의해 차단됨

진행 상황 재설정

"이미 전송됨" 목록을 지우려면 재설정을 클릭하세요. 동일한 캠페인을 다시 보내려는 경우 사용하지만 메시지를 의미 있게 변경한 후에만 사용하세요.

완료 이유

그룹 조이너

설정 가능한 지연과 함께 링크 목록에서 그룹 및 채널에 대량 가입합니다.

링크 준비

텍스트 영역에 링크를 한 줄에 하나씩 붙여넣습니다. 지원되는 형식:

• https://t.me/joinchat/XXXXX — 비공개 초대 링크
• t.me/username — 공개 그룹 또는 채널
• @username — 공개
• +invite_hash — 비공개 초대

가입 간 지연

권장: 10~30초. 낮은 값은 매우 빠르게 FloodWait 오류로 이어집니다. 기본 5초는 공격적입니다 — 최소 15초를 원할 것입니다.

조이너 실행

1. 링크를 붙여넣거나 파일에서 로드를 클릭하여 .txt를 가져옵니다
2. 지연 설정
3. 가입 시작 클릭

앱이 링크를 하나씩 처리합니다:

• 진행률 표시줄에 현재 위치가 표시됩니다
• 각 시도는 이벤트 로그에 기록됩니다
• 아래에 ✓ / ✗ 표시기가 있는 라이브 결과 목록이 나타납니다
• 최종 토스트 표시: N개 성공, M개 실패

목록 저장

링크 목록은 세션 간에 localStorage에 자동으로 저장됩니다. 백업을 위해 .txt로 내보내려면 파일에 저장을 클릭하세요.

스토리 캠페인

일정에 따라 텔레그램 스토리를 자동으로 게시합니다. 계정에 텔레그램 프리미엄이 필요합니다.

스토리 캠페인 생성

캠페인 실행

캠페인을 선택하고 시작을 클릭합니다. 앱:

• 계정에 프리미엄이 있는지 확인합니다
• 미디어 파일이 존재하는지 확인합니다
• 첫 번째 스토리를 즉시 게시합니다
• 지정된 간격으로 후속 스토리를 예약합니다

미디어 요구 사항

자동 응답 Enterprise

키워드 일치를 기반으로 수신되는 비공개 메시지에 자동으로 응답합니다. Enterprise 요금제 전용.

기능

앱은 현재 계정의 모든 수신 비공개 메시지를 주시합니다. 메시지가 규칙의 조건과 일치하면 구성된 작업이 발생합니다.

규칙 생성

일치 유형

작업

규칙 테스트

활성화된 응답 규칙에서 테스트를 클릭하세요. 앱이 응답 텍스트를 자신의 저장된 메시지로 보냅니다 — 변수 대체와 함께 어떻게 렌더링되는지 정확히 확인하는 데 유용합니다.

규칙 발동 방식

• 수신 메시지가 구문 분석됩니다
• 규칙이 순서대로 확인됩니다. 첫 번째 일치가 승리합니다
• 대기 시간 확인이 발생합니다 — 동일한 사용자는 대기 시간보다 더 자주 자동 응답을 받을 수 없습니다
• 작업이 응답이고 지연이 설정된 경우 앱이 해당 시간(초)을 기다린 후 전송합니다

통계 v4.0

전체 분석 대시보드: 요일 및 시간별 활동, 상위 타겟, 상위 오류, CSV 내보내기가 포함된 최근 이벤트.

필터

KPI 카드

• 전송됨 — 성공적인 전송(녹색)
• 오류 — 심각한 오류(빨간색)
• 플러드 — FloodWait 이벤트(노란색)
• 비율 — 전송됨 / (전송됨 + 오류 + 플러드) 비율
• 조회수 — 추적된 채널 메시지의 총 조회수

차트

일별 활동 — 일별 전송된 막대 차트, 오류 선 오버레이 포함.

시간별 활동 — 하루 중 시간별 전송된 막대 차트. 최적의 전송 시간대를 파악하는 데 유용합니다.

상위 타겟

전송 횟수, 오류 횟수 및(채널의 경우) 총 조회수 배지가 포함된 가장 많이 사용된 상위 10개 수신자.

상위 오류

빈도별 상위 10개 오류 유형. 체계적인 문제를 이해하는 데 유용합니다:

• not_found — 수신자가 더 이상 존재하지 않음
• privacy — 사용자 개인 정보 보호 제한
• peer_flood — 텔레그램의 강제 중지 신호
• flood_wait — 속도 제한 도달
• 반환된 특정 오류에 따라 기타

최근 이벤트

타임스탬프, 캠페인 이름, 타겟 및 상태 알약이 포함된 최근 30개 이벤트. KPI와 동일한 기간/계정/캠페인으로 필터링됩니다.

채널 조회수 추적

귀하의 계정이 관리자인 방송 채널의 경우 앱이 백그라운드에서 조회수를 자동으로 가져옵니다. 최대 7일 된 메시지에 대해 10분마다 새로 고침됩니다.

CSV 내보내기

CSV 내보내기를 클릭하여 현재 필터와 일치하는 모든 이벤트를 CSV 파일로 저장합니다(최대 100,000개 행). 열:

timestamp;account_id;campaign_name;campaign_type;target_name;target_kind;status;error_kind;views

보존

통계는 SQLite에 로컬로 저장됩니다. 90일보다 오래된 이벤트는 매일 백그라운드 작업에 의해 자동으로 제거됩니다. 필요한 경우 구성에서 보존 기간을 변경하세요.

이벤트 로그

앱이 수행하는 모든 작업이 여기에 기록됩니다. 캠페인을 모니터링하고 문제를 진단하는 데 사용하세요.

이벤트 유형

• INFO (파란색) — 일상적인 이벤트: 메일링 시작됨, 메시지 전송됨, 캠페인 완료됨
• WARNING (주황색) — 잠재적 문제: 짧은 간격, 느린 네트워크, 건너뛴 사용자
• ERROR (빨간색) — 실제 실패: 엔터티를 찾을 수 없음, 권한 없음, PEER_FLOOD

필터

카운터

로그 본문 위에 라이브 카운터가 표시됩니다:

• 총계 — 표시되는 모든 이벤트
• 전송됨 — 성공적인 전송
• 경고 — 경고
• 오류 — 오류

내보내기

• TXT 내보내기 — 일반 텍스트, 한 줄에 하나의 이벤트
• CSV 내보내기 — 타임스탬프, 수준, 종류, 무음 플래그, 계정, 메시지로 구조화됨. Excel용 UTF-8 BOM.

모두 복사

필터링된 모든 이벤트를 동일한 TXT 형식으로 클립보드에 복사합니다. 지원 티켓에 붙여넣는 데 유용합니다.

지우기

표시되는 버퍼와 메모리 내 목록을 지우려면 지우기를 클릭하세요. 디스크의 파일 로그(data/logs/app.log)는 영향을 받지 않습니다.

설정

한 페이지의 모든 전역 구성.

일반

글로벌 프록시

자체 프록시가 없는 모든 계정에서 사용하는 단일 프록시. 필드: 유형(SOCKS5 / SOCKS4 / HTTP), 호스트, 포트, 선택적 사용자 이름 및 비밀번호.

• 저장 — 구성을 작성합니다
• 테스트 — api.ipify.org를 통해 이 프록시를 통한 외부 IP를 확인합니다. 결과는 토스트로 나타납니다.
• 지우기 — 모든 필드를 재설정하고 글로벌 프록시를 제거합니다

글로벌 시간대

계정 전체의 모든 광고 및 캠페인에 적용되는 단일 전송 창. 활성화되면 광고별 설정을 재정의합니다.

자동 시작

• 승인 후 모든 광고 자동 시작 — 계정이 승인되면 해당 계정의 모든 광고가 즉시 시작됩니다

세션 상태 확인

세션 상태 확인 섹션에서 자세히 다룹니다:

• 시작 시 확인 활성화
• 자동 확인 간격(분, 0 = 비활성화)
• 죽은 세션 자동 재승인

텔레그램 알림

아래 전용 섹션을 참조하세요.

라이선스

현재 요금제, 남은 일수, 종료 날짜를 보여줍니다. 활성화 대화 상자를 다시 여는 버튼.

데이터 & 로그

• 저장소 통계 — 총 데이터 크기, 계정, 수신자, 캠페인 카운터
• 로그 폴더 열기 — 파일 관리자에서 data/logs/를 엽니다
• 백업 내보내기 — 전체 프로필을 ZIP으로
• 백업 가져오기 — 미리보기 대화 상자와 함께 ZIP에서 복원
• 업데이트 확인 — 수동 업데이트 확인
• 디버그 — 업데이트 하위 시스템 상태의 JSON 덤프를 표시합니다(지원에 유용)

위험 구역

• 설정 초기화 — 프록시, 시간대, 자동 시작, 세션 확인 및 알림 설정을 기본값으로 지웁니다
• 계정 지우기 — 모든 계정과 세션을 삭제합니다. 먼저 확인 대화 상자.

텔레그램 알림

텔레그램에서 바로 캠페인 보고서를 받습니다 — 저장된 메시지나 모든 채팅으로.

활성화

테스트

테스트 알림 보내기를 클릭하세요. 첫 번째 승인된 계정을 사용하여 선택한 대상으로 테스트 메시지를 보냅니다. 승인된 계정이 없으면 명확한 오류가 표시됩니다.

전달되는 이벤트

모든 알림에는 서식이 지정된 요약이 포함됩니다. 일반적인 캠페인 완료 보고서는 다음과 같습니다:

✅ 메일링 완료

📣 캠페인: 프로모
📤 전송됨: 45
❌ 오류: 2

⏱ 소요 시간: 12분
🕐 14:30 — 14:42

전체 프로필 백업 v4.0

구성, 데이터베이스, 세션, 광고, 캠페인 및 통계를 단일 ZIP 파일로 내보내는 원클릭.

포함된 내용

• config.json — 모든 설정, 라이선스 키 캐시
• autoposter.db — 계정, 수신자, 광고, 스토리, 구독자, 템플릿, 자동 응답 규칙, 통계
• sessions/*.session — 텔레그램 세션 파일(선택 사항, 아래 참조)
• templates/ — 템플릿 폴더 데이터

제외된 내용

• logs/ — 로그 파일
• exports/ — 내보낸 CSV 파일
• backups/ — 이전 백업
• WAL/SHM SQLite 임시 파일

내보내기

가져오기

업데이트

앱은 시작 시 새 버전을 확인하고 사용 가능한 경우 변경 내역 창을 제공합니다.

자동 확인

시작 후 2.5초 후 업데이트 서버로 작은 요청이 전송됩니다. 더 새로운 버전이 있으면 분류된 항목(기능, 수정, 개선, 보안)이 포함된 변경 내역 대화 상자가 나타납니다.

업데이트 대화 상자

• 다운로드 — 브라우저에서 다운로드 페이지를 엽니다
• 나중에 알림 — 대화 상자가 닫히고 다음 실행 시 다시 표시됩니다
• 이 버전 건너뛰기 — 이 특정 버전을 다시 표시하지 않습니다(더 새로운 버전이 나오면 대화 상자가 다시 나타남)

수동 확인

두 가지 방법:

• 상단 표시줄의 다운로드 아이콘
• 설정 → 데이터 & 로그 → 업데이트 확인

디버그 정보

설정 → 디버그는 현재 버전, 서버 응답 및 업데이트가 트리거될지 여부가 포함된 JSON 덤프를 보여줍니다. 지원 티켓을 열 때 유용합니다.

데이터 & 폴더

모든 것은 하나의 폴더에 저장됩니다. 그것을 이해하면 앱을 이해할 수 있습니다.

폴더 위치

내부 내용

자동 백업

설정이나 캠페인을 저장할 때마다 이전 config.json이 타임스탬프와 함께 backups/에 복사됩니다. 최근 5개만 유지됩니다.

수동으로 구성 백업 복원

1. 앱 닫기
2. data/backups/를 열고 원하는 사본을 찾습니다
3. 이름을 config.json으로 바꾸고 현재 파일을 교체합니다
4. 앱 재시작

새 컴퓨터로 마이그레이션

1. 전체 data/ 폴더(또는 macOS 해당 항목)를 USB 스틱에 복사합니다
2. 새 컴퓨터에 앱을 설치합니다
3. 한 번 닫습니다(빈 data/ 폴더가 생성됨)
4. 새 data/ 폴더를 스틱에 있는 폴더로 교체합니다
5. 실행 — 모든 것이 보존됩니다

문제 해결

가장 일반적인 문제에 대한 빠른 답변.