msnp-wiki/docs/commands/pag.md
yellows111 4bf934f857
[v0.1.4-beta.2] everything i want before msnp13
update version file, forgot this repo had one
fix mistakes and other such
add new information
finish passport (SOAP) stuff, may rename to RST later?, just mention in footnote for now

next commit WILL be msnp13 on 0.1.4 release, promise
2024-11-26 21:15:34 +00:00

2.3 KiB

Introduction

PAG is a command introduced with MSNP5.

It is a Notification Server command, with a request payload.

It sends a text message to a mobile device or pager. For the version of this command that supports Web Watches, read PGD. For the command that is sent when you receive a page, read IPG.

Client/Request

PAG TrID user-handle length
payload

Where user-handle is the target user for this page.

Where length is the size (in bytes) of the payload.

Where payload is a XML-like payload that encodes the following characters:

  • & turns into &
  • ; turns into &#x3B;
  • < turns into &#x3C;
  • > turns into &#x3E;
  • ^ turns into &#x5E;

Server/Response

This command only supports negative-acknowledgement responses only. There is no postive acknowledgement response.

Examples

Sending without a callback number

C: PAG 1 anotheruser@hotmail.com 61
<TEXT xml:space="preserve">This is an example message.</TEXT>

Sending with a home callback number

NOTE: The number used was 1 (555) 111-4444.

C: PAG 2 anotheruser@hotmail.com 149
<PHONE pri="1"><LOC>HOME</LOC><NUM>15551114444</NUM></PHONE><TEXT xml:space="preserve">This is an example message with a home callback number.</TEXT>

Sending with a work callback number

NOTE: The number used was 1 (555) 222-5555.

C: PAG 3 anotheruser@hotmail.com 149
<PHONE pri="1"><LOC>WORK</LOC><NUM>15552225555</NUM></PHONE><TEXT xml:space="preserve">This is an example message with a work callback number.</TEXT>

Sending with a mobile callback number

NOTE: The number used was 1 (555) 333-6666.

C: PAG 4 anotheruser@hotmail.com 153
<PHONE pri="1"><LOC>MOBILE</LOC><NUM>15553336666</NUM></PHONE><TEXT xml:space="preserve">This is an example message with a mobile callback number.</TEXT>

Failed to send

This error may be a generic server error.

C: PAG 5 anotheruser@hotmail.com 61
<TEXT xml:space="preserve">This is an example message.</TEXT>
S: 800 5

Removed

Since MSNP9.

C: PAG 6 anotheruser@hotmail.com 61
<TEXT xml:space="preserve">This is an example message.</TEXT>
S: 715 6

Known changes

  • MSNP9: Removed (error 715), use PGD instead.