Company Mailbox
Purpose
To receive data from unregistered users via a company-wide TeamBeam-Link.
Details
A company mailbox is a feature which allows for receiving files from arbitrary senders. It works as a form that does not require authentication. Everyone who calls the company mailbox link can send data to one or more recipients, by selecting them from a drop down list.
Note
The sender must enter his name and e-mail address. The sender cannot freely enter a recipient but must choose recipient(s) from a predefined list.
Every TeamBeam user can be a recipient of a company-wide mailing list. Once the user is added to a certain list, the public URL will appear in the user's page under tabs Transfer Data > Receive Data.
This public URL can be used by any user to send a transfer to one or more recipients inside the mailing list.
The recipient is added to a company-wide mailing list by an admin under tabs Users > Mailboxes and clicking the wrench symbol of the specific mailbox to be edited.
Pre-definition of fields
It is possible to pre-define certain fields with specific values. This can come in handy, if a customer wants to integrate a TeamBeam Mailbox into another web service.
The following fields are be predefineable as a key-value set:
- subject
- description
- anon sender and email
When set, the corresponding UI fields will be pre-filled, so that the user sees the values. The fields stay editable for the user.
If one of those fields shall be uneditable to the user, you may add them to the json array immutable.
It's optionally possible to add arbitrary fields (within the json object meta) to the above set. These additional fields will not show in the UI. Meta data will be appended to the transfer description, so the recipient may read and process them.
Example of a JSON object with predefined fields:
{
"subject":"test",
"description":"some text",
"anon":{
"email":"fred@example.org",
"name":"Fred"
},
"meta":{
"myField":"123456789",
"anotherField":"987654321"
},
"immutable":[
"subject",
"description"
]
}
In order to pass this information to the web upload client, the above JSON string has to be BASE64-encoded and passed as the query parameter pre to the web client:
Configuration
A company mailbox must be created by a cluster admin.
Dependencies
none
Conflicts
none