SendURL()
Prev  Appendix B. Applications in the dialplan  Next

SendURL()

Sends a URL to the channel.

        
          SendURL(URL[,options])

Sends the channel a URL for the device to call up, then hands the channel to the next priority.

If the channel does not support URL transmission, option j makes the channel jump to priority n+101 if it exists. Option wait makes the application wait for confirmation that the URL was loaded before continuing to the next priority.

Returns 0 if the URL is transmitted without errors, otherwise -1. Sets the channel variable SENDURLSTATUS to SUCCESS, FAILURE, UNSUPPORTED or NOLOAD (requires option wait; the client could not load the URL successfully).

exten => 123,1,SendURL(http://www.mobileweather.org/index.xml,wait)
[Note]

Internal help for this application in Asterisk 1.4:  

  -= Info about application 'SendURL' =- 

[Synopsis]
Send a URL

[Description]
  SendURL(URL[|option]): Requests client go to URL (IAX2) or sends the 
URL to the client (other channels).
Result is returned in the SENDURLSTATUS channel variable:
    SUCCESS       URL successfully sent to client
    FAILURE       Failed to send URL
    NOLOAD        Client failed to load URL (wait enabled)
    UNSUPPORTED   Channel does not support URL transport

If the option 'wait' is specified, execution will wait for an
acknowledgement that the URL has been loaded before continuing

If jumping is specified as an option (the 'j' flag), the client does not
support Asterisk "html" transport, and there exists a step with priority
n + 101, then execution will continue at that step.

SendURL continues normally if the URL was sent correctly or if the chann
el
does not support HTML transport.  Otherwise, the channel is hung up.

diff output to internal help in Asterisk 1.2:  

13c13
<     NOLOAD        Client failed to load URL (wait enabled)
---
>     NOLOAD        Clien failed to load URL (wait enabled)
17a18
> and will return -1 if the peer is unable to load the URL
19,24c20,26
< If jumping is specified as an option (the 'j' flag), the client does n
ot
< support Asterisk "html" transport, and there exists a step with priori
ty
< n + 101, then execution will continue at that step.
< 
< SendURL continues normally if the URL was sent correctly or if the cha
nnel
< does not support HTML transport.  Otherwise, the channel is hung up.
---
> Old behaviour (deprecated): 
>  If the client does not support Asterisk "html" transport, 
>  and there exists a step with priority n + 101, then execution will
>  continue at that step.
>  Otherwise, execution will continue at the next priority level.
>  SendURL only returns 0 if the URL was sent correctly  or if
>  the channel does not support HTML transport, and -1 otherwise.

See also. the section called “SendImage()”, the section called “SendText()”

Prev  Up  Next
SendText()  Home | Inhaltsverzeichnis  Set()