Skip to main content

Notas Técnicas y Advertencias

Discrepancia en el campo de colaboración​

La clase SS_SearchProductsAction usa HK_Collaboration__c para filtrar colaboraciones, pero el package.xml y el permission set despliegan SS_Collaboration__c. Son dos campos distintos:

CampoOrigenUso en el código
HK_Collaboration__cPre-existente en el org (prefijo HK)SS_SearchProductsAction — filtro de búsqueda Y respuesta JSON
SS_Collaboration__cCreado en este proyecto (prefijo SS)package.xml + permission set — pero NO en el query SOQL

Acción recomendada: Verificar en producción qué campo contiene los datos de colaboración. Si los datos están en HK_Collaboration__c, SS_Collaboration__c puede eliminarse del package.xml.

Inconsistencias de locale: embed snippet vs. clase Apex​

Ver detalle completo en Integración SFCC.

Límite de productos devueltos​

La clase devuelve máximo 5 productos aleatorizados de un pool de hasta 20. Este límite es configurable en el código. El agente selecciona 2-3 para mostrar al usuario según las instrucciones v3.

Seguridad y permisos​

  • La clase usa with sharing — respeta las reglas de sharing del org.
  • Las queries usan String.escapeSingleQuotes() para evitar SOQL injection.
  • El permission set SS_Product2_Attributes debe estar asignado al usuario de integración/Agentforce.
  • El campo ImageURL__c ya existía en el org — verificar que el usuario del agente tenga acceso de lectura.

Governor Limits​

La clase ejecuta 1 o 2 queries SOQL por invocación. Los límites estándar de Salesforce (100 queries por transacción) no deberían ser un problema para el volumen esperado.

Si se escala a alto tráfico, considerar Platform Cache para cachear resultados frecuentes.

Versión API y compatibilidad​

  • API version: 59.0 (Winter'25)
  • Agentforce Messaging SDK: versión 0.3 (init.js)

Para producción, verificar que la versión del SDK sea la correcta para el org destino.