알림과 전달

Anyy는 상주 Gateway로 즉시 알림과 사용자 표시 메시지를 게시할 수 있습니다. 라우팅을 인식하므로 현재 사용자나 현재 채널 대화의 신뢰 출처를 대상으로 하며 임의 외부 연락처는 대상이 아닙니다.

두 메시지 작업

작업	내용과 라우팅
알림 (notify_user)	선택 제목이 있는 텍스트. delivery로 Gateway, 신뢰 출처, 지정 채널 기본 바인딩 선택. 첨부 입력 없음
메시지 (send_message)	텍스트와 지원 첨부. target은 current_user 또는 origin만 가능. delivery나 채널 선택 입력 없음

send_message의 current_user는 런타임 현재 경로를 사용합니다. 일반 Dashboard/TUI는 Gateway, 신뢰 채널 대화는 보통 원래 출처로 응답합니다. 명시적 origin에는 신뢰 채널 메타데이터가 필요합니다. 다른 플랫폼의 기본 바인딩을 선택하지 않습니다.

둘 다 감사 기록을 남깁니다. 전송은 비멱등적이므로 재시도하면 중복될 수 있습니다.

채팅 이력의 알림

대화와 연결된 독립 시스템 알림은 다른 대화로 전환·복귀하거나 새로 고쳐도 보입니다. 에이전트 응답이 아닌 System notification 카드를 유지합니다. 이전 알림은 대화 이력과 로드되고 재연결이 같은 알림 사본을 만들지 않습니다.

시스템 카드는 Pi 대화 메시지와 별도 표시 레코드입니다. 모델 컨텍스트에 들어가거나 선택 분기를 바꾸지 않습니다. 첨부 메시지는 기존 대화 표현을 가질 수 있으며 별도 시스템 카드로 중복하지 않습니다.

Anyy는 게시 전 보호 알림 본문에 별도 영속 소유자를 부여합니다. 전달 재시도 페이로드와 별개입니다. 완료 전달의 재시도 페이로드를 지워도 대화 이력은 지워지지 않습니다. 대화를 삭제하면 알림 이력도 함께 제거됩니다.

현재 구현으로 저장한 알림에 적용됩니다. 정확한 본문이 이미 해제된 이전 알림은 작업 상태·요약으로 신뢰성 있게 재구성할 수 없습니다. Heartbeat를 포함한 세션 연결 없는 프로필 실시간 이벤트는 대화별 이력 보장 밖입니다.

전달 대상

예약 작업과 텍스트 알림은 아래 라우팅 용어를 씁니다. none은 Dashboard/CLI 스케줄러 관리에서 가능하며 notify_user 대상은 아닙니다. 이 값은 send_message 대상 값이 아닙니다.

대상	의미
gateway	상주 Gateway 이벤트 스트림에 게시
origin	현재 채널 대화의 신뢰 출처로 반환
current_user_default	현재 사용자 기본 바인딩 결정. notify_user는 telegram 같은 delivery.channel 필요
none	사용자 결과를 전달하지 않음

플랫폼 이름을 임의 수신자 주소로 취급하지 않습니다. 구성·허가된 채널 바인딩이 경로를 결정해야 합니다.

전송 요청

예:

When this check finishes, notify me with the title “Backup verified” and a one-line result.

Send this summary back to the current Channel conversation.

구성 기본 바인딩으로 텍스트 전용 알림을 보내려면:

Notify my default Telegram binding with a short text summary of this result.

첨부는 보고서 아티팩트가 사용 가능한 신뢰 Telegram 대화에서 요청하세요.

Reply to this Telegram conversation with the generated report as an attachment.

첫 요청은 notify_user와 delivery: { target: "current_user_default", channel: "telegram" }을 사용할 수 있습니다. 첨부 요청은 신뢰 출처로 send_message를 씁니다. 현재 인터페이스는 Dashboard 요청에서 임의 선택 기본 Telegram 바인딩에 보고서를 첨부하게 하지 않습니다.

신뢰 출처나 기본 바인딩이 없으면 수신자를 추측하지 않고 경로 사용 불가를 보고합니다.

영수증과 전달 상태

게시 성공은 Anyy가 이벤트를 수락하고 전달 파이프라인에 발송했다는 증거입니다. 그 자체가 Telegram, 이메일, SMS 등 외부 서비스의 최종 수신 증거는 아닙니다.

메시지는 이후 어댑터 전달 진행을 반영하는 영수증을 만들 수 있습니다. 어댑터마다 확인 응답 지원 또는 발송만 보고하는 차이가 있습니다. 채널 상태뿐 아니라 원래 대화 시스템 카드, 백그라운드 하위, Cron 이력을 확인하세요. 실행 종료와 외부 전달은 별도 상태입니다.

확인 없이 재시도하지 마세요

불확실한 전송을 재시도하기 전에 영수증이나 채널 상태를 확인하세요. 첫 전송이 공급자에 도착했지만 확인이 늦으면 두 번째 전송이 중복됩니다.

첨부 파일

send_message 첨부는 현재 세션 범위에서 사용 가능해야 하고 현재/신뢰 출처 채널이 미디어 종류 지원을 선언해야 합니다. notify_user는 기본 채널 바인딩을 골라도 텍스트 전용입니다. 미지원 첨부는 조용히 버리지 않고 거부합니다.

기본 경로 구성

Dashboard → Channel 또는 anyy setup channel로 연결하고 발신자 정책/페어링을 검증·테스트하세요. 이후 예약 작업은 current_user_default와 전달 채널을 선택할 수 있습니다.

메시징 플랫폼과 예약 자동화를 참조하세요.

문제 해결

문제	해결
기본 경로 없음	현재 사용자 채널 바인딩 구성·검증
출처 전달 불가	신뢰 채널 대화에서 요청 시작
게시 성공인데 외부 메시지 없음	영수증, Gateway 상태, 채널 doctor 확인
메시지 중복	자동 재시도 중지 후 이전 영수증/이벤트 확인
첨부 거부	선택 채널이 지원하는 미디어 종류 사용