Intent API¶

As of v12, it is possible for other Android application to initiate chats to specific contacts via Intents.

Security is implemented through a TOFU-POP method: "This app is trying to start a chat. Would you like to allow that? Yes / No / Always"

scheme://provider or account/url-encoded path

open single chat¶

im://xmpp/foo%40bar.com = start a chat using an XMPP provider of the user's choice with foo@foo.com

im://foo@bar.com/blat = start a chat with the user "blat" (on the @bar.com service) using the foo@bar.com XMPP account

action = android.intent.action.SENDTO

If the foo@bar.com account doesn't exist, open the account setup form to provision a new account, and prompt the user to create a new password

open group chat¶

immu://foo@bar.com/blatroom = join the "blatroom" group chat on the server bar.com using the alias "foo"

immu://blatroom%40conference.blatfoo.com = join the "blatroom" conference on conference.blatfoo.com and prompt the user to enter an aliases.

action = android.intent.action.SENDTO

register new account¶

ima://foo:pass@bar.com/

action = android.intent.action.INSERT

share file¶

you can send a SEND intent for a file or stream, and the user will be prompted which chat to share with. if there are no open chats, they will be prompted to select a contact.

Intent:

otr-in-band:/storage/URI
action = android.intent.action.SENDTO

where URI is the URL-encoded URI that you want to transmit.