넷시티 메시지&메일함메일빌더 플랫폼 기기 수신함 열기

DEVICE INBOX · GOTIFY

통신기기 수신함 사용 및 연동 안내

Gotify 서버를 연결하면 웹 콘솔에서 기기 메시지를 보내고, 통신기기의 Gotify 앱으로 알림을 받을 수 있습니다. 서버 주소와 토큰은 웹 서버 환경에 설정하며 브라우저에는 입력하지 않습니다.

발신 앱 토큰과 수신 클라이언트 토큰을 각각 설정합니다

두 토큰은 역할이 다릅니다. 앱 토큰은 푸시 전송, 클라이언트 토큰은 콘솔에서 메시지 목록을 읽는 데 사용합니다.

Gotify
01

통신기기에서 메시지 받기

Gotify 앱을 수신 기기에 연결합니다.

ANDROID · RECEIVER

Gotify 앱 설치

Android 기기에 Gotify 앱을 설치한 다음, 서버 주소 https://push.netcity.co.kr를 등록하고 Gotify 계정으로 로그인합니다.

Google Play에서 Gotify 앱 열기 ↗

WEB · CONSOLE

통신기기 수신함

왼쪽 메뉴의 기기 메시지함에서 제목, 내용, 우선순위를 작성해 전송합니다. 서버 메시지 목록은 대화 형식으로 표시되고 30초마다 새로고침됩니다.

기기 수신함 열기 ↗

수신과 답장은 별개입니다: Gotify 앱은 통신기기에서 알림을 받는 용도입니다. 앱 알림에서 이 웹 콘솔로 답장을 보내지는 않습니다. 기기에서 회신하려면 Gotify API에 메시지를 올리는 별도 앱이나 연동이 필요합니다.

02

Gotify 토큰 발급

Gotify 서버 관리 화면에서 서로 다른 종류의 토큰을 발급합니다.

전송용 앱 토큰Gotify의 Applications에서 애플리케이션을 만들고 해당 애플리케이션 토큰을 복사합니다. 이 값을 PUSH_APP_TOKEN에 설정합니다.
수신용 클라이언트 토큰Gotify의 Clients에서 클라이언트를 만들고 클라이언트 토큰을 복사합니다. 이 값을 PUSH_CLIENT_TOKEN에 설정합니다.
애플리케이션 ID애플리케이션 상세 화면의 숫자 ID입니다. 선택 항목 PUSH_APP_ID에 설정하면 콘솔이 해당 앱에서 보낸 메시지를 발신 말풍선으로 표시합니다.

앱 토큰과 클라이언트 토큰을 서로 바꿔 넣지 마세요. 토큰은 비밀번호처럼 취급하고 이 페이지, 소스 코드, 저장소, 브라우저 개발자 도구에 입력하거나 게시하지 마세요.

03

웹 서버 환경 변수 설정

PHP가 실행되는 Apache 또는 PHP-FPM 환경에 아래 값을 설정합니다.

PUSH_SERVER_URLGotify 서버의 HTTPS 기본 주소입니다. /message 경로는 붙이지 않습니다.
PUSH_APP_TOKENGotify 애플리케이션에서 발급한 전송용 토큰
PUSH_CLIENT_TOKENGotify 클라이언트에서 발급한 메시지 조회용 토큰
PUSH_APP_ID선택 항목. 발신 애플리케이션을 대화 목록에서 식별하는 숫자 ID
APP_USERNAME웹 메일·푸시 화면의 Basic 인증 계정
APP_PASSWORD웹 접근용 비밀번호. 16자 이상으로 설정합니다.
설정 예시
PUSH_SERVER_URL=https://push.netcity.co.kr
PUSH_APP_TOKEN=Gotify_애플리케이션_토큰
PUSH_CLIENT_TOKEN=Gotify_클라이언트_토큰
PUSH_APP_ID=애플리케이션_ID
APP_USERNAME=웹접근_계정
APP_PASSWORD=16자_이상의_비밀번호

위 값은 형식 예시입니다. 실제 비밀 값은 웹 공개 폴더 밖의 서버 환경 변수 관리 기능에 저장하세요. 변경 후 PHP-FPM 또는 Apache를 재시작해야 적용됩니다.

서버 URL은 HTTPS여야 하고, PHP 서버에서 Gotify 주소로 연결할 수 있어야 합니다. 이 사이트의 연결 상태 점검은 설정 유무만 확인하며 토큰 값을 표시하지 않습니다.

04

보내기와 수신 확인

환경 변수를 적용한 뒤 실제 기기에서 종단 간으로 확인합니다.

  1. 설정 점검: 푸시 연결 상태 점검에서 누락된 환경 변수와 보안 로그인 설정을 확인합니다.
  2. 수신 앱 로그인: Android Gotify 앱에 서버 주소를 등록하고 계정에 로그인합니다.
  3. 테스트 전송: 기기 메시지함에서 테스트 제목과 메시지를 보내고 수신 기기에 알림이 도착하는지 확인합니다.
  4. 대화 목록 확인: 전송한 항목은 발신 앱 ID가 설정되어 있으면 보낸 메시지로 표시됩니다. 클라이언트 토큰이 읽을 수 있는 다른 Gotify 메시지도 목록에서 확인할 수 있습니다.

수신 목록은 Gotify 서버에 저장된 메시지 피드를 보여줍니다. 이 화면의 “받기”는 문자나 이메일 수신을 뜻하지 않으며, Gotify 서버에 메시지를 올리는 송신 주체가 있어야 목록에 나타납니다.

?

연결 문제 해결

오류 메시지와 환경 변수 역할을 먼저 확인하세요.

설정 누락 표시환경 변수 이름과 PHP 실행 계정의 적용 여부를 확인한 뒤 웹 서버 프로세스를 재시작합니다.
401 또는 403전송에는 애플리케이션 토큰, 목록 조회에는 클라이언트 토큰을 사용했는지 확인하고 토큰을 재발급합니다.
연결 또는 TLS 오류서버에서 Gotify 주소에 접속할 수 있는지, HTTPS 인증서가 유효한지, 방화벽에서 연결을 막지 않는지 확인합니다.
목록에 메시지가 없음같은 Gotify 서버에 메시지가 전송되었는지와 클라이언트 토큰의 계정·권한을 확인합니다. 푸시 알림 자체와 서버 메시지 보관은 별개입니다.