msnp-wiki/docs/commands/cal.md

1.4 KiB

Introduction

CAL is a command introduced with MSNP2.

It is a Switchboard Server command, without a response payload.

It invites ("calls") a user to a Switchboard session.

Client/Request

CAL TrID user-handle

Where user-handle is the user that you'd like to invite.

Server/Response

CAL TrID RINGING session-id

Where RINGING is always RINGING, as there are no other states avaliable.

Where session-id is the Switchboard session identification number.

Examples

Inviting a user successfully

C: CAL 1 anotheruser@hotmail.com
S: CAL 1 RINGING 987654321

User already invited

C: CAL 2 anotheruser@hotmail.com
S: 215 2

User to invite was invalid

C: CAL 3 hello
S: 208 3

User is offline

C: CAL 4 anotheruser@hotmail.com
S: 217 4

User does not allow you to contact them

All instances that returned this have been changed to a 217. This response is deprecated.

C: CAL 5 anotheruser@hotmail.com
S: 216 5

Rate limited

C: CAL 6 anotheruser@hotmail.com
S: 217 6
C: CAL 7 anotheruser@hotmail.com
S: 217 7
C: CAL 8 anotheruser@hotmail.com
S: 217 8
C: CAL 9 anotheruser@hotmail.com
S: 217 9
C: CAL 10 anotheruser@hotmail.com
S: 217 10
C: CAL 11 anotheruser@hotmail.com
S: 713 11

Invalid context (Notification Server)

Inherited from being an unimplemented command.

C: CAL 12 anotheruser@hotmail.com

Server disconnects client.

Known changes

None.