# Table of contents:
# Introduction
MSG is a command introduced with MSNP2.
It is a Notification and Switchboard Server command, WITH a request and WITH a response payload.
Used to transfer MIME-headered data to other parties, whenever that be you or other users.
# Client/Request
This command can only be sent in a Switchboard session.
MSG TrID [ U | N | A | D ] length
payload
# Acknowledgement Types
- U: Unacknowledged, no response is sent.
- A: Acknowledged, a ACK response is sent if the message was sent successfully to all users, or a NAK resposne the message was not sent to at least one user.
- N: Negative-Acknowledgement-Only, a NAK response is sent if the message was not sent successfully to least one user.
- S: Successful-Acknowledgement-Only. a ACK response is sent if the message if the message was sent successfully to all users. Used in invite-type messages since Client Version 6.0.
- D: Data, a version of Acknowledged that also has a response of error 282 if the message was poorly formatted.
Acknowledgement Type D is defined since MSNP9.
Where length is the size (in bytes) of the payload.
Where payload is the body of the message,
usually containing a MIME-Version header and a Content-Type.
For all Content-Type's, view the MIME types page.
# Server/Response
MSG user-handle friendly-name length
payload
Where user-handle is either the senders's handle,
or Hotmail, if sent from the Notification Server itself.
Where friendly-name is either the URL-encoded Friendly Name of the sender,
or Hotmail, if sent from the Notification Server itself.
Where length is the size (in bytes) of the payload.
Where payload is the body of the message,
usually containing a MIME-Version header and a Content-Type.
For all Content-Type's, view the MIME types page.
# Examples
# Client initiated
# Unacknowledged message
C: MSG 1 U 76
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
unacknowledged
# Acknowledged message
C: MSG 2 A 74
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
acknowledged
S: ACK 2
# Negative-Acknowledgement-Only message
C: MSG 3 N 86
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
negatively acknowledged?
S: NAK 3
# Successful-Acknowledgement-Only message
Since MSNP8
C: MSG 4 S 74
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
success-only
S: ACK 4
# Data message
Since MSNP9.
NOTE: It is unlikely that the server would allow anything that isn't the type of application/x-msnmsgrp2p.
C: MSG 5 D 74
MIME-Version: 1.0
Content-Type: application/octet-stream
data message
S: ACK 5
# Poorly formatted data message
Since MSNP9.
C: MSG 6 D 75
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
data message?
S: 282 6
# Invalid context (Notification Server)
Inherited from being an unimplemented command.
C: MSG 7 U 0
Server disconnects client.
# Server initiated
NOTE: If this was from the Notification Server, the user handle and display name are both likely be Hotmail.
For more information on the Content-Type' you may receive, view the MIME types page.
S: MSG example@hotmail.com example%20user 80
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
This is a message.