ampscript-data 3.3.0 → 3.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/src/index.js +462 -85
package/src/index.js CHANGED
@@ -150,6 +150,11 @@ export const FUNCTIONS = [
150
150
  'var @list = "fdc5dfe4-e5e1-48af-87a1-4ac10433e895"\n' +
151
151
  'AddMscrmListMember(@member, @list)\n' +
152
152
  ']%%',
153
+ isConfirmed: true,
154
+ nonFunctionalAtRuntime: true,
155
+ deprecated: true,
156
+ deprecatedReason:
157
+ 'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
153
158
  },
154
159
  {
155
160
  name: 'AddObjectArrayItem',
@@ -158,6 +163,7 @@ export const FUNCTIONS = [
158
163
  mcnNotes: null,
159
164
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-add-object-array.html',
160
165
  guideUrl: 'https://ampscript.guide/addobjectarrayitem/',
166
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/addobjectarrayitem/',
161
167
  minArgs: 3,
162
168
  maxArgs: 3,
163
169
  category: 'Marketing Cloud API',
@@ -172,6 +178,7 @@ export const FUNCTIONS = [
172
178
  'No value is returned; the item is appended to the named array property.',
173
179
  syntax: 'AddObjectArrayItem(apiObject, arrayProperty, itemToAdd)',
174
180
  example: "AddObjectArrayItem(@apiObject, 'Recipients', @recipient)",
181
+ isConfirmed: true,
175
182
  },
176
183
  {
177
184
  name: 'AttachFile',
@@ -245,6 +252,11 @@ export const FUNCTIONS = [
245
252
  returnDescription: 'No value is returned; the file is attached to the outgoing email.',
246
253
  syntax: 'AttachFile(fileLocationType, fileLocation, attachmentFileName, viewOnWeb, viewOnWebUrl, viewOnWebFileName, viewOnWebDuration, contentDispositionAttachment)',
247
254
  example: "%%=AttachFile('http', 'https://example.com/catalog.pdf', 'Catalog.pdf')=%%",
255
+ isConfirmed: false,
256
+ verificationBlocked: true,
257
+ verificationBlockedReason: 'no-working-invocation',
258
+ officialDocsNote:
259
+ 'AttachFile targets the outgoing email at send time; it has no working invocation on a CloudPage. Every reached call — contentbuilder key, http URL, and the two-argument minimum form — aborted the page with HTTP 422 and no partial output, on the child QA BU (MID 518005426) and again on the parent BU (MID 7281698). The abort only happens when the call is actually reached: gating it behind an unmatched query-string branch leaves the page at HTTP 200, so the failure is a runtime abort of the reached call rather than a compile-time rejection. The official reference additionally documents that the capability must be provisioned per account, which cannot be observed from a full-access probe.',
248
260
  },
249
261
  {
250
262
  name: 'AttributeValue',
@@ -420,11 +432,12 @@ export const FUNCTIONS = [
420
432
  mcnNotes: null,
421
433
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-barcode-url.html',
422
434
  guideUrl: 'https://ampscript.guide/barcodeurl/',
423
- minArgs: 9,
435
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/barcodeurl/',
436
+ minArgs: 4,
424
437
  maxArgs: 9,
425
438
  category: 'Content',
426
439
  description:
427
- 'Generates a URL pointing to a barcode image rendered from the given parameters.',
440
+ 'Generates a URL that renders a barcode image from the given value, symbology, width, and height, plus optional formatting. An empty value aborts the page instead of returning an empty result.',
428
441
  params: [
429
442
  {
430
443
  name: 'valueToConvert',
@@ -496,7 +509,9 @@ export const FUNCTIONS = [
496
509
  returnType: 'string',
497
510
  returnDescription: 'A URL that renders the requested barcode image.',
498
511
  syntax: 'BarcodeURL(valueToConvert, barcodeType, width, height, checksumValue, showText, altText, rotation, transparentBG)',
499
- example: "%%=BarcodeURL('12345', 'qr', 150, 150, 0, 0, '', 0, 0)=%%",
512
+ example: "<img src=\"%%=BarcodeURL('12345678901', 'code128auto', 150, 50)=%%\">",
513
+ isConfirmed: true,
514
+ differsFromOfficialDocs: false,
500
515
  },
501
516
  {
502
517
  name: 'Base64Decode',
@@ -586,10 +601,14 @@ export const FUNCTIONS = [
586
601
  mcnNotes: null,
587
602
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-begin-impression-region.html',
588
603
  guideUrl: 'https://ampscript.guide/beginimpressionregion/',
604
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/beginimpressionregion/',
589
605
  minArgs: 1,
590
606
  maxArgs: 1,
607
+ isConfirmed: true,
608
+ differsFromOfficialDocs: false,
591
609
  category: 'Content',
592
- description: 'Marks the start of an impression tracking region.',
610
+ description:
611
+ 'Marks the start of an impression tracking region. The region name must be a literal — a variable argument aborts the page.',
593
612
  params: [{ name: 'regionName', description: 'Impression region name', type: 'string' }],
594
613
  returnType: 'void',
595
614
  returnDescription: 'No value is returned; it marks the start of an impression region.',
@@ -603,11 +622,12 @@ export const FUNCTIONS = [
603
622
  mcnNotes: null,
604
623
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-build-option-list.html',
605
624
  guideUrl: 'https://ampscript.guide/buildoptionlist/',
625
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/buildoptionlist/',
606
626
  minArgs: 3,
607
627
  maxArgs: INF,
608
628
  category: 'Content',
609
629
  description:
610
- 'Builds HTML <option> elements from a data extension for use in a <select> dropdown.',
630
+ 'Builds HTML <option> elements from supplied value/text pairs for use in a <select> dropdown, marking the pair whose value matches the default selection as selected.',
611
631
  params: [
612
632
  {
613
633
  name: 'defaultSelection',
@@ -652,6 +672,8 @@ export const FUNCTIONS = [
652
672
  ']%%\n' +
653
673
  '<p>Choose an option:</p>\n' +
654
674
  '<select name="choice">\n%%=v(@OptionList)=%%\n</select>',
675
+ isConfirmed: true,
676
+ differsFromOfficialDocs: false,
655
677
  },
656
678
  {
657
679
  name: 'BuildRowsetFromJSON',
@@ -813,6 +835,7 @@ export const FUNCTIONS = [
813
835
  mcnNotes: null,
814
836
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-claim-row.html',
815
837
  guideUrl: 'https://ampscript.guide/claimrow/',
838
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/claimrow/',
816
839
  minArgs: 4,
817
840
  maxArgs: INF,
818
841
  category: 'Data Extension',
@@ -869,6 +892,10 @@ export const FUNCTIONS = [
869
892
  repeat: [{ startIndex: 4, groupSize: 2, minGroups: 0 }],
870
893
  syntax: 'ClaimRow(dataExt, claimColumn, claimantColumn, claimantValue[, additionalColumnNameN, additionalColumnValueN, ...])',
871
894
  example: "%%[ SET @row = ClaimRow('Coupons', 'Claimed', 'SubKey', _subscriberkey) ]%%",
895
+ isConfirmed: true,
896
+ differsFromOfficialDocs: true,
897
+ officialDocsNote:
898
+ 'Runtime-proven on a Marketing Cloud Engagement CloudPage (child BU MID 518005426) against a data extension built to the documented claimable schema (Text primary key, Text claimant column, required non-nullable Boolean claim column defaulting to False, nullable Date column). Each call passing a NEW claimant value claims the next unclaimed row and advances: four distinct claimants received C1, C2, C3, C4 in order, each row flipping to claimed with its claimant recorded and ClaimedDate auto-populated. Re-calling with a claimant value that already holds a row returns that same row rather than advancing (per-subscriber idempotency). The official reference states that ClaimRow returns an exception when no unclaimed rows remain; at runtime it instead returned an empty row that does not abort the page (Empty() on it is true), so a caller must guard with Empty() rather than expecting a raised error. Each claim was driven by a separate HTTP request carrying the claimant value as a RequestParameter — the prior single-render probe that reused one claimant value never advanced because of the idempotency rule, not a provisioning gap.',
872
899
  },
873
900
  {
874
901
  name: 'ClaimRowValue',
@@ -877,6 +904,7 @@ export const FUNCTIONS = [
877
904
  mcnNotes: null,
878
905
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-claim-row-value.html',
879
906
  guideUrl: 'https://ampscript.guide/claimrowvalue/',
907
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/claimrowvalue/',
880
908
  minArgs: 3,
881
909
  maxArgs: INF,
882
910
  category: 'Data Extension',
@@ -931,6 +959,8 @@ export const FUNCTIONS = [
931
959
  repeat: [{ startIndex: 4, groupSize: 2, minGroups: 0 }],
932
960
  syntax: 'ClaimRowValue(dataExt, returnValueColumn, claimColumn[, valueIfClaimed, claimantColumnN, claimantValueN, ...])',
933
961
  example: "%%=ClaimRowValue('Coupons', 'Code', 'Claimed', '', 'SubKey', _subscriberkey)=%%",
962
+ isConfirmed: true,
963
+ differsFromOfficialDocs: false,
934
964
  },
935
965
  {
936
966
  name: 'CloudPagesURL',
@@ -1028,6 +1058,7 @@ export const FUNCTIONS = [
1028
1058
  mcnNotes: null,
1029
1059
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-area.html',
1030
1060
  guideUrl: 'https://ampscript.guide/contentarea/',
1061
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentarea/',
1031
1062
  minArgs: 1,
1032
1063
  maxArgs: 5,
1033
1064
  category: 'Content',
@@ -1062,7 +1093,8 @@ export const FUNCTIONS = [
1062
1093
  name: 'errorMessage',
1063
1094
  mcnSince: null,
1064
1095
  mcnNotes: null,
1065
- description: 'Default content to return if an error occurs',
1096
+ description:
1097
+ 'Default content to return if an error occurs. This value is emitted literally - any AMPscript it contains is not evaluated.',
1066
1098
  type: 'string',
1067
1099
  optional: true,
1068
1100
  },
@@ -1080,6 +1112,8 @@ export const FUNCTIONS = [
1080
1112
  returnDescription: 'The rendered HTML of the referenced content area.',
1081
1113
  syntax: 'ContentArea(contentAreaId[, impressionRegionName, errorOnMissingContentArea, errorMessage, statusCode])',
1082
1114
  example: '%%=ContentArea(12345)=%%',
1115
+ isConfirmed: true,
1116
+ differsFromOfficialDocs: false,
1083
1117
  deprecated: true,
1084
1118
  deprecatedReplacement: 'ContentBlockByID',
1085
1119
  deprecatedReason:
@@ -1092,6 +1126,7 @@ export const FUNCTIONS = [
1092
1126
  mcnNotes: null,
1093
1127
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-area-by-name.html',
1094
1128
  guideUrl: 'https://ampscript.guide/contentareabyname/',
1129
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentareabyname/',
1095
1130
  minArgs: 1,
1096
1131
  maxArgs: 5,
1097
1132
  category: 'Content',
@@ -1124,7 +1159,8 @@ export const FUNCTIONS = [
1124
1159
  name: 'errorMessage',
1125
1160
  mcnSince: null,
1126
1161
  mcnNotes: null,
1127
- description: 'Default content to return if an error occurs',
1162
+ description:
1163
+ 'Default content to return if an error occurs. This value is emitted literally - any AMPscript it contains is not evaluated.',
1128
1164
  type: 'string',
1129
1165
  optional: true,
1130
1166
  },
@@ -1142,6 +1178,8 @@ export const FUNCTIONS = [
1142
1178
  returnDescription: 'The rendered HTML of the named content area.',
1143
1179
  syntax: 'ContentAreaByName(contentAreaName[, impressionRegionName, errorOnMissingContentArea, errorMessage, statusCode])',
1144
1180
  example: String.raw`%%=ContentAreaByName('My Folder\My Content')=%%`,
1181
+ isConfirmed: true,
1182
+ differsFromOfficialDocs: false,
1145
1183
  deprecated: true,
1146
1184
  deprecatedReplacement: 'ContentBlockByName',
1147
1185
  deprecatedReason:
@@ -1154,6 +1192,7 @@ export const FUNCTIONS = [
1154
1192
  mcnNotes: null,
1155
1193
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-block-by-id.html',
1156
1194
  guideUrl: 'https://ampscript.guide/contentblockbyid/',
1195
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentblockbyid/',
1157
1196
  minArgs: 1,
1158
1197
  maxArgs: 5,
1159
1198
  category: 'Content',
@@ -1187,7 +1226,8 @@ export const FUNCTIONS = [
1187
1226
  name: 'errorMessage',
1188
1227
  mcnSince: null,
1189
1228
  mcnNotes: null,
1190
- description: 'Default content to return if an error occurs',
1229
+ description:
1230
+ 'Default content to return if an error occurs. This value is emitted literally - any AMPscript it contains is not evaluated.',
1191
1231
  type: 'string',
1192
1232
  optional: true,
1193
1233
  },
@@ -1205,6 +1245,8 @@ export const FUNCTIONS = [
1205
1245
  returnDescription: 'The rendered HTML of the content block identified by ID.',
1206
1246
  syntax: 'ContentBlockByID(contentBlockId[, impressionRegionName, errorOnMissingContentBlock, errorMessage, statusCode])',
1207
1247
  example: '%%=ContentBlockByID(12345)=%%',
1248
+ isConfirmed: true,
1249
+ differsFromOfficialDocs: false,
1208
1250
  },
1209
1251
  {
1210
1252
  name: 'ContentBlockByKey',
@@ -1214,6 +1256,7 @@ export const FUNCTIONS = [
1214
1256
  mcnNotes: null,
1215
1257
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-block-by-key.html',
1216
1258
  guideUrl: 'https://ampscript.guide/contentblockbykey/',
1259
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentblockbykey/',
1217
1260
  minArgs: 1,
1218
1261
  maxArgs: 5,
1219
1262
  category: 'Content',
@@ -1247,7 +1290,8 @@ export const FUNCTIONS = [
1247
1290
  name: 'errorMessage',
1248
1291
  mcnSince: null,
1249
1292
  mcnNotes: null,
1250
- description: 'Default content to return if an error occurs',
1293
+ description:
1294
+ 'Default content to return if an error occurs. This value is emitted literally - any AMPscript it contains is not evaluated.',
1251
1295
  type: 'string',
1252
1296
  optional: true,
1253
1297
  },
@@ -1265,6 +1309,8 @@ export const FUNCTIONS = [
1265
1309
  returnDescription: 'The rendered HTML of the content block identified by customer key.',
1266
1310
  syntax: 'ContentBlockByKey(contentBlockKey[, impressionRegionName, errorOnMissingContentBlock, errorMessage, statusCode])',
1267
1311
  example: "%%=ContentBlockByKey('welcome-header')=%%",
1312
+ isConfirmed: true,
1313
+ differsFromOfficialDocs: false,
1268
1314
  },
1269
1315
  {
1270
1316
  name: 'ContentBlockByName',
@@ -1273,6 +1319,7 @@ export const FUNCTIONS = [
1273
1319
  mcnNotes: null,
1274
1320
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-block-by-name.html',
1275
1321
  guideUrl: 'https://ampscript.guide/contentblockbyname/',
1322
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentblockbyname/',
1276
1323
  minArgs: 1,
1277
1324
  maxArgs: 5,
1278
1325
  category: 'Content',
@@ -1307,7 +1354,8 @@ export const FUNCTIONS = [
1307
1354
  name: 'errorMessage',
1308
1355
  mcnSince: null,
1309
1356
  mcnNotes: null,
1310
- description: 'Default content to return if an error occurs',
1357
+ description:
1358
+ 'Default content to return if an error occurs. This value is emitted literally - any AMPscript it contains is not evaluated.',
1311
1359
  type: 'string',
1312
1360
  optional: true,
1313
1361
  },
@@ -1325,6 +1373,8 @@ export const FUNCTIONS = [
1325
1373
  returnDescription: 'The rendered HTML of the content block identified by name or path.',
1326
1374
  syntax: 'ContentBlockByName(contentBlockName[, impressionRegionName, errorOnMissingContentBlock, errorMessage, statusCode])',
1327
1375
  example: String.raw`%%=ContentBlockByName('My Folder\Welcome Header')=%%`,
1376
+ isConfirmed: true,
1377
+ differsFromOfficialDocs: false,
1328
1378
  },
1329
1379
  {
1330
1380
  name: 'ContentImageByID',
@@ -1333,10 +1383,12 @@ export const FUNCTIONS = [
1333
1383
  mcnNotes: null,
1334
1384
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-image-by-id.html',
1335
1385
  guideUrl: 'https://ampscript.guide/contentimagebyid/',
1336
- minArgs: 2,
1386
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentimagebyid/',
1387
+ minArgs: 1,
1337
1388
  maxArgs: 2,
1338
1389
  category: 'Content',
1339
- description: 'Returns the URL of a Content Builder image asset by its numeric ID.',
1390
+ description:
1391
+ 'Returns an HTML img tag for a Content Builder image asset by its numeric ID. A missing image with no fallback aborts the page.',
1340
1392
  params: [
1341
1393
  {
1342
1394
  name: 'id',
@@ -1350,12 +1402,16 @@ export const FUNCTIONS = [
1350
1402
  description:
1351
1403
  "The ID of a fallback image in Content Builder. The function uses this image if it can't find the image that you specified in the first parameter",
1352
1404
  type: 'number|string',
1405
+ optional: true,
1353
1406
  },
1354
1407
  ],
1355
1408
  returnType: 'string',
1356
- returnDescription: 'The URL of the image identified by ID.',
1357
- syntax: 'ContentImageByID(id, defaultImageExternalId)',
1358
- example: '%%=ContentImageByID(12345, 0)=%%',
1409
+ returnDescription:
1410
+ 'An HTML img tag for the referenced image, with title, alt, border and thid attributes.',
1411
+ syntax: 'ContentImageByID(id[, defaultImageExternalId])',
1412
+ example: '%%=ContentImageByID(12345)=%%',
1413
+ isConfirmed: true,
1414
+ differsFromOfficialDocs: false,
1359
1415
  },
1360
1416
  {
1361
1417
  name: 'ContentImageByKey',
@@ -1364,10 +1420,12 @@ export const FUNCTIONS = [
1364
1420
  mcnNotes: null,
1365
1421
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-image-by-key.html',
1366
1422
  guideUrl: 'https://ampscript.guide/contentimagebykey/',
1367
- minArgs: 2,
1423
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentimagebykey/',
1424
+ minArgs: 1,
1368
1425
  maxArgs: 2,
1369
1426
  category: 'Content',
1370
- description: 'Returns the URL of a Content Builder image asset by its customer key.',
1427
+ description:
1428
+ 'Returns an HTML img tag for a Content Builder image asset by its customer key. A missing image with no fallback aborts the page.',
1371
1429
  params: [
1372
1430
  {
1373
1431
  name: 'imageExternalKey',
@@ -1380,12 +1438,16 @@ export const FUNCTIONS = [
1380
1438
  mcnNotes: null,
1381
1439
  description: 'External key of the fallback image asset',
1382
1440
  type: 'string',
1441
+ optional: true,
1383
1442
  },
1384
1443
  ],
1385
1444
  returnType: 'string',
1386
- returnDescription: 'The URL of the image identified by customer key.',
1387
- syntax: 'ContentImageByKey(imageExternalKey, defaultImageExternalKey)',
1388
- example: "%%=ContentImageByKey('hero-image', '')=%%",
1445
+ returnDescription:
1446
+ 'An HTML img tag for the referenced image, with title, alt, border and thid attributes.',
1447
+ syntax: 'ContentImageByKey(imageExternalKey[, defaultImageExternalKey])',
1448
+ example: "%%=ContentImageByKey('hero-image')=%%",
1449
+ isConfirmed: true,
1450
+ differsFromOfficialDocs: false,
1389
1451
  },
1390
1452
  {
1391
1453
  name: 'CreateMSCRMRecord',
@@ -1433,6 +1495,11 @@ export const FUNCTIONS = [
1433
1495
  repeat: [{ startIndex: 2, groupSize: 2, minGroups: 1, countParam: 'numFields' }],
1434
1496
  syntax: 'CreateMSCRMRecord(entityName, numFields, attributeName1, attributeValue1[, attributeNameN, attributeValueN, ...])',
1435
1497
  example: "%%=CreateMSCRMRecord('contact', 1, 'lastname', 'Smith')=%%",
1498
+ isConfirmed: true,
1499
+ nonFunctionalAtRuntime: true,
1500
+ deprecated: true,
1501
+ deprecatedReason:
1502
+ 'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
1436
1503
  },
1437
1504
  {
1438
1505
  name: 'CreateObject',
@@ -1441,6 +1508,7 @@ export const FUNCTIONS = [
1441
1508
  mcnNotes: null,
1442
1509
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-create-object.html',
1443
1510
  guideUrl: 'https://ampscript.guide/createobject/',
1511
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/createobject/',
1444
1512
  minArgs: 1,
1445
1513
  maxArgs: 1,
1446
1514
  category: 'Marketing Cloud API',
@@ -1453,6 +1521,7 @@ export const FUNCTIONS = [
1453
1521
  returnDescription: 'A new API object instance for use with the Invoke* functions.',
1454
1522
  syntax: 'CreateObject(objectName)',
1455
1523
  example: "%%=CreateObject('DataExtensionObject')=%%",
1524
+ isConfirmed: true,
1456
1525
  },
1457
1526
  {
1458
1527
  name: 'CreateSalesforceObject',
@@ -1461,10 +1530,16 @@ export const FUNCTIONS = [
1461
1530
  mcnNotes: null,
1462
1531
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-salesforce/mc-ampscript-reference-salesforce-create-object.html',
1463
1532
  guideUrl: 'https://ampscript.guide/createsalesforceobject/',
1533
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/createsalesforceobject/',
1464
1534
  minArgs: 4,
1465
1535
  maxArgs: INF,
1466
1536
  category: 'Sales and Service Cloud',
1467
- description: 'Creates a new record in a connected Salesforce CRM object.',
1537
+ description:
1538
+ 'Creates a new record in a connected Salesforce Sales or Service Cloud object via Marketing Cloud Connect and returns the 18-character ID of the created record. Requires an active Marketing Cloud Connect integration; the field names must be valid API names on the target object, and a fault (unknown object or field) aborts the whole page rather than returning an error value.',
1539
+ isConfirmed: true,
1540
+ differsFromOfficialDocs: false,
1541
+ officialDocsNote:
1542
+ 'The success path was runtime-proven on cred/DEV (MID 510007949), which has an active Marketing Cloud Connect integration to a real Salesforce org. Creating a benign Task with a single opaque field returned a real 18-character Salesforce ID (an 00T-prefixed Task ID), confirming the documented return shape. The fault path was also proven: an unknown object name and an unknown field name on a real object each aborted the CloudPage with HTTP 422 — the SOAP fault from the connected org propagates as an uncatchable page abort (AMPscript has no try/catch), exactly like RetrieveSalesforceObjects against an unknown object — so there is no testable error value, the function either returns an ID or aborts. AMPscript has no delete function for Salesforce objects, so the created Task remains as benign residue in the org. Catalog signature, returnType and repeat group all match the official reference and ampscript.guide, so differsFromOfficialDocs stays false.',
1468
1543
  params: [
1469
1544
  {
1470
1545
  name: 'objectName',
@@ -1494,7 +1569,7 @@ export const FUNCTIONS = [
1494
1569
  { name: 'fieldValueN', description: 'Additional field value', optional: true },
1495
1570
  ],
1496
1571
  returnType: 'string',
1497
- returnDescription: 'The ID of the newly created Salesforce object record.',
1572
+ returnDescription: 'The 18-character ID of the newly created Salesforce object record.',
1498
1573
  repeat: [{ startIndex: 2, groupSize: 2, minGroups: 1, countParam: 'numFields' }],
1499
1574
  syntax: 'CreateSalesforceObject(objectName, numFields, fieldName1, fieldValue1[, fieldNameN, fieldValueN, ...])',
1500
1575
  example: "%%=CreateSalesforceObject('Contact', 1, 'LastName', 'Smith')=%%",
@@ -1509,17 +1584,41 @@ export const FUNCTIONS = [
1509
1584
  minArgs: 4,
1510
1585
  maxArgs: 4,
1511
1586
  category: 'MobileConnect',
1512
- description: 'Initiates an SMS conversation on a MobileConnect short code.',
1587
+ description:
1588
+ 'Initiates an SMS conversation with a contact from within a MobileConnect message. Returns true when a conversation is created inside a MobileConnect message context, and false in any other context (for example a CloudPage or email). The success path cannot be exercised outside a live MobileConnect send.',
1589
+ isConfirmed: false,
1590
+ verificationBlocked: true,
1591
+ verificationBlockedReason: 'no-working-invocation',
1592
+ differsFromOfficialDocs: true,
1593
+ officialDocsNote:
1594
+ "Runtime-observed on cred/DEV (MID 510007949), the only BU available for this batch (no parent-BU escalation). Unlike Msg()/Noun()/Verb(), this is an ordinary function call, so it compiles and runs on a CloudPage: called there with a real short code, the authorized destination number and app 'MOBILECONNECT', it returned the literal boolean false (Empty() false) and the page rendered fully with no exception — no SMS was sent. Passing an invalid app value also returned false, so the CloudPage context masks any app-validation error. This confirms the ampscript.guide claim that the function returns false outside a MobileConnect message context; the official Salesforce reference omits this and describes only the in-context behaviour (true on success, exception on failure). The success path (true, real conversation creation) requires a live MobileConnect message context that does not exist on a CloudPage and cannot be captured on this tenant, so the function is recorded blocked for the success path while the CloudPage false-return is proven. The catalogued signature was also corrected here: the four parameters are originationNumber, destinationNumber, nextKeyword and app, and the return is a boolean, not void.",
1513
1595
  params: [
1514
- { name: 'shortCode', description: 'SMS short code', type: 'string' },
1515
- { name: 'keyword', description: 'Current conversation keyword', type: 'string' },
1516
- { name: 'nextKeyword', description: 'Next expected keyword', type: 'string' },
1517
- { name: 'messageText', description: 'Message to send', type: 'string' },
1596
+ {
1597
+ name: 'originationNumber',
1598
+ description: 'The MobileConnect short code or long code used to send',
1599
+ type: 'string',
1600
+ },
1601
+ {
1602
+ name: 'destinationNumber',
1603
+ description: "The contact's phone number, including country code",
1604
+ type: 'string',
1605
+ },
1606
+ {
1607
+ name: 'nextKeyword',
1608
+ description: 'The keyword to set as the next conversation keyword',
1609
+ type: 'string',
1610
+ },
1611
+ {
1612
+ name: 'app',
1613
+ description: "The application for the conversation; must be 'MOBILECONNECT'",
1614
+ type: 'string',
1615
+ },
1518
1616
  ],
1519
- returnType: 'void',
1520
- returnDescription: 'No value is returned; an SMS conversation is started.',
1521
- syntax: 'CreateSmsConversation(shortCode, keyword, nextKeyword, messageText)',
1522
- example: "CreateSmsConversation('12345', 'JOIN', 'CONFIRM', 'Reply CONFIRM to continue')",
1617
+ returnType: 'boolean',
1618
+ returnDescription:
1619
+ 'true when a conversation is created inside a MobileConnect message context; false in any other context (proven on a CloudPage). Fails with an exception in-context if unsuccessful.',
1620
+ syntax: 'CreateSmsConversation(originationNumber, destinationNumber, nextKeyword, app)',
1621
+ example: '%%=CreateSmsConversation("12345", MOBILE_NUMBER, "KEYWORD", "MOBILECONNECT")=%%',
1523
1622
  },
1524
1623
  {
1525
1624
  name: 'DataExtensionRowCount',
@@ -1528,6 +1627,9 @@ export const FUNCTIONS = [
1528
1627
  mcnNotes: null,
1529
1628
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-de-row-count.html',
1530
1629
  guideUrl: 'https://ampscript.guide/dataextensionrowcount/',
1630
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/dataextensionrowcount/',
1631
+ isConfirmed: true,
1632
+ differsFromOfficialDocs: false,
1531
1633
  minArgs: 1,
1532
1634
  maxArgs: 1,
1533
1635
  category: 'Data Extension',
@@ -1791,6 +1893,9 @@ export const FUNCTIONS = [
1791
1893
  mcnNotes: null,
1792
1894
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-delete-data.html',
1793
1895
  guideUrl: 'https://ampscript.guide/deletedata/',
1896
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/deletedata/',
1897
+ isConfirmed: true,
1898
+ differsFromOfficialDocs: false,
1794
1899
  minArgs: 3,
1795
1900
  maxArgs: INF,
1796
1901
  category: 'Data Extension',
@@ -1835,6 +1940,9 @@ export const FUNCTIONS = [
1835
1940
  mcnNotes: null,
1836
1941
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-delete-de.html',
1837
1942
  guideUrl: 'https://ampscript.guide/deletede/',
1943
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/deletede/',
1944
+ isConfirmed: true,
1945
+ differsFromOfficialDocs: false,
1838
1946
  minArgs: 3,
1839
1947
  maxArgs: INF,
1840
1948
  category: 'Data Extension',
@@ -1887,6 +1995,11 @@ export const FUNCTIONS = [
1887
1995
  returnDescription: 'A rowset describing the available Microsoft Dynamics CRM entities.',
1888
1996
  syntax: 'DescribeMSCRMEntities()',
1889
1997
  example: '%%[ SET @entities = DescribeMSCRMEntities() ]%%',
1998
+ isConfirmed: true,
1999
+ nonFunctionalAtRuntime: true,
2000
+ deprecated: true,
2001
+ deprecatedReason:
2002
+ 'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
1890
2003
  },
1891
2004
  {
1892
2005
  name: 'DescribeMSCRMEntityAttributes',
@@ -1904,6 +2017,11 @@ export const FUNCTIONS = [
1904
2017
  returnDescription: 'A rowset describing the attributes of the requested CRM entity.',
1905
2018
  syntax: 'DescribeMSCRMEntityAttributes(entityType)',
1906
2019
  example: "%%[ SET @attrs = DescribeMSCRMEntityAttributes('contact') ]%%",
2020
+ isConfirmed: true,
2021
+ nonFunctionalAtRuntime: true,
2022
+ deprecated: true,
2023
+ deprecatedReason:
2024
+ 'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
1907
2025
  },
1908
2026
  {
1909
2027
  name: 'Divide',
@@ -2053,8 +2171,11 @@ export const FUNCTIONS = [
2053
2171
  mcnNotes: null,
2054
2172
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-end-impression-region.html',
2055
2173
  guideUrl: 'https://ampscript.guide/endimpressionregion/',
2174
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/endimpressionregion/',
2056
2175
  minArgs: 0,
2057
2176
  maxArgs: 1,
2177
+ isConfirmed: true,
2178
+ differsFromOfficialDocs: false,
2058
2179
  category: 'Content',
2059
2180
  description: 'Marks the end of an impression tracking region.',
2060
2181
  params: [
@@ -2062,8 +2183,9 @@ export const FUNCTIONS = [
2062
2183
  name: 'endAllRegions',
2063
2184
  mcnSince: null,
2064
2185
  mcnNotes: null,
2065
- description: 'Whether to end all open impression regions',
2066
- type: 'boolean',
2186
+ description:
2187
+ 'Whether to end all open impression regions. A truthy value ends every open region; the default ends only the most recent one.',
2188
+ type: 'string|boolean|number',
2067
2189
  optional: true,
2068
2190
  },
2069
2191
  ],
@@ -2082,15 +2204,31 @@ export const FUNCTIONS = [
2082
2204
  minArgs: 2,
2083
2205
  maxArgs: 2,
2084
2206
  category: 'MobileConnect',
2085
- description: 'Ends an active SMS conversation on a short code.',
2207
+ description:
2208
+ 'Ends an active SMS conversation with a contact from within a MobileConnect message. Returns true when the conversation is ended inside a MobileConnect message context, and false in any other context (for example a CloudPage or email). The success path cannot be exercised outside a live MobileConnect send.',
2209
+ isConfirmed: false,
2210
+ verificationBlocked: true,
2211
+ verificationBlockedReason: 'no-working-invocation',
2212
+ differsFromOfficialDocs: true,
2213
+ officialDocsNote:
2214
+ 'Runtime-observed on cred/DEV (MID 510007949), the only BU available (no parent-BU escalation). This is an ordinary function call, so it compiles and runs on a CloudPage: called there with a real short code and the authorized destination number, it returned the literal boolean false (Empty() false) and the page rendered fully with no exception — no SMS was sent and no conversation state changed. This confirms the ampscript.guide claim that the function returns false outside a MobileConnect message context; the official Salesforce reference omits this and describes only the in-context behaviour (true on success, exception on failure). The success path (true, real conversation end) requires a live MobileConnect message context that cannot be captured on this tenant, so the function is recorded blocked for the success path while the CloudPage false-return is proven. The catalogued signature was corrected here: the two parameters are originationNumber and destinationNumber, and the return is a boolean, not void.',
2086
2215
  params: [
2087
- { name: 'shortCode', description: 'SMS short code', type: 'string' },
2088
- { name: 'keyword', description: 'Conversation keyword to end', type: 'string' },
2216
+ {
2217
+ name: 'originationNumber',
2218
+ description: 'The MobileConnect short code or long code used to send',
2219
+ type: 'string',
2220
+ },
2221
+ {
2222
+ name: 'destinationNumber',
2223
+ description: "The contact's phone number, including country code",
2224
+ type: 'string',
2225
+ },
2089
2226
  ],
2090
- returnType: 'void',
2091
- returnDescription: 'No value is returned; the SMS conversation is ended.',
2092
- syntax: 'EndSmsConversation(shortCode, keyword)',
2093
- example: "EndSmsConversation('12345', 'JOIN')",
2227
+ returnType: 'boolean',
2228
+ returnDescription:
2229
+ 'true when the conversation is ended inside a MobileConnect message context; false in any other context (proven on a CloudPage). Fails with an exception in-context if unsuccessful.',
2230
+ syntax: 'EndSmsConversation(originationNumber, destinationNumber)',
2231
+ example: '%%=EndSmsConversation("12345", MOBILE_NUMBER)=%%',
2094
2232
  },
2095
2233
  {
2096
2234
  name: 'ExecuteFilter',
@@ -2099,6 +2237,9 @@ export const FUNCTIONS = [
2099
2237
  mcnNotes: null,
2100
2238
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-execute-filter.html',
2101
2239
  guideUrl: 'https://ampscript.guide/executefilter/',
2240
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/executefilter/',
2241
+ isConfirmed: true,
2242
+ differsFromOfficialDocs: false,
2102
2243
  minArgs: 1,
2103
2244
  maxArgs: 1,
2104
2245
  category: 'Data Extension',
@@ -2123,6 +2264,9 @@ export const FUNCTIONS = [
2123
2264
  mcnNotes: null,
2124
2265
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-execute-filter-ordered-rows.html',
2125
2266
  guideUrl: 'https://ampscript.guide/executefilterorderedrows/',
2267
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/executefilterorderedrows/',
2268
+ isConfirmed: true,
2269
+ differsFromOfficialDocs: false,
2126
2270
  minArgs: 3,
2127
2271
  maxArgs: 3,
2128
2272
  category: 'Data Extension',
@@ -2161,10 +2305,14 @@ export const FUNCTIONS = [
2161
2305
  mcnNotes: null,
2162
2306
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-field.html',
2163
2307
  guideUrl: 'https://ampscript.guide/field/',
2308
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/field/',
2309
+ isConfirmed: true,
2310
+ differsFromOfficialDocs: false,
2164
2311
  minArgs: 2,
2165
2312
  maxArgs: 3,
2166
2313
  category: 'Data Extension',
2167
- description: 'Retrieves the value of a specific field from a rowset row.',
2314
+ description:
2315
+ 'Retrieves the value of a named field from a rowset row. The two-argument form aborts the page when the column is absent; pass the optional third argument as 0 (or false) to get an empty string for a possibly-missing column instead.',
2168
2316
  params: [
2169
2317
  { name: 'row', description: 'Row object from a rowset', type: 'row' },
2170
2318
  { name: 'fieldName', description: 'Column name to retrieve', type: 'string' },
@@ -2459,9 +2607,8 @@ export const FUNCTIONS = [
2459
2607
  ],
2460
2608
  returnType: 'string',
2461
2609
  returnDescription: 'A signed JSON Web Token string created with the named key.',
2462
- isConfirmed: false,
2463
- verificationBlocked: true,
2464
- verificationBlockedReason: 'no-test-data',
2610
+ isConfirmed: true,
2611
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/getjwtbykeyname/',
2465
2612
  syntax: 'GetJWTByKeyName(keyName, algorithm, jsonPayload)',
2466
2613
  example: "%%=GetJWTByKeyName('MyKeyName', 'HS256', @payload)=%%",
2467
2614
  },
@@ -2487,6 +2634,10 @@ export const FUNCTIONS = [
2487
2634
  returnDescription: 'The content of the requested Portfolio item.',
2488
2635
  syntax: 'GetPortfolioItem(itemExternalKey)',
2489
2636
  example: "%%=GetPortfolioItem('my-portfolio-key')=%%",
2637
+ isConfirmed: true,
2638
+ nonFunctionalAtRuntime: true,
2639
+ officialDocsNote:
2640
+ 'Classic Portfolio is retired on this tenant, so no Portfolio item exists to retrieve. A reached call with an external key that does not resolve aborted the page with HTTP 422 and no partial output, on both the child QA BU (MID 518005426) and the parent BU (MID 7281698); the same call gated behind an unmatched query-string branch left the page at HTTP 200, confirming a runtime abort of the reached call. No valid key could be sourced because Portfolio asset creation and applications were retired, so the documented success path could not be exercised here.',
2490
2641
  },
2491
2642
  {
2492
2643
  name: 'GetPublishedSocialContent',
@@ -2506,6 +2657,10 @@ export const FUNCTIONS = [
2506
2657
  returnDescription: 'The published social content for the supplied identifier.',
2507
2658
  syntax: 'GetPublishedSocialContent(socialContentId)',
2508
2659
  example: "%%=GetPublishedSocialContent('socialContentId')=%%",
2660
+ isConfirmed: true,
2661
+ nonFunctionalAtRuntime: true,
2662
+ officialDocsNote:
2663
+ 'The community guide flags this as usable only inside Microsites and Landing Pages and only for content regions built in Classic Content, which is retired on this tenant. A reached call aborted the page with HTTP 422 and no partial output for both a string region name and a numeric region id, on the child QA BU (MID 518005426) and again on the parent BU (MID 7281698). The same call gated behind an unmatched query-string branch left the page at HTTP 200, confirming a runtime abort of the reached call rather than a compile-time failure. No Classic Content region exists here to source a resolvable identifier, so the documented success path could not be exercised.',
2509
2664
  },
2510
2665
  {
2511
2666
  name: 'GetSendTime',
@@ -2549,16 +2704,18 @@ export const FUNCTIONS = [
2549
2704
  mcnNotes: null,
2550
2705
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-social/mc-ampscript-reference-social-get-social-publish-url.html',
2551
2706
  guideUrl: 'https://ampscript.guide/getsocialpublishurl/',
2707
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/getsocialpublishurl/',
2552
2708
  minArgs: 2,
2553
2709
  maxArgs: INF,
2554
2710
  category: 'Social',
2711
+ isConfirmed: true,
2555
2712
  description:
2556
2713
  'Returns HTML for sharing a content region on a supported social network via Social Forward. Optionally accepts repeating key/value parameter pairs.',
2557
2714
  params: [
2558
2715
  {
2559
2716
  name: 'socialNetworkCode',
2560
2717
  description: 'The number code of the social network to share to',
2561
- type: 'number',
2718
+ type: 'string|number',
2562
2719
  },
2563
2720
  {
2564
2721
  name: 'contentRegion',
@@ -2603,9 +2760,12 @@ export const FUNCTIONS = [
2603
2760
  mcnNotes: null,
2604
2761
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-social/mc-ampscript-reference-social-get-social-publish-url-by-name.html',
2605
2762
  guideUrl: 'https://ampscript.guide/getsocialpublishurlbyname/',
2763
+ sfmcGuideUrl:
2764
+ 'https://sfmc.guide/engagement/ampscript/functions/getsocialpublishurlbyname/',
2606
2765
  minArgs: 3,
2607
2766
  maxArgs: INF,
2608
2767
  category: 'Social',
2768
+ isConfirmed: true,
2609
2769
  description:
2610
2770
  'Returns HTML for sharing a content region on a supported social network (identified by name) via Social Forward. Optionally accepts repeating key/value parameter pairs.',
2611
2771
  params: [
@@ -2678,8 +2838,10 @@ export const FUNCTIONS = [
2678
2838
  mcnSince: null,
2679
2839
  handlebarsEquivalent: null,
2680
2840
  mcnNotes: null,
2841
+ isConfirmed: true,
2681
2842
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-http/mc-ampscript-reference-http-get.html',
2682
2843
  guideUrl: 'https://ampscript.guide/httpget/',
2844
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/httpget/',
2683
2845
  minArgs: 1,
2684
2846
  maxArgs: 4,
2685
2847
  category: 'HTTP',
@@ -2699,25 +2861,27 @@ export const FUNCTIONS = [
2699
2861
  optional: true,
2700
2862
  },
2701
2863
  {
2702
- name: 'headerName',
2864
+ name: 'emptyContentHandling',
2703
2865
  mcnSince: null,
2704
2866
  mcnNotes: null,
2705
- description: 'Request header name',
2706
- type: 'string',
2867
+ description:
2868
+ 'How empty content is handled: 0 allows empty content, 1 returns an error, 2 skips the subscriber in a send',
2869
+ type: 'number',
2707
2870
  optional: true,
2708
2871
  },
2709
2872
  {
2710
- name: 'headerValue',
2873
+ name: 'status',
2711
2874
  mcnSince: null,
2712
2875
  mcnNotes: null,
2713
- description: 'Request header value',
2714
- type: 'string',
2876
+ description:
2877
+ 'Output variable that receives the function status: 0 success, -1 not found, -2 HTTP request error, -3 empty content',
2878
+ type: 'number',
2715
2879
  optional: true,
2716
2880
  },
2717
2881
  ],
2718
2882
  returnType: 'string',
2719
2883
  returnDescription: 'The body of the HTTP response as a string.',
2720
- syntax: 'HTTPGet(httpGetUrl[, continueOnError, headerName, headerValue])',
2884
+ syntax: 'HTTPGet(httpGetUrl[, continueOnError, emptyContentHandling, status])',
2721
2885
  example: "%%=HTTPGet('https://example.com/api')=%%",
2722
2886
  },
2723
2887
  {
@@ -2727,11 +2891,16 @@ export const FUNCTIONS = [
2727
2891
  mcnNotes: null,
2728
2892
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-http/mc-ampscript-reference-http-post.html',
2729
2893
  guideUrl: 'https://ampscript.guide/httppost/',
2894
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/httppost/',
2730
2895
  minArgs: 3,
2731
2896
  maxArgs: INF,
2732
2897
  category: 'HTTP',
2898
+ isConfirmed: true,
2899
+ differsFromOfficialDocs: true,
2900
+ officialDocsNote:
2901
+ 'The official reference labels the fourth argument as an output parameter holding the "status" of the request, but on a live Engagement CloudPage (child MID 518005426) that variable receives the response BODY, not the status. The HTTP status code is the function return value. A non-2xx response (proven with a 404) and an empty URL both abort the whole page rather than returning the status, so a failing status can never be read from the return value.',
2733
2902
  description:
2734
- 'Performs an HTTP POST request. The response body is stored in the output variable.',
2903
+ 'Performs an HTTP POST request and returns the HTTP status code. The response body is written to the optional output variable.',
2735
2904
  params: [
2736
2905
  {
2737
2906
  name: 'urlEndpoint',
@@ -2752,7 +2921,7 @@ export const FUNCTIONS = [
2752
2921
  name: 'response',
2753
2922
  mcnSince: null,
2754
2923
  mcnNotes: null,
2755
- description: 'Output variable that contains the status of the POST request',
2924
+ description: 'Output variable that receives the response body',
2756
2925
  type: 'string',
2757
2926
  optional: true,
2758
2927
  },
@@ -2795,11 +2964,16 @@ export const FUNCTIONS = [
2795
2964
  mcnNotes: null,
2796
2965
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-http/mc-ampscript-reference-http-post2.html',
2797
2966
  guideUrl: 'https://ampscript.guide/httppost2/',
2967
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/httppost2/',
2798
2968
  minArgs: 3,
2799
2969
  maxArgs: INF,
2800
2970
  category: 'HTTP',
2971
+ isConfirmed: true,
2972
+ differsFromOfficialDocs: true,
2973
+ officialDocsNote:
2974
+ 'The official reference labels the fifth argument (response) as storing the "status" of the request, but on a live Engagement CloudPage (child MID 518005426) it receives the response BODY and the sixth argument (responseRowSet) receives the response HEADERS as a rowset (11 header rows observed). The HTTP status code is the function return value. The boolean exceptionOnError flag is accepted at position four.',
2801
2975
  description:
2802
- 'Performs an HTTP POST with access to response headers. Response body and headers are stored in output variables.',
2976
+ 'Performs an HTTP POST and returns the HTTP status code. The response body and the response headers (as a rowset) are written to optional output variables.',
2803
2977
  params: [
2804
2978
  { name: 'url', description: 'Request URL', type: 'string' },
2805
2979
  { name: 'contentType', description: 'Content-Type header', type: 'string' },
@@ -2864,11 +3038,16 @@ export const FUNCTIONS = [
2864
3038
  mcnNotes: null,
2865
3039
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-http/mc-ampscript-reference-http-post-with-retry.html',
2866
3040
  guideUrl: 'https://ampscript.guide/httppostwithretry/',
3041
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/httppostwithretry/',
2867
3042
  minArgs: 3,
2868
3043
  maxArgs: INF,
2869
3044
  category: 'HTTP',
3045
+ isConfirmed: true,
3046
+ differsFromOfficialDocs: true,
3047
+ officialDocsNote:
3048
+ 'The official reference labels the responseStatus argument as storing the "status" of the request, but on a live Engagement CloudPage (child MID 518005426) it receives the response BODY and responseContentRowset receives the response HEADERS as a rowset (11 header rows observed). The HTTP status code is the function return value. The numRetries, reschedule and returnExceptionOnError arguments are all accepted at runtime; retry-on-failure is documented but was not forced here because a transient failure could not be induced safely against the echo endpoint.',
2870
3049
  description:
2871
- 'Posts content to the specified URL with automatic retry logic on failure. Similar to HTTPPost2 but adds configurable retries and rescheduling.',
3050
+ 'Posts content to the specified URL with automatic retry logic on failure, and returns the HTTP status code. Similar to HTTPPost2 but adds configurable retries and rescheduling; the response body and headers (as a rowset) are written to optional output variables.',
2872
3051
  params: [
2873
3052
  { name: 'urlEndpoint', description: 'The URL to send the content to', type: 'string' },
2874
3053
  {
@@ -2905,7 +3084,7 @@ export const FUNCTIONS = [
2905
3084
  },
2906
3085
  {
2907
3086
  name: 'responseStatus',
2908
- description: 'An AMPscript variable that stores the status of the POST request',
3087
+ description: 'An AMPscript variable that receives the response body',
2909
3088
  type: 'string',
2910
3089
  optional: true,
2911
3090
  },
@@ -2951,8 +3130,13 @@ export const FUNCTIONS = [
2951
3130
  mcnSince: null,
2952
3131
  handlebarsEquivalent: null,
2953
3132
  mcnNotes: null,
3133
+ isConfirmed: true,
3134
+ differsFromOfficialDocs: true,
3135
+ officialDocsNote:
3136
+ 'Runtime-verified on a live Marketing Cloud Engagement CloudPage (child BU MID 518005426). The official reference states this function can only retrieve the standard HTTP headers listed in RFC 7231, but at runtime it also returns the value of a non-standard custom request header: a request sent with an X-Amp-Probe header returned that exact value, so the RFC 7231 restriction is not enforced when reading headers. A header that is absent from the request (for example Referer when none was sent) returns the empty string, matching the documented note.',
2954
3137
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-http/mc-ampscript-reference-http-request-header.html',
2955
3138
  guideUrl: 'https://ampscript.guide/httprequestheader/',
3139
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/httprequestheader/',
2956
3140
  minArgs: 1,
2957
3141
  maxArgs: 1,
2958
3142
  category: 'HTTP',
@@ -3042,6 +3226,13 @@ export const FUNCTIONS = [
3042
3226
  returnDescription: 'An HTML img tag for the referenced image.',
3043
3227
  syntax: 'Image(imageExternalKey[, defaultImageExternalKey])',
3044
3228
  example: "%%=Image('CorpLogo', 'DefaultImage')=%%",
3229
+ isConfirmed: true,
3230
+ nonFunctionalAtRuntime: true,
3231
+ deprecated: true,
3232
+ deprecatedReason:
3233
+ 'The classic Portfolio / Classic Content area this function reads from was retired in April 2023, so no image assets exist for it to reference on any current tenant, and every invocation aborts the page at runtime. Use ContentImageByKey or ContentImageByID against Content Builder image assets instead.',
3234
+ officialDocsNote:
3235
+ 'No working invocation was found on either the child QA BU (MID 518005426) or the parent BU (MID 7281698). Image resolves images from the legacy Portfolio, whose creation and applications have been retired; no Portfolio assets exist on either BU to reference. Every attempt aborted the CloudPage with HTTP 422 and no output: a literal URL, a Content Builder asset external key, and a plausible Portfolio-style key were all tried on the child BU, and a Portfolio-style key on the parent BU. Use ContentImageByKey or ContentImageByID against Content Builder image assets instead.',
3045
3236
  },
3046
3237
  {
3047
3238
  name: 'IndexOf',
@@ -3085,6 +3276,9 @@ export const FUNCTIONS = [
3085
3276
  mcnNotes: null,
3086
3277
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-insert-data.html',
3087
3278
  guideUrl: 'https://ampscript.guide/insertdata/',
3279
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/insertdata/',
3280
+ isConfirmed: true,
3281
+ differsFromOfficialDocs: false,
3088
3282
  minArgs: 3,
3089
3283
  maxArgs: INF,
3090
3284
  category: 'Data Extension',
@@ -3127,6 +3321,9 @@ export const FUNCTIONS = [
3127
3321
  mcnNotes: null,
3128
3322
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-insert-de.html',
3129
3323
  guideUrl: 'https://ampscript.guide/insertde/',
3324
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/insertde/',
3325
+ isConfirmed: true,
3326
+ differsFromOfficialDocs: false,
3130
3327
  minArgs: 3,
3131
3328
  maxArgs: INF,
3132
3329
  category: 'Data Extension',
@@ -3170,6 +3367,7 @@ export const FUNCTIONS = [
3170
3367
  mcnNotes: null,
3171
3368
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-create.html',
3172
3369
  guideUrl: 'https://ampscript.guide/invokecreate/',
3370
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokecreate/',
3173
3371
  minArgs: 3,
3174
3372
  maxArgs: 4,
3175
3373
  category: 'Marketing Cloud API',
@@ -3200,9 +3398,12 @@ export const FUNCTIONS = [
3200
3398
  },
3201
3399
  ],
3202
3400
  returnType: 'string',
3203
- returnDescription: 'The status of the create operation as returned by the API.',
3401
+ returnDescription:
3402
+ "The SOAP OverallStatus as a string — 'OK' on success, 'Error' on failure. The human-readable message goes to the statusMessage out-variable and the numeric error code to errorCode.",
3403
+ returnEnum: ['OK', 'Error'],
3204
3404
  syntax: 'InvokeCreate(apiObject, @statusMessage, @errorCode[, createOptionsObject])',
3205
3405
  example: '%%=InvokeCreate(@apiObject, @statusMessage, @errorCode)=%%',
3406
+ isConfirmed: true,
3206
3407
  },
3207
3408
  {
3208
3409
  name: 'InvokeDelete',
@@ -3211,6 +3412,7 @@ export const FUNCTIONS = [
3211
3412
  mcnNotes: null,
3212
3413
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-delete.html',
3213
3414
  guideUrl: 'https://ampscript.guide/invokedelete/',
3415
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokedelete/',
3214
3416
  minArgs: 3,
3215
3417
  maxArgs: 4,
3216
3418
  category: 'Marketing Cloud API',
@@ -3241,9 +3443,12 @@ export const FUNCTIONS = [
3241
3443
  },
3242
3444
  ],
3243
3445
  returnType: 'string',
3244
- returnDescription: 'The status of the delete operation as returned by the API.',
3446
+ returnDescription:
3447
+ "The SOAP OverallStatus as a string — 'OK' on success, 'Error' on failure. The human-readable message goes to the statusMessage out-variable and the numeric error code to errorCode.",
3448
+ returnEnum: ['OK', 'Error'],
3245
3449
  syntax: 'InvokeDelete(apiObject, @statusMessage, @errorCode[, deleteOptionsObject])',
3246
3450
  example: '%%=InvokeDelete(@apiObject, @statusMessage, @errorCode)=%%',
3451
+ isConfirmed: true,
3247
3452
  },
3248
3453
  {
3249
3454
  name: 'InvokeExecute',
@@ -3252,6 +3457,7 @@ export const FUNCTIONS = [
3252
3457
  mcnNotes: null,
3253
3458
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-execute.html',
3254
3459
  guideUrl: 'https://ampscript.guide/invokeexecute/',
3460
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokeexecute/',
3255
3461
  minArgs: 1,
3256
3462
  maxArgs: 3,
3257
3463
  category: 'Marketing Cloud API',
@@ -3276,9 +3482,10 @@ export const FUNCTIONS = [
3276
3482
  ],
3277
3483
  returnType: 'rowset',
3278
3484
  returnDescription:
3279
- 'A rowset containing the API response. Use Row() and Field() to read the StatusMessage and ErrorCode.',
3485
+ 'A rowset containing the API Results. Use Row() and Field() to read each result — StatusCode, StatusMessage and ErrorCode. The optional @statusMessage out-variable receives the OverallStatus string and @requestId receives the RequestID GUID.',
3280
3486
  syntax: 'InvokeExecute(apiObject[, @statusMessage, @requestId])',
3281
3487
  example: '%%[ SET @rows = InvokeExecute(@apiObject, @statusMessage, @requestId) ]%%',
3488
+ isConfirmed: true,
3282
3489
  },
3283
3490
  {
3284
3491
  name: 'InvokePerform',
@@ -3287,6 +3494,7 @@ export const FUNCTIONS = [
3287
3494
  mcnNotes: null,
3288
3495
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-perform.html',
3289
3496
  guideUrl: 'https://ampscript.guide/invokeperform/',
3497
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokeperform/',
3290
3498
  minArgs: 2,
3291
3499
  maxArgs: 3,
3292
3500
  category: 'Marketing Cloud API',
@@ -3308,9 +3516,12 @@ export const FUNCTIONS = [
3308
3516
  },
3309
3517
  ],
3310
3518
  returnType: 'string',
3311
- returnDescription: 'The status of the perform operation as returned by the API.',
3519
+ returnDescription:
3520
+ "The SOAP OverallStatus as a string — 'OK' on success, 'Error' on failure. The human-readable message goes to the optional @statusMessage out-variable.",
3521
+ returnEnum: ['OK', 'Error'],
3312
3522
  syntax: 'InvokePerform(apiObject, actionToPerform[, @statusMessage])',
3313
3523
  example: "%%=InvokePerform(@apiObject, 'Start', @statusMessage)=%%",
3524
+ isConfirmed: true,
3314
3525
  },
3315
3526
  {
3316
3527
  name: 'InvokeRetrieve',
@@ -3319,6 +3530,7 @@ export const FUNCTIONS = [
3319
3530
  mcnNotes: null,
3320
3531
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-retrieve.html',
3321
3532
  guideUrl: 'https://ampscript.guide/invokeretrieve/',
3533
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokeretrieve/',
3322
3534
  minArgs: 1,
3323
3535
  maxArgs: 3,
3324
3536
  category: 'Marketing Cloud API',
@@ -3350,6 +3562,7 @@ export const FUNCTIONS = [
3350
3562
  returnDescription: 'A rowset containing the retrieved API records.',
3351
3563
  syntax: 'InvokeRetrieve(apiObject[, @statusMessage, @requestId])',
3352
3564
  example: '%%[ SET @rows = InvokeRetrieve(@apiObject, @statusMessage, @requestId) ]%%',
3565
+ isConfirmed: true,
3353
3566
  },
3354
3567
  {
3355
3568
  name: 'InvokeUpdate',
@@ -3358,6 +3571,7 @@ export const FUNCTIONS = [
3358
3571
  mcnNotes: null,
3359
3572
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-update.html',
3360
3573
  guideUrl: 'https://ampscript.guide/invokeupdate/',
3574
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokeupdate/',
3361
3575
  minArgs: 1,
3362
3576
  maxArgs: 4,
3363
3577
  category: 'Marketing Cloud API',
@@ -3390,9 +3604,12 @@ export const FUNCTIONS = [
3390
3604
  },
3391
3605
  ],
3392
3606
  returnType: 'string',
3393
- returnDescription: 'The status of the update operation as returned by the API.',
3607
+ returnDescription:
3608
+ "The SOAP OverallStatus as a string — 'OK' on success, 'Error' on failure. The human-readable message goes to the statusMessage out-variable and the numeric error code to errorCode.",
3609
+ returnEnum: ['OK', 'Error'],
3394
3610
  syntax: 'InvokeUpdate(apiObject[, @statusMessage, @errorCode, updateOptions])',
3395
3611
  example: '%%=InvokeUpdate(@apiObject, @statusMessage, @errorCode)=%%',
3612
+ isConfirmed: true,
3396
3613
  },
3397
3614
  {
3398
3615
  name: 'IsCHTMLBrowser',
@@ -3588,6 +3805,13 @@ export const FUNCTIONS = [
3588
3805
  maxArgs: 2,
3589
3806
  category: 'Content',
3590
3807
  description: 'Generates a URL to a microsite page that serves live, dynamic content.',
3808
+ isConfirmed: true,
3809
+ nonFunctionalAtRuntime: true,
3810
+ deprecated: true,
3811
+ deprecatedReason:
3812
+ 'Live Offers (Live Content) was removed from Marketing Cloud in 2019 and the Classic Microsites this URL points at were retired in June 2022, so there is no provisionable modern equivalent and every invocation aborts the page at runtime.',
3813
+ officialDocsNote:
3814
+ "Attempted on both the child QA BU (MID 518005426) and the parent BU (MID 7281698). Every invocation shape aborted the CloudPage with HTTP 200 lost to a 422 page abort: the documented-valid LiveContentMicrositeURL('coupon','MyCoupon'), an unknown content type, and an empty external key all failed identically. The function resolves a Live Offers (Live Content) coupon by external key, and no such Live Content asset is provisioned on either BU, so no working invocation could be produced. Left blocked pending a tenant with a real Live Offers coupon.",
3591
3815
  params: [
3592
3816
  {
3593
3817
  name: 'contentType',
@@ -3644,6 +3868,9 @@ export const FUNCTIONS = [
3644
3868
  mcnNotes: null,
3645
3869
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-salesforce/mc-ampscript-reference-salesforce-long-sfid.html',
3646
3870
  guideUrl: 'https://ampscript.guide/longsfid/',
3871
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/longsfid/',
3872
+ isConfirmed: true,
3873
+ differsFromOfficialDocs: false,
3647
3874
  minArgs: 1,
3648
3875
  maxArgs: 1,
3649
3876
  category: 'Sales and Service Cloud',
@@ -3664,11 +3891,14 @@ export const FUNCTIONS = [
3664
3891
  'In MCN, search arguments must be provided in column/value pairs - an odd count causes an error. All filter keys must fully specify the composite primary key.',
3665
3892
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-lookup.html',
3666
3893
  guideUrl: 'https://ampscript.guide/lookup/',
3894
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/lookup/',
3895
+ isConfirmed: true,
3896
+ differsFromOfficialDocs: false,
3667
3897
  minArgs: 4,
3668
3898
  maxArgs: INF,
3669
3899
  category: 'Data Extension',
3670
3900
  description:
3671
- 'Returns a single field value from the first matching row in a data extension.',
3901
+ 'Returns a single field value from the first matching row in a data extension. A no-match returns an empty string.',
3672
3902
  params: [
3673
3903
  {
3674
3904
  name: 'dataObject',
@@ -3711,6 +3941,9 @@ export const FUNCTIONS = [
3711
3941
  mcnNotes: null,
3712
3942
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-lookup-ordered-rows.html',
3713
3943
  guideUrl: 'https://ampscript.guide/lookuporderedrows/',
3944
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/lookuporderedrows/',
3945
+ isConfirmed: true,
3946
+ differsFromOfficialDocs: false,
3714
3947
  minArgs: 5,
3715
3948
  maxArgs: INF,
3716
3949
  category: 'Data Extension',
@@ -3766,6 +3999,9 @@ export const FUNCTIONS = [
3766
3999
  mcnNotes: null,
3767
4000
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-lookup-ordered-rows-cs.html',
3768
4001
  guideUrl: 'https://ampscript.guide/lookuporderedrowscs/',
4002
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/lookuporderedrowscs/',
4003
+ isConfirmed: true,
4004
+ differsFromOfficialDocs: false,
3769
4005
  minArgs: 5,
3770
4006
  maxArgs: INF,
3771
4007
  category: 'Data Extension',
@@ -3820,6 +4056,9 @@ export const FUNCTIONS = [
3820
4056
  mcnNotes: null,
3821
4057
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-lookup-rows.html',
3822
4058
  guideUrl: 'https://ampscript.guide/lookuprows/',
4059
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/lookuprows/',
4060
+ isConfirmed: true,
4061
+ differsFromOfficialDocs: false,
3823
4062
  minArgs: 3,
3824
4063
  maxArgs: INF,
3825
4064
  category: 'Data Extension',
@@ -3860,6 +4099,9 @@ export const FUNCTIONS = [
3860
4099
  mcnNotes: null,
3861
4100
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-lookup-rows-cs.html',
3862
4101
  guideUrl: 'https://ampscript.guide/lookuprowscs/',
4102
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/lookuprowscs/',
4103
+ isConfirmed: true,
4104
+ differsFromOfficialDocs: false,
3863
4105
  minArgs: 3,
3864
4106
  maxArgs: INF,
3865
4107
  category: 'Data Extension',
@@ -3970,6 +4212,11 @@ export const FUNCTIONS = [
3970
4212
  category: 'MobileConnect',
3971
4213
  description:
3972
4214
  'Returns the URL of MMS content from an inbound mobile-originated (MO) message. Only usable in MobileConnect.',
4215
+ isConfirmed: false,
4216
+ verificationBlocked: true,
4217
+ verificationBlockedReason: 'no-working-invocation',
4218
+ officialDocsNote:
4219
+ 'Could not runtime-verify on the only available context (a CloudPage GET on cred/DEV, MID 510007949; no parent-BU escalation is configured on this tenant). Including an MMS_Content_URL(0) call in the injected content block aborted the whole page at compile time (HTTP 422) even when the call sat inside a non-matching IF branch, while an otherwise identical page with the call removed rendered HTTP 200. This matches the official reference, which states the function is usable only in MobileConnect and not in landing pages or other content types; there is no mobile-originated message context on a CloudPage to exercise it against.',
3973
4220
  params: [
3974
4221
  {
3975
4222
  name: 'position',
@@ -4070,6 +4317,11 @@ export const FUNCTIONS = [
4070
4317
  category: 'MobileConnect',
4071
4318
  description:
4072
4319
  'Returns the content of an inbound mobile-originated (MO) message. Only usable in MobileConnect. The only accepted argument value is 0.',
4320
+ isConfirmed: false,
4321
+ verificationBlocked: true,
4322
+ verificationBlockedReason: 'no-working-invocation',
4323
+ officialDocsNote:
4324
+ 'Could not runtime-verify on the only available context (a CloudPage GET on cred/DEV, MID 510007949; no parent-BU escalation is configured on this tenant). A page containing a Msg(0) call aborted at compile time (HTTP 422) even when the call sat inside a non-matching IF branch, whereas the same page with no Msg construct rendered HTTP 200 — so the abort happens at parse time, before any runtime gate. This matches the official reference, which states the function is usable only in MobileConnect and not in landing pages or other content types; a CloudPage supplies no mobile-originated message to read.',
4073
4325
  params: [
4074
4326
  {
4075
4327
  name: 'index',
@@ -4118,6 +4370,11 @@ export const FUNCTIONS = [
4118
4370
  category: 'MobileConnect',
4119
4371
  description:
4120
4372
  'Returns a single word that follows the keyword in an inbound mobile-originated (MO) message, by position. Only usable in MobileConnect, chained off Msg(0).',
4373
+ isConfirmed: false,
4374
+ verificationBlocked: true,
4375
+ verificationBlockedReason: 'no-working-invocation',
4376
+ officialDocsNote:
4377
+ 'Could not runtime-verify on the only available context (a CloudPage GET on cred/DEV, MID 510007949; no parent-BU escalation on this tenant). Noun is chained off Msg(0), and any page containing a Msg(0) construct aborts at compile time (HTTP 422) on a CloudPage while an otherwise identical page without it renders HTTP 200. This matches the official reference, which restricts the function to MobileConnect and forbids landing pages / other content types; a CloudPage supplies no mobile-originated message to parse.',
4121
4378
  params: [
4122
4379
  {
4123
4380
  name: 'position',
@@ -4143,6 +4400,11 @@ export const FUNCTIONS = [
4143
4400
  category: 'MobileConnect',
4144
4401
  description:
4145
4402
  'Returns all message content that follows the keyword in an inbound mobile-originated (MO) message. Only usable in MobileConnect, chained off Msg(0). Takes no arguments.',
4403
+ isConfirmed: false,
4404
+ verificationBlocked: true,
4405
+ verificationBlockedReason: 'no-working-invocation',
4406
+ officialDocsNote:
4407
+ 'Could not runtime-verify on the only available context (a CloudPage GET on cred/DEV, MID 510007949; no parent-BU escalation on this tenant). Nouns is chained off Msg(0), and any page containing a Msg(0) construct aborts at compile time (HTTP 422) on a CloudPage while an otherwise identical page without it renders HTTP 200. This matches the official reference, which restricts the function to MobileConnect and forbids landing pages / other content types; a CloudPage supplies no mobile-originated message to parse.',
4146
4408
  params: [],
4147
4409
  returnType: 'string',
4148
4410
  returnDescription: 'All content that follows the keyword in the inbound message.',
@@ -4397,6 +4659,11 @@ export const FUNCTIONS = [
4397
4659
  returnDescription: 'An HTML string of star images representing the rating.',
4398
4660
  syntax: 'RatingStars(rating, maxRating, imageUrl)',
4399
4661
  example: "%%=RatingStars(4, 5, 'https://example.com/star.png')=%%",
4662
+ isConfirmed: false,
4663
+ verificationBlocked: true,
4664
+ verificationBlockedReason: 'no-test-data',
4665
+ officialDocsNote:
4666
+ 'No working CloudPage invocation was found. Any valid-arity call aborts the whole page with HTTP 422 at compile time, even when placed inside an unreached IF gate, so it cannot be probed behind a query-string switch. Two signature shapes were each deployed as the whole page: the catalog form RatingStars(4, 5, "https://example.com/star.png") and the ampscript.guide form RatingStars(5, "yellow", 25). Both returned HTTP 422 on the child BU (MID 518005426) and again on the parent BU (MID 7281698). The surrounding harness structure (RequestParameter gating, IF/ELSE/ENDIF) returned HTTP 200 once the RatingStars call was removed, confirming the abort is caused by the function itself, not the harness. RatingStars is an Einstein Email Recommendations helper that appears to resolve only inside the recommendations rendering context, which a bare CloudPage does not supply.',
4400
4667
  },
4401
4668
  {
4402
4669
  name: 'Redirect',
@@ -4632,6 +4899,11 @@ export const FUNCTIONS = [
4632
4899
  syntax: 'RetrieveMSCRMRecords(entityName, fieldsToRetrieve, queryFieldName, queryFieldOperator, queryFieldValue)',
4633
4900
  example:
4634
4901
  "%%[ SET @rows = RetrieveMSCRMRecords('contact', 'fullname,emailaddress1', 'lastname', 'eq', 'Smith') ]%%",
4902
+ isConfirmed: true,
4903
+ nonFunctionalAtRuntime: true,
4904
+ deprecated: true,
4905
+ deprecatedReason:
4906
+ 'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
4635
4907
  },
4636
4908
  {
4637
4909
  name: 'RetrieveMSCRMRecordsFetchXML',
@@ -4649,6 +4921,11 @@ export const FUNCTIONS = [
4649
4921
  returnDescription: 'A rowset of CRM records matching the FetchXML query.',
4650
4922
  syntax: 'RetrieveMSCRMRecordsFetchXML(fetchXml)',
4651
4923
  example: '%%[ SET @rows = RetrieveMSCRMRecordsFetchXML(@fetchXml) ]%%',
4924
+ isConfirmed: true,
4925
+ nonFunctionalAtRuntime: true,
4926
+ deprecated: true,
4927
+ deprecatedReason:
4928
+ 'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
4652
4929
  },
4653
4930
  {
4654
4931
  name: 'RetrieveSalesforceJobSources',
@@ -4657,13 +4934,25 @@ export const FUNCTIONS = [
4657
4934
  mcnNotes: null,
4658
4935
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-salesforce/mc-ampscript-reference-salesforce-retrieve-job-sources.html',
4659
4936
  guideUrl: 'https://ampscript.guide/retrievesalesforcejobsources/',
4937
+ sfmcGuideUrl:
4938
+ 'https://sfmc.guide/engagement/ampscript/functions/retrievesalesforcejobsources/',
4939
+ isConfirmed: true,
4940
+ differsFromOfficialDocs: false,
4660
4941
  minArgs: 1,
4661
4942
  maxArgs: 1,
4662
4943
  category: 'Sales and Service Cloud',
4663
- description: 'Retrieves the data sources associated with a Salesforce-triggered send job.',
4664
- params: [{ name: 'jobId', description: 'Job identifier', type: 'number' }],
4944
+ description:
4945
+ 'Retrieves the source records (SourceID, SourceType, IsInclusionSource) that made up the audience of a Salesforce-triggered send, matched by its numeric job ID, and returns them as a rowset. Requires an active Marketing Cloud Connect integration. A job ID with no matching sources returns an empty rowset rather than an error; the function reports nothing about the job status.',
4946
+ params: [
4947
+ {
4948
+ name: 'jobId',
4949
+ description: 'The numeric job ID of the Salesforce send',
4950
+ type: 'number',
4951
+ },
4952
+ ],
4665
4953
  returnType: 'rowset',
4666
- returnDescription: 'A rowset describing the sources of the referenced send job.',
4954
+ returnDescription:
4955
+ 'A rowset of the send sources (SourceID, SourceType, IsInclusionSource); an empty rowset when the job ID has no matching sources.',
4667
4956
  syntax: 'RetrieveSalesforceJobSources(jobId)',
4668
4957
  example: '%%[ SET @rows = RetrieveSalesforceJobSources(@jobId) ]%%',
4669
4958
  },
@@ -4675,10 +4964,15 @@ export const FUNCTIONS = [
4675
4964
  mcnNotes: null,
4676
4965
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-salesforce/mc-ampscript-reference-salesforce-retrieve-objects.html',
4677
4966
  guideUrl: 'https://ampscript.guide/retrievesalesforceobjects/',
4967
+ sfmcGuideUrl:
4968
+ 'https://sfmc.guide/engagement/ampscript/functions/retrievesalesforceobjects/',
4969
+ isConfirmed: true,
4970
+ differsFromOfficialDocs: false,
4678
4971
  minArgs: 5,
4679
4972
  maxArgs: INF,
4680
4973
  category: 'Sales and Service Cloud',
4681
- description: 'Retrieves records from a connected Salesforce CRM object.',
4974
+ description:
4975
+ 'Retrieves records from a connected Salesforce Sales or Service Cloud object via Marketing Cloud Connect and returns them as a rowset. Requires an active Marketing Cloud Connect integration; a call against an unknown object name aborts the page.',
4682
4976
  params: [
4683
4977
  {
4684
4978
  name: 'objectName',
@@ -4736,10 +5030,14 @@ export const FUNCTIONS = [
4736
5030
  mcnNotes: null,
4737
5031
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-row.html',
4738
5032
  guideUrl: 'https://ampscript.guide/row/',
5033
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/row/',
5034
+ isConfirmed: true,
5035
+ differsFromOfficialDocs: false,
4739
5036
  minArgs: 2,
4740
5037
  maxArgs: 2,
4741
5038
  category: 'Data Extension',
4742
- description: 'Returns a specific row from a rowset by its 1-based index.',
5039
+ description:
5040
+ 'Returns a specific row from a rowset by its 1-based index. Index 0 (or any out-of-range index) aborts the page rather than returning an empty row.',
4743
5041
  params: [
4744
5042
  { name: 'rowset', description: 'Rowset to access', type: 'rowset' },
4745
5043
  { name: 'rowIndex', description: '1-based row index', type: 'number' },
@@ -4757,6 +5055,9 @@ export const FUNCTIONS = [
4757
5055
  mcnNotes: null,
4758
5056
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-row-count.html',
4759
5057
  guideUrl: 'https://ampscript.guide/rowcount/',
5058
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/rowcount/',
5059
+ isConfirmed: true,
5060
+ differsFromOfficialDocs: false,
4760
5061
  minArgs: 1,
4761
5062
  maxArgs: 1,
4762
5063
  category: 'Data Extension',
@@ -4774,6 +5075,7 @@ export const FUNCTIONS = [
4774
5075
  mcnNotes: null,
4775
5076
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-set-object-property.html',
4776
5077
  guideUrl: 'https://ampscript.guide/setobjectproperty/',
5078
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/setobjectproperty/',
4777
5079
  minArgs: 3,
4778
5080
  maxArgs: 3,
4779
5081
  category: 'Marketing Cloud API',
@@ -4795,26 +5097,48 @@ export const FUNCTIONS = [
4795
5097
  returnDescription: 'No value is returned; the named property is set on the object.',
4796
5098
  syntax: 'SetObjectProperty(apiObject, propertyName, propertyValue)',
4797
5099
  example: "SetObjectProperty(@apiObject, 'LastName', 'Smith')",
5100
+ isConfirmed: true,
4798
5101
  },
4799
5102
  {
4800
5103
  name: 'SetSmsConversationNextKeyword',
4801
5104
  mcnSince: null,
4802
5105
  handlebarsEquivalent: null,
4803
5106
  mcnNotes: null,
5107
+ docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-sms/mc-ampscript-reference-sms-set-sms-conversation-next-keyword.html',
4804
5108
  guideUrl: 'https://ampscript.guide/setsmsconversationnextkeyword/',
4805
5109
  minArgs: 3,
4806
5110
  maxArgs: 3,
4807
5111
  category: 'MobileConnect',
4808
- description: 'Sets the next expected keyword for an active SMS conversation.',
5112
+ description:
5113
+ 'Sets the keyword for the next path of an existing SMS conversation, applied when the contact next replies. Does not create a new conversation. Returns true when set inside a MobileConnect message context, and false in any other context (for example a CloudPage or email). The success path cannot be exercised outside a live MobileConnect send.',
5114
+ isConfirmed: false,
5115
+ verificationBlocked: true,
5116
+ verificationBlockedReason: 'no-working-invocation',
5117
+ differsFromOfficialDocs: true,
5118
+ officialDocsNote:
5119
+ 'Runtime-observed on cred/DEV (MID 510007949), the only BU available (no parent-BU escalation). This is an ordinary function call, so it compiles and runs on a CloudPage: called there with a real short code, the authorized destination number and a keyword, it returned the literal boolean false (Empty() false) and the page rendered fully with no exception — no SMS was sent and no conversation state changed. This confirms the ampscript.guide claim that the function returns false outside a MobileConnect message context; the official Salesforce reference omits this and describes only the in-context behaviour. The success path (true, keyword actually set) requires a live MobileConnect message context that cannot be captured on this tenant, so the function is recorded blocked for the success path while the CloudPage false-return is proven. The catalogued signature was corrected here: the three parameters are originationNumber, destinationNumber and keyword, and the return is a boolean, not void. A docUrl to the official reference was also added.',
4809
5120
  params: [
4810
- { name: 'shortCode', description: 'SMS short code', type: 'string' },
4811
- { name: 'keyword', description: 'Current conversation keyword', type: 'string' },
4812
- { name: 'nextKeyword', description: 'Next expected keyword', type: 'string' },
5121
+ {
5122
+ name: 'originationNumber',
5123
+ description: 'The MobileConnect short code or long code used to send',
5124
+ type: 'string',
5125
+ },
5126
+ {
5127
+ name: 'destinationNumber',
5128
+ description: "The contact's phone number, including country code",
5129
+ type: 'string',
5130
+ },
5131
+ {
5132
+ name: 'keyword',
5133
+ description: 'The string to set as the next conversation keyword',
5134
+ type: 'string',
5135
+ },
4813
5136
  ],
4814
- returnType: 'void',
4815
- returnDescription: 'No value is returned; the next expected keyword is set.',
4816
- syntax: 'SetSmsConversationNextKeyword(shortCode, keyword, nextKeyword)',
4817
- example: "SetSmsConversationNextKeyword('12345', 'JOIN', 'CONFIRM')",
5137
+ returnType: 'boolean',
5138
+ returnDescription:
5139
+ 'true when the next keyword is set inside a MobileConnect message context; false in any other context (proven on a CloudPage). Fails with an exception in-context if unsuccessful.',
5140
+ syntax: 'SetSmsConversationNextKeyword(originationNumber, destinationNumber, keyword)',
5141
+ example: '%%=SetSmsConversationNextKeyword("12345", MOBILE_NUMBER, "EXAMPLE")=%%',
4818
5142
  },
4819
5143
  {
4820
5144
  name: 'SetStateMscrmRecord',
@@ -4855,6 +5179,11 @@ export const FUNCTIONS = [
4855
5179
  returnDescription: 'No value is returned; the record state and status are updated.',
4856
5180
  syntax: 'SetStateMscrmRecord(recordGuid, entityName, stateToSet, statusToSet)',
4857
5181
  example: "SetStateMscrmRecord(@guid, 'contact', 'active', 1)",
5182
+ isConfirmed: true,
5183
+ nonFunctionalAtRuntime: true,
5184
+ deprecated: true,
5185
+ deprecatedReason:
5186
+ 'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
4858
5187
  },
4859
5188
  {
4860
5189
  name: 'SHA1',
@@ -5141,10 +5470,12 @@ export const FUNCTIONS = [
5141
5470
  mcnNotes: null,
5142
5471
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-transform-xml.html',
5143
5472
  guideUrl: 'https://ampscript.guide/transformxml/',
5473
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/transformxml/',
5144
5474
  minArgs: 2,
5145
5475
  maxArgs: 2,
5146
5476
  category: 'Content',
5147
5477
  description: 'Transforms an XML document using an XSLT stylesheet.',
5478
+ isConfirmed: true,
5148
5479
  params: [
5149
5480
  { name: 'xmlDocument', description: 'XML document string', type: 'string' },
5150
5481
  { name: 'xslDocument', description: 'XSLT stylesheet string', type: 'string' },
@@ -5161,11 +5492,14 @@ export const FUNCTIONS = [
5161
5492
  mcnNotes: null,
5162
5493
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-treat-as-content.html',
5163
5494
  guideUrl: 'https://ampscript.guide/treatascontent/',
5495
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/treatascontent/',
5164
5496
  minArgs: 1,
5165
5497
  maxArgs: 1,
5498
+ isConfirmed: true,
5499
+ differsFromOfficialDocs: false,
5166
5500
  category: 'Content',
5167
5501
  description:
5168
- 'Evaluates a string as AMPscript content, rendering any embedded AMPscript expressions.',
5502
+ 'Evaluates a string as AMPscript content, rendering any embedded AMPscript expressions, and returns the rendered string. Plain text and the empty string pass through unchanged.',
5169
5503
  params: [
5170
5504
  {
5171
5505
  name: 'stringToReturn',
@@ -5187,11 +5521,14 @@ export const FUNCTIONS = [
5187
5521
  mcnNotes: null,
5188
5522
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-treat-as-content-area.html',
5189
5523
  guideUrl: 'https://ampscript.guide/treatascontentarea/',
5524
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/treatascontentarea/',
5190
5525
  minArgs: 2,
5191
5526
  maxArgs: 3,
5527
+ isConfirmed: true,
5528
+ differsFromOfficialDocs: false,
5192
5529
  category: 'Content',
5193
5530
  description:
5194
- 'Treats a string as a content area, optionally assigning it to an impression region.',
5531
+ 'Stores a content string under a key for the duration of a send and renders it, evaluating any embedded AMPscript. An optional third argument names an impression region.',
5195
5532
  params: [
5196
5533
  { name: 'contentKey', description: 'Content area key identifier', type: 'string' },
5197
5534
  { name: 'contentValue', description: 'HTML/AMPscript content', type: 'string' },
@@ -5240,6 +5577,9 @@ export const FUNCTIONS = [
5240
5577
  mcnNotes: null,
5241
5578
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-update-data.html',
5242
5579
  guideUrl: 'https://ampscript.guide/updatedata/',
5580
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/updatedata/',
5581
+ isConfirmed: true,
5582
+ differsFromOfficialDocs: false,
5243
5583
  minArgs: 6,
5244
5584
  maxArgs: INF,
5245
5585
  category: 'Data Extension',
@@ -5305,6 +5645,9 @@ export const FUNCTIONS = [
5305
5645
  mcnNotes: null,
5306
5646
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-update-de.html',
5307
5647
  guideUrl: 'https://ampscript.guide/updatede/',
5648
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/updatede/',
5649
+ isConfirmed: true,
5650
+ differsFromOfficialDocs: false,
5308
5651
  minArgs: 6,
5309
5652
  maxArgs: INF,
5310
5653
  category: 'Data Extension',
@@ -5411,6 +5754,11 @@ export const FUNCTIONS = [
5411
5754
  repeat: [{ startIndex: 2, groupSize: 2, minGroups: 1 }],
5412
5755
  syntax: 'UpdateMSCRMRecords(entityName, guidsToUpdate, attributeName1, attributeValue1[, attributeNameN, attributeValueN, ...])',
5413
5756
  example: "%%=UpdateMSCRMRecords('contact', @guids, 'lastname', 'Smith')=%%",
5757
+ isConfirmed: true,
5758
+ nonFunctionalAtRuntime: true,
5759
+ deprecated: true,
5760
+ deprecatedReason:
5761
+ 'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
5414
5762
  },
5415
5763
  {
5416
5764
  name: 'UpdateSingleSalesforceObject',
@@ -5419,11 +5767,17 @@ export const FUNCTIONS = [
5419
5767
  mcnNotes: null,
5420
5768
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-salesforce/mc-ampscript-reference-salesforce-update-single-object.html',
5421
5769
  guideUrl: 'https://ampscript.guide/updatesinglesalesforceobject/',
5770
+ sfmcGuideUrl:
5771
+ 'https://sfmc.guide/engagement/ampscript/functions/updatesinglesalesforceobject/',
5422
5772
  minArgs: 4,
5423
5773
  maxArgs: INF,
5424
5774
  category: 'Sales and Service Cloud',
5425
5775
  description:
5426
- 'Updates a single record in a connected Salesforce CRM object. Accepts one or more field name and value pairs. Returns 1 on success, 0 otherwise.',
5776
+ 'Updates a single record in a connected Salesforce Sales or Service Cloud object via Marketing Cloud Connect. Accepts one or more field name and value pairs. Returns 1 on success; per the official reference it returns 0 on failure, but on a CloudPage a failed update (unknown object, malformed or non-existent record ID) instead surfaces the SOAP fault as an uncatchable page abort rather than returning 0.',
5777
+ isConfirmed: true,
5778
+ differsFromOfficialDocs: false,
5779
+ officialDocsNote:
5780
+ 'The success token 1 was runtime-proven on cred/DEV (MID 510007949), which has an active Marketing Cloud Connect integration to a real Salesforce org: updating one field of a record created moments earlier in the same run (a benign Task) returned the literal 1 with the page rendering fully. The failure token 0 is NOT observable in CloudPage GET context: every safe induced failure (unknown object, a malformed ID, and a well-formed but non-existent Lead ID at both 15 and 18 characters, on a real field) aborted the whole page with HTTP 422 — the SOAP fault propagates as an uncatchable page abort (identical to CreateSalesforceObject and RetrieveSalesforceObjects against a bad target), so the documented 0 return never materialises to be read. returnEnum is therefore left unset: only 1 is provable here, and asserting a [0,1] enum would ship the unproven 0 token. returnType stays number and the 0/1 semantics are retained in the description as a documented fact attributed to the official reference. The 0-on-CloudPage-abort behaviour is a context observation, not a contradiction of the send/preview-context 0/1 contract, so differsFromOfficialDocs stays false.',
5427
5781
  params: [
5428
5782
  {
5429
5783
  name: 'objectName',
@@ -5446,8 +5800,8 @@ export const FUNCTIONS = [
5446
5800
  { name: 'fieldValueN', description: 'Additional field value', optional: true },
5447
5801
  ],
5448
5802
  returnType: 'number',
5449
- returnDescription: '1 when the record was updated successfully, otherwise 0.',
5450
- returnEnum: [0, 1],
5803
+ returnDescription:
5804
+ '1 when the record was updated successfully (runtime-proven). Per the official reference a failed update returns 0, but on a CloudPage a failure aborts the page (HTTP 422) instead of returning 0, so the 0 token is not observable in that context.',
5451
5805
  repeat: [{ startIndex: 2, groupSize: 2, minGroups: 1 }],
5452
5806
  syntax: 'UpdateSingleSalesforceObject(objectName, idToUpdate, fieldName1, fieldValue1[, fieldNameN, fieldValueN, ...])',
5453
5807
  example: "%%=UpdateSingleSalesforceObject('Contact', @recordId, 'LastName', 'Smith')=%%",
@@ -5487,11 +5841,16 @@ export const FUNCTIONS = [
5487
5841
  mcnNotes: null,
5488
5842
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-contacts/mc-ampscript-reference-contacts-upsert-contact.html',
5489
5843
  guideUrl: 'https://ampscript.guide/upsertcontact/',
5844
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/upsertcontact/',
5490
5845
  minArgs: 5,
5491
5846
  maxArgs: INF,
5492
5847
  category: 'MobileConnect',
5493
5848
  description:
5494
- 'Upserts attributes into a contact record. If the contact exists it is updated; otherwise a new contact is created.',
5849
+ "Upserts attributes onto a mobile contact matched by phone number. If the contact exists it is updated; otherwise a new contact is created. Returns a status code: 0 when the upsert succeeds and 1 when an error occurs. The only supported channel is 'mobile' and the only supported match attribute is 'phone'. An unknown attribute name returns the error status without writing anything.",
5850
+ isConfirmed: true,
5851
+ differsFromOfficialDocs: false,
5852
+ officialDocsNote:
5853
+ 'Both return tokens were runtime-proven on cred/DEV (MID 510007949). The success status 0 was proven by creating a brand-new mobile contact keyed on an opaque, unreachable phone number in a reserved test range with a documented system attribute (_ZipCode); calling the same key a second time with a different value updated that contact and again returned 0, so both the create and update branches of the upsert return 0. The error status 1 was proven three independent ways (unsupported channel, unsupported match attribute, non-numeric phone) and again by passing an attribute name that is not a defined MobileConnect attribute — each returned 1 with the page rendering fully and no write performed. The return is a status code (0 success / 1 error), not a count of records. The phone-number argument accepts both an integer literal and a numeric string (both returned 0 for a successful create). runtime matches the official reference, so differsFromOfficialDocs stays false.',
5495
5854
  params: [
5496
5855
  {
5497
5856
  name: 'channel',
@@ -5507,7 +5866,7 @@ export const FUNCTIONS = [
5507
5866
  {
5508
5867
  name: 'phoneNumber',
5509
5868
  description: 'The phone number of the contact, including the country code',
5510
- type: 'number',
5869
+ type: 'string|number',
5511
5870
  },
5512
5871
  {
5513
5872
  name: 'keyToUpsert1',
@@ -5530,10 +5889,12 @@ export const FUNCTIONS = [
5530
5889
  { name: 'valueToUpsertN', description: 'Additional attribute value', optional: true },
5531
5890
  ],
5532
5891
  returnType: 'number',
5533
- returnDescription: 'The number of contact records created or updated.',
5892
+ returnEnum: [0, 1],
5893
+ returnDescription:
5894
+ 'A status code: 0 when the upsert succeeds (both creating a new contact and updating an existing one), 1 when an error occurs. Both tokens were proven at runtime.',
5534
5895
  repeat: [{ startIndex: 3, groupSize: 2, minGroups: 1 }],
5535
5896
  syntax: 'UpsertContact(channel, attribute, phoneNumber, keyToUpsert1, valueToUpsert1[, keyToUpsertN, valueToUpsertN, ...])',
5536
- example: "%%=UpsertContact('SMS', 'phone', '+17182097651', 'FirstName', 'Curt')=%%",
5897
+ example: "%%=UpsertContact('mobile', 'phone', 14255550142, '_ZipCode', '98026')=%%",
5537
5898
  },
5538
5899
  {
5539
5900
  name: 'UpsertData',
@@ -5542,6 +5903,9 @@ export const FUNCTIONS = [
5542
5903
  mcnNotes: null,
5543
5904
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-upsert-data.html',
5544
5905
  guideUrl: 'https://ampscript.guide/upsertdata/',
5906
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/upsertdata/',
5907
+ isConfirmed: true,
5908
+ differsFromOfficialDocs: false,
5545
5909
  minArgs: 6,
5546
5910
  maxArgs: INF,
5547
5911
  category: 'Data Extension',
@@ -5617,6 +5981,9 @@ export const FUNCTIONS = [
5617
5981
  mcnNotes: null,
5618
5982
  docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-upsert-de.html',
5619
5983
  guideUrl: 'https://ampscript.guide/upsertde/',
5984
+ sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/upsertde/',
5985
+ isConfirmed: true,
5986
+ differsFromOfficialDocs: false,
5620
5987
  minArgs: 6,
5621
5988
  maxArgs: INF,
5622
5989
  category: 'Data Extension',
@@ -5751,6 +6118,11 @@ export const FUNCTIONS = [
5751
6118
  syntax: 'UpsertMSCRMRecord(entityName, sortField, sortType, numPairsForRetrieve, filterAttributeName, filterAttributeValue, numPairsForUpdate, updateAttributeName, updateAttributeValue)',
5752
6119
  example:
5753
6120
  "%%=UpsertMSCRMRecord('contact', 'createdon', 'DESC', 1, 'emailaddress1', @email, 1, 'lastname', 'Smith')=%%",
6121
+ isConfirmed: true,
6122
+ nonFunctionalAtRuntime: true,
6123
+ deprecated: true,
6124
+ deprecatedReason:
6125
+ 'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
5754
6126
  },
5755
6127
  {
5756
6128
  name: 'URLEncode',
@@ -5808,6 +6180,11 @@ export const FUNCTIONS = [
5808
6180
  category: 'MobileConnect',
5809
6181
  description:
5810
6182
  'Returns the keyword (verb) from an inbound mobile-originated (MO) message. Only usable in MobileConnect, chained off Msg(0). Takes no arguments.',
6183
+ isConfirmed: false,
6184
+ verificationBlocked: true,
6185
+ verificationBlockedReason: 'no-working-invocation',
6186
+ officialDocsNote:
6187
+ 'Could not runtime-verify on the only available context (a CloudPage GET on cred/DEV, MID 510007949; no parent-BU escalation on this tenant). Verb is chained off Msg(0), and any page containing a Msg(0) construct aborts at compile time (HTTP 422) on a CloudPage while an otherwise identical page without it renders HTTP 200. This matches the official reference, which restricts the function to MobileConnect and forbids landing pages / other content types; a CloudPage supplies no mobile-originated message to parse.',
5811
6188
  params: [],
5812
6189
  returnType: 'string',
5813
6190
  returnDescription: 'The keyword (first word) of the inbound mobile-originated message.',