This function will end an active conversation-based on a given short or long code and a Contact’s mobile number. Once a conversation ends, it will allow the Contact to send other MO messages related to the short or long code, otherwise the Contact will remain in the conversation until it ends, either by reaching a message template without a Next Keyword, or being ejected from the conversation by this function.
The function will return
true if the conversation successfully ends, or
false if an exception occurs. The function can only be used in MobileConnect messages and will return
false if used in a different application context, for example in Email Studio or CloudPages.
NOTE: This function cannot be used in conversation-based templates such as Double Opt-In, Vote/Survey or Info Capture messages.
|1||Number||True||Short code or long code used by MobileConnect|
|2||Number||True||Contact’s mobile number with country code prefix|
A conversation is created from a series of SMS messages with Next Keywords, as per the table below.
|Message Name||Message Type||Keyword||Next Keyword|
|Response 1||Text Response||
|Response 2||Text Response||
|Response 3||Text Response||
A Contact then responds
No to the ‘Outbound Offer’ message and receives the ‘Response 1’ message.
This message contains the following code:
%%[ var @response set @response = [MSG(0).NOUNS] if IndexOf(@response,"no") > 0 then EndSMSConversation(61401123456, MOBILE_NUMBER) ]%% Thank you for participating in this survey. %%[ else ]%% Please reply with your first name. %%[ endif ]%%
The reply is interpreted by the ‘Response 1’ message and as the response contains the word ‘no’ (which is evaluated as case-insensitive by the IndexOf function), the Contact receives the message below and they are ejected from the conversation.
Thank you for participating in this survey.