Dispatch registers the x-dispatch://
URL scheme and provides one public action: compose
.
Launches Dispatch with the composer screen prefilled using information provided in the parameters below.
Optional. Specifies the email address of the account to compose the new mail from. If there are more than one account configured in Dispatch, and no valid from
account is provided, Dispatch will default to using the first account configured in Dispatch to compose the mail.
Optional. Specifies the subject of the email.
Optional. Specifies the plain text body of the email.
Optional. Comma-separated list of email addresses to be populated in the 'To:' field of the email.
Optional. Comma-separated list of email addresses to be populated in the 'Cc:' field of the email.
Optional. Comma-separated list of email addresses to be populated in the 'Bcc:' field of the email.
The following URL is broken up with line breaks to illustrate the parameters.
x-dispatch:///compose?
[email protected]
&subject=Hello%20from%20Dispatch
&[email protected],[email protected]
&[email protected]
&body=Hello%20world%2C%0A%0AThis%20is%20an%20email%20composed%20with%20the%20Dispatch%20%2Fcompose%20URL%20scheme.%0A%0A%E2%80%94%20Dispatch
Please take note of the triple ///
in x-dispatch:///compose
when using the URL scheme.
Dispatch now supports the x-callback-url protocol developed by Greg Pierce. All x-callback-url parameters are optional. Fill up at least x-success if you want Dispatch to offer to return you to x-source.
Optional. A friendly name for the app making the call.
Optional. The URL to use to return the user to the calling application if the user sends the mail. This does not guarantee that the mail has been sent; it only means that the user has followed through the composing process and tap on Send.
Optional. The URL to use to return the user to the calling application if the user cancels the composing process. If not provided, Dispatch will call the URL in x-success instead.
Check out some x-callback kungfu by https://twitter.com/hiilppp/ to compose in Drafts, send to Dispatch, attach Dropbox file, send and return.
If you've more x-callback kungfu to share, please email [email protected].