MessageSend()
Synopsis
Send a text message.
Description
Send a text message. The body of the message that will be sent is what is currently set to MESSAGE(body)
. The technology chosen for sending the message is determined based on a prefix to the to
parameter.
This application sets the following channel variables:
MESSAGE_SEND_STATUS
- This is the message delivery status returned by this application.- INVALID_PROTOCOL - No handler for the technology part of the URI was found.
- INVALID_URI - The protocol handler reported that the URI was not valid.
- SUCCESS - Successfully passed on to the protocol handler, but delivery has not necessarily been guaranteed.
- FAILURE - The protocol handler reported that it was unabled to deliver the message for some reason.
Syntax
MessageSend(to,[from])
Arguments
to
- A To URI for the message.
- Technology: PJSIP
Specifying a prefix ofpjsip:
will send the message as a SIP MESSAGE request.
- Technology: SIP
Specifying a prefix ofsip:
will send the message as a SIP MESSAGE request.
- Technology: XMPP
Specifying a prefix ofxmpp:
will send the message as an XMPP chat message. from
- A From URI for the message if needed for the message technology being used to send this message. This can be a SIP(S) URI, such asAlice <sip:[email protected]>
, a string in the format[email protected]
, or simply a username such asalice
.
See Also
Import Version
This documentation was imported from Asterisk Version GIT-13-13.12.2-526-g4fcb8d8