bluebubbles은(는) 무엇을 하나요?
BlueBubbles를 통해 iMessage를 보내고 관리합니다. 첨부 파일, 탭백, 편집, 답장 및 그룹을 지원합니다.
개요
이 스킬을 사용하면 AI 에이전트가 BlueBubbles 서버와 통신하여 iMessage를 보내고 받을 수 있습니다. 메시지 전송, 탭백(반응), 편집, 답장, 스레드 보기, 그룹 채팅 관리 등이 가능합니다.
필수 조건
- 실행 중인 BlueBubbles 서버 (iOS 기기 또는 macOS에서 호스팅)
- BlueBubbles 서버 URL (예:
http://192.168.1.100:3000또는https://your-domain.com) - BlueBubbles API 키 (설정 → API 키에서 생성)
- 발신자 핸들 (iMessage에 등록된 전화번호 또는 Apple ID)
설정
스킬을 사용하려면 다음 환경 변수를 설정하세요:
export BLUEBUBBLES_SERVER_URL="http://192.168.1.100:3000"
export BLUEBUBBLES_API_KEY="your-api-key"
export BLUEBUBBLES_SENDER_HANDLE="+1234567890"
사용법
메시지 보내기
BlueBubbles를 사용하여 +1234567890으로 "안녕하세요!"라고 메시지를 보내세요.
첨부 파일 보내기
로컬 파일 ~/Documents/photo.jpg를 첨부하여 +1234567890으로 보내고 "이 사진 좀 봐!"라고 메시지를 보내세요.
탭백 보내기
마지막으로 받은 메시지에 좋아요 탭백을 보내세요.
메시지 편집
마지막으로 보낸 메시지를 "업데이트된 내용입니다"로 편집하세요.
그룹 채팅
BlueBubbles를 사용하여 +1111111111, +2222222222, +3333333333으로 그룹 채팅을 만들고 "단체 채팅에 오신 걸 환영합니다!"라고 보내세요.
지원되는 작업
| 작업 | 설명 |
|---|---|
| 메시지 보내기 | 단일 또는 여러 수신자에게 텍스트 메시지 전송 |
| 첨부 파일 보내기 | 이미지, 비디오, 오디오, 문서 등의 첨부 파일 전송 |
| 탭백 보내기 | 좋아요, 싫어요, 하하, 강조, 축하, 물음표 등 반응 추가 |
| 메시지 편집 | 보낸 iMessage 편집 |
| 메시지에 답장 | 특정 메시지에 스레드 답장 |
| 그룹 생성 | 여러 참가자로 그룹 채팅 생성 |
| 받은 메시지 보기 | 대화방의 최근 메시지 조회 |
| 메시지 삭제 | 보낸 iMessage 삭제 |
참고 사항
- iMessage 프로토콜은 BlueBubbles 서버를 통해 라우팅되므로 안정적인 연결이 필요합니다.
- 첨부 파일은 전송 전에 Base64로 인코딩됩니다.
- 탭백은 서버가 지원하는 표준 Apple 이모지로 제한됩니다.
- 메시지 편집 및 삭제는 전송 후 제한된 시간 내에만 가능합니다.
- 발신자 핸들은 iMessage에 등록된 전화번호 또는 Apple ID여야 합니다.
문제 해결
- 연결 오류: BlueBubbles 서버가 실행 중이고 네트워크에서 접근 가능한지 확인하세요.
- 권한 오류: API 키가 유효하고 필요한 권한이 있는지 확인하세요.
- 메시지 전송 실패: 발신자 핸들이 올바르고 iMessage에 활성화되어 있는지 확인하세요.