1. Introduction
Meta Humans bot platform provides three methods in the node by which users can upload and share the files with the bot when this node is countered in the bot conversational flow.
2.1 Public Upload
Default option stores the file in Meta Humans bot platform cloud storage.
[Note: This URL would only be accessible for 20 mins ]
This URL will be available in the system-generated attribute {{user.fileupload.url}} The URL generated would be in this format:
2.2 Private Upload
If the bot builder doesn’t want a public URL for the file user is uploading he/she can generate a secure URL by choosing the first option which is Use Secure URL.
If the bot builder chooses this option and the user uploads a file, this file will be uploaded on the Meta Humans bot platform cloud but the URL generated would be private and need to be accessed by using an authorization token.
The URL generated would be in this format
The auth token can be generated in the Integrations tab->Meta Humans bot platform API's.
2.3 Direct Upload
If the bot builder wants to send the file to their storage, he/she can choose the second option which is Direct upload. If the bot builder chooses this option and the user uploads a file, this file will be uploaded on the API endpoint you configure in the node. Simultaneously the file is also uploaded to our cloud and a public URL is generated.
Note: If both the options are selected which are Secure URL and Direct upload, the file will be uploaded on the API endpoint you configure in the node and uploaded on our cloud generating a secure URL.
This URL would be saved in the system-generated attribute {{user.fileupload.url}}
3. User Flow
Expected User flow on the Bot.
-
User encounters a path where they are expected to upload a file attachment.
-
Users can browse and upload required files.
-
User selects a file and clicks on “Upload”.
-
Upload progress is displayed, o text input allowed during the upload.
-
If file upload is unsuccessful, an error message will be shown and the File Upload node is restarted.
-
User will be prompted to select the file to be uploaded again.
-
Bot admin can collect relevant attributes for passing as input parameters.
-
User can move ahead with the same path after the file is uploaded.
-
The user needs to provide the file in the expected format to proceed further.
Alternatively, the user can hit the refresh button to restart the welcome flow.
4. Notes for Bot Builder
Here are a few important points for the bot builder to keep in mind while configuring the File upload node.
Once uploaded, a predefined confirmation message is sent to the bot user.
Bot admin needs to define the Prompt Message and the Default Error Message.
The file is stored by Meta Humans bot platform for 30 days after which the file is automatically deleted.
The maximum file size is 5MB per upload.
File types accepted for upload are doc, docx, pdf, jpg, png & zip.
Zip files should not contain any unsupported file format.
If the upload format is incorrect, or the file exceeds the size limit, then the Default Error Message is displayed.
After the file upload node is created, the uploaded files can be managed using the portal attributes. The file is accessed through the following URL: {{user.fileUpload.url}} Details on their uploaded file type can be accessed through the attribute: {{user.fileUpload.type}}
For File Upload across the platforms Facebook and WhatsApp, the URL generated is public and can be directly accessed.
5. Error Handling
All failed file uploads will be tracked per user.
The List of failed uploads per user will be available in “Train-> Actions”, which redirects to the dashboard of failed uploads.
The following information is available:
User File name
File type
File Size
Upload Timestamp
Status
