---
sourceDocument: Yokohama Conversational Interfaces
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Validate recipient IDs for agent-initiated messages

# Validate recipient IDs for agent-initiated messages {#ariaid-title1}

Release version: Yokohama  
Updated January 30, 2025  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Use scripted extension points to call custom scripts for validating the format of a
recipient ID associated with a messaging channel.

## Before you begin

Install the Agent-Initiated Messaging Interface application. For more information, see [Install agent-initiated messaging interface](https://servicenow-prod.fluidtopics.net/ydzLG30ewrvhgceB1AiXSQ "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

## About this task

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.

## Procedure

1. Navigate to AllSystem Extension PointsScripted Extension Points.
2. In the API Name column, search for and select global.ChannelSendToValidation.
3. On the Extension Point form, either modify a script include to use the global.ChannelSendToValidation 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.  
     Note:  
     The PhoneNumberValidationExtPointImpl script include that use the global.ChannelSendToValidation extension point is available for validating recipient IDs profiles associated with the Conversational SMS service channel application.
   {#agent-init-messg-validate-recipient__choices_mxh_ght_plb}
4. Associate user profiles for an agent-initiated messages by adding the global.ChannelSendToValidation 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-validate-recipient__table_czh_m5m_5nb__entry__2}

   | Customization | Implementation |
   |-|-|
   | Associate a channel ID for which the message was initiated | Include the isValid method in the global.ChannelSendToValidation extension point. |
   | Retrieve the recipient ID associated with the channel for which the message was initiated | Include the channelSendToValidation method in the sn_agent_initiated.AgentInitiatedMessagingUserDocument extension point. |
   [ ]

   {#agent-init-messg-validate-recipient__table_czh_m5m_5nb}  
   Note:  
   Based on the channel ID set in the isValid method, the recipient details are retrieved for validating a recipient ID in the channelSendToValidation method.
5. On the Extension Point form, click Update.

*[\>]: and then