API de REST de Chatter

Integre aplicaciones móviles, sitios de intranet y aplicaciones web de terceros con Salesforce con la API de REST de Chatter. Incluya hipervínculos en publicaciones, depure actividad de misión para usuarios y aproveche Next Best Action disponible de forma general.
Nota

Nota

Para crear experiencias personalizadas de Chatter y comunidades en Salesforce, use ConnectApi (Chatter en Apex): Clases y enumeraciones nuevas y modificadas.

Recursos nuevos y modificados de la API de REST de Chatter

Estos recursos son nuevos o tienen cambios.

Noticias en tiempo real de Chatter

Incluir un hipervínculo en una publicación
Realice una solicitud POST en el recurso /chatter/feed-elements con la entrada de segmento de mensaje actualizada: mensaje de inicio de marca y entrada de segmento de mensaje de fin de marca.
Incluir un hipervínculo en un comentario
Realice una solicitud POST al recurso existente /chatter/feed-elements/feedElementId/capabilities/comments/items con la nueva entrada de segmentos de mensaje: mensaje de inicio de marca y entrada de segmento de mensaje de fin de marca.
Mover una publicación de un grupo público a otro
Realice una solicitud PATCH al recurso /chatter/feed-elements/feedElementId existente con el cuerpo de solicitud Entrada de elemento de noticias en tiempo real existente. Establezca la propiedad subjectId del cuerpo de solicitud Entrada de elemento de noticias en tiempo real como el nuevo Id. de grupo público.

Misiones

Exportar actividad de misiones para un usuario
Realice una solicitud GET al nuevo recurso /connect/communities/communityId/missions/users/userId/activities/export-job.
Iniciar un trabajo para depurar actividad de misión para un usuario
Realice una solicitud POST al nuevo recurso /connect/communities/communityId/missions/users/userId/activities/purge-job.
Nota

Nota

POST no implica parámetros de solicitud ni un cuerpo de solicitud.

Actualizar los conteos de actividad de misión para un usuario
Realice una solicitud PATCH al nuevo recurso /connect/communities/communityId/missions/users/userId con el nuevo cuerpo de solicitud Entrada de actividad de misión del usuario.

Next Best Actions (Disponible de forma general)

Todos los recursos Next Best Action, incluyendo los recursos presentados en las versiones 43.0 y 44.0 ahora tienen una versión mínima 45.0. Todas las propiedades de los cuerpos de la solicitudes y las respuestas relacionadas también tienen una versión mínima 45.0.
Obtener una recomendación
Realice una solicitud GET al nuevo recurso /connect/recommendations/recommendationId .
Nota

Nota

Este recurso sustituye /connect/propositions/propositionId.

Ejecutar una estrategia y solicitar información de rastreo
Realice una solicitud POST al recurso existente /connect/recommendation-strategies/strategyName/recommendations con el cuerpo de solicitud actualizado Entrada de estrategia de Next Best Action o con el nuevo parámetro debugTrace establecido como true.
Obtener reacciones de recomendaciones
Realice una solicitud GET al recurso existente /connect/recommendation-strategies/reactions.
Los usuarios con el permiso Gestionar recomendaciones de Next Best Action o Modificar todos los datos pueden obtener reacciones de recomendaciones.
Obtener una reacción de recomendaciones
Realice una solicitud GET al nuevo recurso /connect/recommendation-strategies/reactions/reactionId .
Los usuarios con el permiso Gestionar recomendaciones de Next Best Action o Modificar todos los datos pueden obtener reacciones de recomendaciones.
Eliminar una reacción de recomendaciones
Realice una solicitud DELETE al nuevo recurso /connect/recommendation-strategies/reactions/reactionId .
Los usuarios con el permiso Gestionar recomendaciones de Next Best Action o Modificar todos los datos pueden eliminar reacciones de recomendaciones.

Implicación en redes sociales

Obtener intenciones disponibles para una publicación de redes sociales
Realice una solicitud GET al nuevo recurso /connect/social-engagement/social-posts/socialPostId/intents.
Seguir una persona en redes sociales
Realice una solicitud PUT al nuevo recurso /connect/social-engagement/social-persona/socialPersonaId/intents/follow/socialAccountId.

socialPersonaId es el Id. de la persona a seguir y socialAccountId es el Id. de la cuenta que sigue la persona.

Realice una solicitud PUT al nuevo recurso /connect/social-engagement/social-posts/socialPostId/intents/follow/socialAccountId.

socialPostId es el Id. de la publicación creada por la persona a seguir y socialAccountId es el Id. de la cuenta que sigue la persona.

Dejar de seguir una persona en redes sociales
Realice una solicitud DELETE al nuevo recurso /connect/social-engagement/social-persona/socialPersonaId/intents/follow/socialAccountId.

socialPersonaId es el Id. de la persona a dejar de seguir y socialAccountId es el Id. de la cuenta que deja de seguir a la persona.

Realice una solicitud DELETE al nuevo recurso /connect/social-engagement/social-posts/socialPostId/intents/follow/socialAccountId.

socialPostId es el Id. de la publicación creada por la persona a dejar de seguir y socialAccountId es el Id. de la cuenta que deja de seguir a la persona.

Configuración de Implicación en redes sociales

Obtener la configuración de Servicio al cliente de redes sociales
Realice una solicitud GET al nuevo recurso /connect/social-engagement/setup/config.
Actualizar la configuración de Servicio al cliente de redes sociales
Realice una solicitud PATCH al nuevo recurso /connect/social-engagement/setup/config con el cuerpo de solicitud existente Configuración de servicio al cliente de redes sociales.

Usuarios

Obtener y buscar grupos de un usuario y obtener información de grupo más detallada
Realice una solicitud GET al recurso existente /chatter/users/userId/groups. Este recurso devuelve ahora un cuerpo de respuesta Conjunto de detalles de grupo de usuario.

Cuerpos de solicitud nuevos y modificados de la API de REST de Chatter

A continuación se describen los cuerpos de solicitud nuevos o que incluyen cambios.

Noticias en tiempo real de Chatter

Entrada de segmentos de mensaje: Inicio de marca
Este cuerpo de solicitud tiene estas propiedades nuevas y modificadas.
  • altText: Texto alternativo para el segmento Hyperlink.
  • markupType: Ahora admite marca de hipervínculo.
  • url: URL para el segmento Hyperlink. Las direcciones URL de hipervínculo compatibles comienzan por http:// o https://.
Entrada de segmentos de mensaje: Fin de marca
Este cuerpo de solicitud tiene esta propiedad modificada.
  • markupType: Ahora admite marca de hipervínculo.

Misiones

Entrada de actividad de misión del usuario
Este nuevo cuerpo de solicitud tiene estas propiedades.
  • activityCount: Número de actividades de misión del tipo especificado para el usuario.
  • activityType: Tipo de actividad de misión para un usuario. Los valores son:
    • FeedItemAnswerAQuestion: El usuario respondió a una pregunta.
    • FeedItemLikeSomething: El usuario le gustó una publicación o un comentario.
    • FeedItemMarkAnswerAsBest: El usuario marcó una respuesta como la mejor respuesta.
    • FeedItemPostQuestion: El usuario publicó una pregunta.
    • FeedItemReceiveAComment: El usuario recibió un comentario en una publicación.
    • FeedItemReceiveALike: El usuario recibió un Me gusta en una publicación o un comentario.
    • FeedItemReceiveAnAnswer: El usuario recibió una respuesta a una pregunta.
    • FeedItemWriteAComment: El usuario comentó una publicación.
    • FeedItemWriteAPost: El usuario realizó una publicación.
    • FeedItemYourAnswerMarkedBest: La respuesta del usuario se marcó como la mejor respuesta.

Next Best Actions (Disponible de forma general)

Entrada de estrategia de Next Best Action
Este cuerpo de solicitud tiene una nueva propiedad.
  • debugTrace: Especifica si devolver rastreo y depurar información en la respuesta (true) o no (false). Si no se especifica, el valor predeterminado es false.
Entrada de reacción de recomendación
Este cuerpo de solicitud se denominó anteriormente Entrada de reacción de Next Best Action.

Configuración de Implicación en redes sociales

Entrada de configuración del Servicio al cliente de redes sociales
Este cuerpo de solicitud tiene una nueva propiedad.
  • providerSettings: Lista de parámetros de Servicio al cliente de redes sociales relacionados con el comportamiento de redes sociales específicas.
Entrada de configuración de tipo de mensaje de servicio de cliente de redes sociales
Este nuevo cuerpo de solicitud tiene estas propiedades.
  • enable: Especifica si enviar el tipo de mensaje a Servicio al cliente de redes sociales (true) o no (false).
  • messageType: Especifica el tipo de mensaje, como PrivateMessage.
Entrada de configuración del proveedor de servicio de cliente de redes sociales
Este nuevo cuerpo de solicitud tiene estas propiedades.
  • messageTypeSettings: Lista de parámetros de Servicio al cliente de redes sociales relacionados con el comportamiento de tipos de mensaje específicos.
  • provider: Especifica el proveedor de redes sociales, como Facebook.

Cuerpos de respuesta nuevos y modificados de la API de REST de Chatter

A continuación se describen los cuerpos de respuesta nuevos o que incluyen cambios.

Noticias en tiempo real de Chatter

Segmento de mensaje: Inicio de marca
Este cuerpo de respuesta tiene estas propiedades nuevas y modificadas.
  • altText: Texto alternativo para el segmento, si disponible.
  • markupType: Ahora admite marca de hipervínculo.
  • url: URL para el segmento, si disponible.
Segmento de mensaje: Fin de marca
Este cuerpo de respuesta tiene esta propiedad modificada.
  • markupType: Ahora admite marca de hipervínculo.

Comunidades

Comunidad
Este cuerpo de respuesta tiene una nueva propiedad.
  • memberVisibilityEnabled: Especifica si los miembros de la comunidad puede ver otros miembros de la comunidad (true) o no (false).

Misiones

Trabajo de actividades de misión del usuario
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • jobToken: Token que identifica el trabajo de actividades del usuario de misión.
  • jobType: Tipo de trabajo de actividades del usuario, ya sea export o purge.
  • message—Mensaje describiendo el estado y resultado esperado del trabajo.
Actividad de misión del usuario
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • activityCount: Número de actividades de misión del tipo especificado para el usuario.
  • activityType: Tipo de actividad de misión para un usuario.
Conjunto de actividad de misión del usuario
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • community: Comunidad en la que el usuario llevó a cabo actividades.
  • userId: Id. del usuario.
  • userMissionActivities: Lista d actividades de misión realizadas por el usuario.
  • userName: Nombre del usuario.
Estado de actividad de misión del usuario
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • message: Mensaje de operación correcta o error.
  • status: Estado de actividad de misión para un usuario.

Next Best Actions (Disponible de forma general)

Recomendación nativa de Next Best Action
Esta respuesta de solicitud se denominó anteriormente Recomendación propuesta de Next Best Action.
Recomendación de Next Best Action
Estas propiedades se eliminaron de este cuerpo de respuesta.
  • actionReference
  • id
  • nombre
  • url
Recomendaciones de Next Best Action
Este cuerpo de respuesta tiene una nueva propiedad.
  • trace: Información de rastreo para la ejecución de la estrategia de recomendación, si se solicita.
Objeto de recomendación
Este cuerpo de respuesta se denominó anteriormente Propuesta
Reacción de recomendación
Esta respuesta de solicitud se denominó anteriormente Reacción de Next Best Action. Tiene una nueva propiedad.
  • url: URL a la reacción de recomendación.
Reacciones de recomendación
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • currentPageUrl: URL a la página actual de reacciones en el conjunto.
  • nextPageUrl: URL a la página siguiente de reacciones en el conjunto.
  • reactions: Conjunto de reacciones de recomendación.
Rastreo de estrategias
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • messages: Mensajes y errores de la ejecución de la estrategia.
  • nodes: Nodos de la ejecución de la estrategia utilizada para la depuración.
Nodo de rastreo de estrategias
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • inputCount: Número de elementos colocados en el nodo.
  • messages: Mensajes que se han producido durante la ejecución del nodo.
  • nodeName: Nombre del nodo.
  • nodeTime: Tiempo empleado procesando en el nodo.
  • nodeType: Tipo de nodo.
  • outputCount: Número de elementos devueltos del nodo.
  • outputs: Recomendaciones devueltas del nodo.
  • totalTime: Tiempo total empleado en el procesamiento.

Implicación en redes sociales

Intención de publicación de redes sociales de aprobación
Este nuevo cuerpo de respuesta tiene la propiedad que se describe a continuación.
  • isRecallable: Especifica si se puede recuperar la publicación de redes sociales (true) o no (false).
Intención de eliminación
Este nuevo cuerpo de respuesta tiene la propiedad que se describe a continuación.
  • managedSocialAccount: Cuenta de redes sociales gestionada que elimina la publicación de redes sociales.
Intenciones de publicación de redes sociales de eliminación
Este nuevo cuerpo de respuesta tiene la propiedad que se describe a continuación.
  • deletes: Lista de intenciones de eliminación para la publicación de redes sociales.
Intención de personas de redes sociales de seguimiento
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • managedSocialAccount: Cuenta de redes sociales gestionada que elimina la publicación de redes sociales.
  • socialPersonaId: Id. de la persona de redes sociales a seguir.
Intenciones de personas de redes sociales de seguimiento
Este nuevo cuerpo de respuesta tiene la propiedad que se describe a continuación.
  • follows: Lista de intenciones de seguimiento para la persona de redes sociales.
Intención de publicación de redes sociales de ocultación
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • isHidden: Especifica si la cuenta de redes sociales gestionada ocultó la publicación de redes sociales (true) o no (false).
  • managedSocialAccount: Cuenta de redes sociales gestionada que oculta la publicación en redes sociales.
Intención de Me gusta
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • isLiked: Especifica si la cuenta de redes sociales gestionada le gustó la publicación de redes sociales (true) o no (false).
  • managedSocialAccount: Cuenta de redes sociales gestionada a la que le gustó la publicación en redes sociales.
Intenciones de publicación de redes sociales de Me gusta
Este nuevo cuerpo de respuesta tiene la propiedad que se describe a continuación.
  • likes: Lista de intenciones de Me gusta para la publicación de redes sociales.
Intención de publicación de redes sociales de respuesta
Este nuevo cuerpo de respuesta tiene la propiedad que se describe a continuación.
  • managedSocialAccount: Cuenta de redes sociales gestionada que responde a la publicación en redes sociales.
Intenciones de publicación de redes sociales de respuesta
Este nuevo cuerpo de respuesta tiene la propiedad que se describe a continuación.
  • replies: Lista de intenciones de respuesta para la publicación de redes sociales.
Intenciones de publicaciones de redes sociales
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • approvalIntent: Intención de aprobación para la publicación de redes sociales.
  • deleteIntent: Intenciones de eliminación para la publicación de redes sociales.
  • followIntent: Intenciones de seguimiento de la persona de redes sociales.
  • hideIntent—Intención de ocultación para la publicación de redes sociales.
  • likeIntent—Intenciones de Me gusta para la publicación de redes sociales.
  • replyIntent—Intenciones de respuesta para la publicación de redes sociales.

Configuración de Implicación en redes sociales

Configuración del Servicio al cliente de redes sociales
Este cuerpo de solicitud tiene una nueva propiedad.
  • providerSettings: Lista de parámetros de Servicio al cliente de redes sociales relacionados con el comportamiento de redes sociales específicas.
Configuración de tipo de mensaje de servicio de cliente de redes sociales
Este nuevo cuerpo de solicitud tiene estas propiedades.
  • enable: Especifica si enviar el tipo de mensaje a Servicio al cliente de redes sociales (true) o no (false).
  • messageType: Especifica el tipo de mensaje, como PrivateMessage.
Configuración del proveedor de servicio de cliente de redes sociales
Este nuevo cuerpo de solicitud tiene estas propiedades.
  • messageTypeSettings: Lista de parámetros de Servicio al cliente de redes sociales relacionados con el comportamiento de tipos de mensaje específicos.
  • provider: Especifica el proveedor de redes sociales, como Facebook.

Usuarios

Conjunto de detalles de grupo de usuarios
Este nuevo cuerpo de respuesta tiene las propiedades que se indican a continuación.
  • currentPageUrl: URL a la página actual.
  • groups: Conjunto de grupos de los que le usuario es miembro.
  • nextPageUrl: URL a la siguiente página, o null si no hay ninguna página de texto.
  • previousPageUrl: URL a la página anterior, o null si no hay ninguna página previa.
  • total: Número total de grupos de los que le usuario es miembro.