단축어와 자동화
Courier는 단축어 앱에 네 가지 액션을 제공합니다. 모두 앱과 같은 프로세스에서 실행됩니다 — 앱과 동일한 데이터, 동일한 구독자, 동일한 장부를 사용합니다.
사전 준비
주석/오디오 액션은 note 구독자에게 발행합니다 — 먼저 하나 설정해 두세요 (편집부 → 구독자, 종류 = 주석).
액션
주석 달기
주석 달기(text?, subscriber?) → 결과텍스트 주석을 전송합니다. 매개변수 없이 실행하면 입력을 요청하고, note 엔드포인트가 여러 개일 때는 구독자 이름을 전달해 목적지를 지정할 수 있습니다.
예시: 액션 버튼에 "일기 쓰기" 단축어 — 한 번 누르고, Siri로 받아쓰고, 끝입니다.
지금 발행
지금 발행(range?) → 발행된 항목 수앱을 여는 것과 같은 파이프라인을 실행합니다: 새 건강 데이터를 읽고, 자동 발행이 켜진 모든 구독자에게 발행하고, 몇 건이 나갔는지 반환합니다. 과거 데이터를 채우기 위한 날짜 범위를 선택적으로 지정할 수 있습니다.
예시: 오전 8시 아침 자동화 — 커피를 들고 자리에 앉을 때쯤이면 어젯밤 수면이 이미 노트에 들어가 있습니다.
데이터 읽기
데이터 읽기(date, kind) → JSON아무것도 발행하지 않고 특정 날짜의 운동 또는 수면에 대한 canonical JSON을 반환합니다 — 직접 차트를 만들거나, 다른 앱에 넘기거나, 파일 앱에 보관할 수 있습니다.
음성 생각
음성 생각(audio) → 결과오디오 파일을 받아, 설정된 전사 방식으로 전사한 뒤 그 텍스트를 주석으로 발행합니다.
예시: Apple Watch에서 음성 메모를 녹음해 이 단축어로 공유하세요.
참고
- 액션은 올바른 단축어 출력 값을 반환하므로 체인으로 연결할 수 있습니다 (예:
데이터 읽기→ 사전 값 가져오기 → 알림). - 단축어에서 실행한 발행 결과도 같은 발행 내역에 나타나고 같은 멱등성 키를 따릅니다 — 자동화가 중복을 만들 수 없습니다.