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

CreateSmsConversation<\/h2>\n

While MobileConnect includes the ability to create conversations through assigning Next Keywords to message templates, this function provides the ability to conditionally create a conversation and can dynamically define the Next Keyword to use, instead of a defined value in the message template.<\/p>\n

The function will return true<\/code> if an conversation was successfully created, or false<\/code> if an exception occurred. 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

CreateSmsConversation(1,2,3,4)<\/code><\/p>\n\n\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
3<\/td>\nString<\/td>\nTrue<\/td>\nKeyword to use for Next Keyword function<\/td>\n<\/tr>\n
4<\/td>\nString<\/td>\nTrue<\/td>\nApplication used for the conversation use MOBILECONNECT<\/code><\/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 1<\/h3>\n

An outbound message is sent to a Contact. A Lookup function returns an applicable offer for the Contact from a Data Extension based on their mobile number. If an ‘Offer’ field is equal to competition<\/code> then a conversation will be created for the Contact with COMPETITION<\/code> as the Next Keyword.<\/p>\n

%%[\n\nvar @offer\nset @offer = Lookup(\"SMS Offers\", \"Offer\", \"Mobile Number\", MOBILE_NUMBER)\n\nif @offer == \"competition\" then\n\n  CreateSMSConversation(61401123456, MOBILE_NUMBER, \"COMPETITION\", \"MOBILECONNECT\")\n\n]%%\nYou have been selected to enter a draw for a $100 voucher. Reply with your email address to register.\n%%[ else ]%%\n10% discount at all NTO stores, 5 days only!\n%%[ endif ]%%<\/code><\/pre>\n
A text response message is also created in MobileConnect with the COMPETITION<\/code> keyword. The message template contains the following code:<\/p>\n
%%[\n\nInsertData(\"Competition Responses\", \"Mobile Number\", MOBILE_NUMBER, \"Email Address\", [MSG(0).NOUNS])\n\n]%%\nThank you for providing your email address. You have been registered for the competition.<\/code><\/pre>\n
Output<\/h4>\n
If the Lookup function used by the @offer<\/code> variable returns competition<\/code>, then the Contact will receive the following SMS message:<\/p>\n
You have been selected to enter a draw for a $100 voucher. Reply with your email address to register.<\/code><\/pre>\n
If the Contact replies to the SMS message with sam@limedash.com<\/code>, their mobile number and email address (from the response message) will be inserted into a ‘Competition Responses’ Data Extension and they will receive the following response:<\/p>\n
Thank you for providing your email address. You have been registered for the competition.<\/code><\/pre>\n
Example 2<\/h3>\n
\n\n\n\t\n\t
\n\n\t\t\n\t\t