package url

Get desktop application:
View/edit binary Protocol Buffers messages

Offer or request to join the (multi-)device group. When generated by an existing or a new device, the URL is formed using the `threema` scheme in the following way: ```text threema://device-group/join#<url-safe-base64(DeviceGroupJoinRequestOrOffer)> ``` When receiving this message: 1. If `version` or `variant` is not supported, abort these steps. 2. Follow the description of `RendezvousInit` to continue.

• DeviceGroupJoinRequestOrOffer.Version version = 1

• optional DeviceGroupJoinRequestOrOffer.Variant variant = 2

• optional rendezvous.RendezvousInit rendezvous_init = 3

  Data necessary to initialise a 1:1 connection between two devices.

Variant (_offer_ or _request_)

Used in: DeviceGroupJoinRequestOrOffer

• oneof type

  • common.Unit request_to_join = 1

    A device intends to join the (multi-)device group. `data` is to be handled according to the _Device Join Protocol_ with `ND` being the initiator.

  • common.Unit offer_to_join = 2

    A device intends to let another device join the (multi-)device group. `data` is to be handled according to the _Device Join Protocol_ with `ED` being the initiator.

Used in: DeviceGroupJoinRequestOrOffer

• V1_0 = 0

  Initial version.

Group invitation containing information to request joining a group. Generated by the administrator of a group. The resulting URL can be shared freely with anyone. The invitation can be invalidated by the administrator at any point. The URL is formed using the `threema.group` domain in the following way: ```text https://threema.group/join#<url-safe-base64(GroupInvite)> ``` Example: ```text https://threema.group/join#CghFQ0hPRUNITxIQaNbxfd3QsToW0c_668fXUhobQSBuaWNlIGxpdHRsZSBUaHJlZW1hIGdyb3Vw ```

• string admin_identity = 1

  The admin's Threema ID (8 bytes ASCII)

• bytes token = 2

  A random 16-byte token

• GroupInvite.ConfirmationMode confirmation_mode = 3

• string group_name = 4

  The group name

The invite confirmation mode

Used in: GroupInvite

• AUTOMATIC = 0

  The admin will auto-accept join requests.

• MANUAL = 1

  The admin needs to manually confirm each join request. The user interface should ask the user to pass a message along (e.g. for identification purposes).