🔗메신저 메시지 전송 가이드

POST API 문서

API 개요

이 문서는 오피스넥스트-메신저에 메시지를 전송하는 API의 사용 방법을 설명합니다.

기본 정보

Method: POST

Content-Type: application/json

주소

https://api.officewave.co.kr/api/v1/hooks/{token}/messages

요청 헤더

헤더명	설명	필수여부

요청본문

{
    "to": ["[e-mail]", "[e-mail]", "[e-mail]"],
    "important": true,
    "content":"안녕하세요.메시지 보내드립니다."
}

요청 파라미터 설명

파라미터	타입	설명	필수여부
to	array	받는사람(이메일 또는 로그인 계정)	필수
important	boolean	중요도 표	옵션
content	string	메시지 내용	필수

응답

{
    "id": "61f2a3eeb6b55776d1070a8e",
    "type": "message",
    "user_id": 1,
    "contents": "eJx7O6vnTfeCN3Nb3k6d8XrlFoU3cye+7t76dmrL68lzXm1oUC,
    "strip_contents": "안녕하세요. 메시지 보내드립니다.",
    "attached_file": false,
    "important": true,
    "sent_at": "2025-01-27 22:53:50+0900",
    "reserved_at": null,
    "compressed": true,
    "deleted_at": null,
    "created_at": "2025-01-27 22:53:50+0900",
    "files": [],
    "recipients": 
    [
        {
            "user_id": 2,
            "read_at": null
        },
        {
            "user_id": 1,
            "read_at": null
        }
    ],
    "cc_users": [],
    "hidden_cc_users": []
}

응답 필드 설명

필드	타입	설명
id	string	메시지ID
type	string	메시지유형
user_id	integer	보낸사람ID(봇)
contents	string	메시지 내용 압축 데이터
strip_contents	string	메시지 내용 태그 제거
attached_file	boolean	첨부파일포함 여부
important	boolean	중요도 표시
sent_at	string	메시지전송시간
reserved_at	string	메시지예약시간
compressed	boolean	메시지내용압축 여부
deleted_at	string	메시지삭제시간
created_at	string	메시지생성시간
files	array	메시지첨부파일 정보
recipients	array	메시지수신자들
cc_users	array	메시지참조자들
hidden_cc_users	array	메시지숨은참조자들

에러코드

상태 코드	설명
403	잘못된 요청
410	유효하지 않은 계약상태
422	요청 파라미터 유효성 실패