---
sourceDocument: Australia Conversational Interfaces
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/conversational-interfaces

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Associate user profiles

# Associate user profiles with agent-initiated messages {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

Use scripted extension points to call custom scripts for associating user profiles
with agent-initiated messages.

## Antes de Iniciar

Install the Agent-Initiated Messaging Interface application. For more information, see [Install agent-initiated messaging interface](https://servicenow-prod.fluidtopics.net/8Ratr3oAHHVGW4saFurW9g "You can install the Agent-Initiated Messaging Interface application (sn_agent_initiated) if you have the admin role. The application installs related ServiceNow Store applications and plugins if they are not already installed.").

Role required: admin

## Por Que e Quando Desempenhar Esta Tarefa

An agent can compose messages from an interaction of type other than Message in the CSM Configurable Workspace. By default, the AgentMessagingInteractionUserDocument script include is available for retrieving user profiles associated with consumers and customer contacts in an interaction record.

By using extension points, you can easily integrate customizations
without having to alter the base code. You can extend standard base functionality
using customized scripts. For more information, see [Using extension points to
extend application functionality](https://www.servicenow.com/docs/access?context=extension-points&version=australia&pubname=australia-api-reference&ft:locale=en-US).

## Procedimento

1. Navigate to AllSystem Extension PointsScripted Extension Points.
2. In the API Name column, search for and select sn_agent_initiated.AgentInitiatedMessagingUserDocument.
3. On the Extension Point form, either modify a script include to use the sn_agent_initiated.AgentInitiatedMessagingUserDocument extension point or create and register a custom script include.
   * Create and register a custom script include.
   * Modify the existing script include by going to the Implementations related list and selecting a script include in the Class column.  
     Nota:  
     By default, the AgentMessagingInteractionUserDocument script include that use the sn_agent_initiated.AgentInitiatedMessagingUserDocument extension point is available for the Agent-Initiated Messaging Interface application. This script include is configured to retrieve user profiles associated with consumers and customer contacts from the Interaction \[interaction\] table record.
   {#agent-init-messg-user-record-ext-pt__choices_mxh_ght_plb}
4. Associate user profiles for an agent-initiated messages by adding the sn_agent_initiated.AgentInitiatedMessagingUserDocument extension point to the script include.  
   You can create multiple implementations for an extension point and provide an order number for each implementation. The implementation that has the lowest order number is executed first.{#agent-init-messg-user-record-ext-pt__table_czh_m5m_5nb__entry__2}

   | Customization | Implementation |
   |-|-|
   | Associate a table record from which the message was initiated | Include the isValidForTableRecord method in the sn_agent_initiated.AgentInitiatedMessagingUserDocument extension point. |
   | Retrieve the user details associated with the table record from which the message was initiated | Include the getUserDocument method in the sn_agent_initiated.AgentInitiatedMessagingUserDocument extension point. |
   [ ]

   {#agent-init-messg-user-record-ext-pt__table_czh_m5m_5nb}  
   Nota:  
   Based on the table record set in the isValidForTableRecord method, the user details are retrieved for sending agent-initiated messages in the getUserDocument method.
5. On the Extension Point form, click Update.