{"id":31578,"date":"2018-04-21T15:47:48","date_gmt":"2018-04-21T15:47:48","guid":{"rendered":"https:\/\/ampscript.guide\/endsmsconversation\/"},"modified":"2021-04-06T00:58:47","modified_gmt":"2021-04-06T00:58:47","slug":"endsmsconversation","status":"publish","type":"post","link":"https:\/\/ampscript.guide\/endsmsconversation\/","title":{"rendered":"EndSmsConversation"},"content":{"rendered":"

EndSmsConversation<\/h2>\n

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.<\/p>\n

The function will return true<\/code> if the conversation successfully ends, or false<\/code> if an exception occurs. The function can only be used in MobileConnect messages and will return false<\/code> if used in a different application context, for example in Email Studio or CloudPages.<\/p>\n

Arguments<\/h3>\n

EndSmsConversation(1,2)<\/code><\/p>\n\n\n\n\n\n\n
Ordinal<\/th>\nType<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>\nNumber<\/td>\nTrue<\/td>\nShort code or long code used by MobileConnect<\/td>\n<\/tr>\n
2<\/td>\nNumber<\/td>\nTrue<\/td>\nContact’s mobile number with country code prefix<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

NOTE: This function cannot be used in conversation-based templates such as Double Opt-In, Vote\/Survey or Info Capture messages.<\/p>\n<\/blockquote>\n

Example<\/h3>\n

A conversation is created from a series of SMS messages with Next Keywords, as per the table below.<\/p>\n\n\n\n\n\n\n\n\n
Message Name<\/th>\nMessage Type<\/th>\nKeyword<\/th>\nNext Keyword<\/th>\n<\/tr>\n<\/thead>\n
Outbound Offer<\/td>\nOutbound<\/td>\n<\/td>\nRESPONSE1<\/code><\/td>\n<\/tr>\n
Response 1<\/td>\nText Response<\/td>\nRESPONSE1<\/code><\/td>\nRESPONSE2<\/code><\/td>\n<\/tr>\n
Response 2<\/td>\nText Response<\/td>\nRESPONSE2<\/code><\/td>\nRESPONSE3<\/code><\/td>\n<\/tr>\n
Response 3<\/td>\nText Response<\/td>\nRESPONSE3<\/code><\/td>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

A Contact then responds No<\/code> to the ‘Outbound Offer’ message and receives the ‘Response 1’ message.<\/p>\n

This message contains the following code:<\/p>\n

%%[\n\nvar @response\nset @response = [MSG(0).NOUNS]\n\nif IndexOf(@response,\"no\") > 0 then\n\n  EndSMSConversation(61401123456, MOBILE_NUMBER)\n\n]%%\nThank you for participating in this survey.\n%%[ else ]%%\nPlease reply with your first name.\n%%[ endif ]%%<\/code><\/pre>\n
Output<\/h4>\n
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<\/a> function), the Contact receives the message below and they are ejected from the conversation.<\/p>\n
Thank you for participating in this survey.<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
EndSmsConversation 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 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"yoast_head":"\nThe AMPscript Guide - EndSmsConversation<\/title>\n<meta name=\"robots\" content=\"index, follow\" \/>\n<meta name=\"googlebot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta name=\"bingbot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ampscript.guide\/endsmsconversation\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The AMPscript Guide - EndSmsConversation\" \/>\n<meta property=\"og:description\" content=\"EndSmsConversation 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 […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ampscript.guide\/endsmsconversation\/\" \/>\n<meta property=\"og:site_name\" content=\"The AMPscript Guide\" \/>\n<meta property=\"article:published_time\" content=\"2018-04-21T15:47:48+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-04-06T00:58:47+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ampscript.guide\/#website\",\"url\":\"https:\/\/ampscript.guide\/\",\"name\":\"The AMPscript Guide\",\"description\":\"The Definitive Scripting Manual for Salesforce Marketing Cloud\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/ampscript.guide\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/endsmsconversation\/#webpage\",\"url\":\"https:\/\/ampscript.guide\/endsmsconversation\/\",\"name\":\"The AMPscript Guide - EndSmsConversation\",\"isPartOf\":{\"@id\":\"https:\/\/ampscript.guide\/#website\"},\"datePublished\":\"2018-04-21T15:47:48+00:00\",\"dateModified\":\"2021-04-06T00:58:47+00:00\",\"author\":{\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\"},\"breadcrumb\":{\"@id\":\"https:\/\/ampscript.guide\/endsmsconversation\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ampscript.guide\/endsmsconversation\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ampscript.guide\/endsmsconversation\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/\",\"url\":\"https:\/\/ampscript.guide\/\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"position\":2,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/endsmsconversation\/\",\"url\":\"https:\/\/ampscript.guide\/endsmsconversation\/\",\"name\":\"EndSmsConversation\"}}]},{\"@type\":[\"Person\"],\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\",\"name\":\"dev\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","_links":{"self":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31578"}],"collection":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/comments?post=31578"}],"version-history":[{"count":0,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31578\/revisions"}],"wp:attachment":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/media?parent=31578"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/categories?post=31578"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/tags?post=31578"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}