Media Attachment Action

This action will hold the conversation and wait for the user to send a valid media attachment. The conversation will hold until the user send the required media or, when allowed, skips the question.

Settings

The action uses the following settings:

Setting	Description	Parsed
Wrong User Input Reply	This is the text that will be displayed if the user input does not match the control expression	✅
Reply Pick Mode	When using multiple Wrong Input Reply lines, this option controls how replies are chosen.	⛔
Max Wrong Answers	The maximum number of wrong inputs the user can send before the question is skipped. Set to 0 (zero) to never give up on wrong inputs.	✅
Allow Photo	The user is allowed to upload a photo as a reply to this action	⛔
Allow Audio	The user is allowed to upload audio as a reply to this action	⛔
Allow Video	The user is allowed to upload a video as a reply to this action	⛔
Allow Document	The user is allowed to upload any document as a reply to this action	⛔
Allow Position	The user is allowed to upload its GPS position as a reply to this action	⛔
Never Skip Question	The question cannot be skipped by user. The input will repeat indefinitely until the control expression is matched or the maximum number of wrong inputs is reached	⛔
Intent Skip Question	The user can skip the question if his reply matches a specific intent	⛔
Text Skip Question	The user can skip the question if his reply matches a specific text or Regular Expression	⛔

Remarks

This action is halting the conversation. The chatbot is halted at the input point and will not proceed unless the conditions specified in the settings are met.

Depending on the channel and on specific user privacy settings, not all forms of attachment may be available.

If the maximum number of wrong answers is reached the Successful User Input will still be triggered: you should check the contents of your Target Variable to verify if the input was successful or not.

Reply Pick Mode options will pick a wrong reply (if more than one is specified) in the following way:

Mode	Result
Random	The reply will be picked randomly from the list of possible replies
List	The bot will pick the first reply at the first wrong input, then the second and so on. The bot will keep saying the last one when the end of the lis is reached
Round-Robin	Similar to list, except that when the end of the list is reached, the bot will restart from the first answer

Trigger

Successful User Input. This action will trigger any child operation as soon as the user input is matching the specified Control Expression.

Variables

This action produces the following variables after being triggered:

Variable	Description
user_attachment	The full url of the user attachment pointing to your Xenioo storage.
user_attachment_type	Contains the type of attachment sent by the user
input_fail_count	The number of times the user has failed to match the control expression
input_fail_triggered	True if the maximum number of wrong inputs has been reached. Otherwise empty
user_latitude	The latitude value if the user sends his position as attachment
user_longitude	The longitude value if the user sends his position as attachment
user_location	The full address related to the supplied longitude and latitude. Not all channels are capable of supplying this information
user_location_name	The location name (monument, business etc) of the supplied longitude and latitude. Not all channels are capable of supplying this information

Availability

Channel specific availability follows the table below:

Channel	Availability
Facebook	Fully Available.
WhatsApp	Fully Available.
Telegram	Fully Available.
Web	Not Available.
Alexa	Not Available. Alexa does not allow direct input halting.
Google Assistant	Not Available.
Slack	Fully Available.
API	Fully Available.

This action can be used only inside interactions and not as child of other actions.