{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":1070,"path":"api-reference/server-api-reference/c_NotifyAPI.md","title":"Notify - Global","bundle":null,"doc_type":null,"release":"australia","body":"\n# Notify- Global\n\nThe Notify API allows you to interact with Notify calls and SMS messages using scripts.\n\nAccess the global Notify class and its associated methods in the `SNC` namespace.\n\n**Parent Topic:**[Server API reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/api-server.md)\n\n## Notify - call\\(String notifyPhoneNumber, String toPhoneNumber, GlideRecord conferenceCall, GlideRecord conferenceCallRecord, String userSysId, String groupSysId, GlideRecord sourceRecord\\)\n\nCalls the specified E.164-compliant telephone number.\n\nIn addition, this method can automatically add the specified phone number to a specified conference call.\n\n\n
\n\nName\n\n\n\nType\n\n\n\nDescription\n\n
\n\nnotifyPhoneNumber\n\n\n\nString or NotifyPhoneNumber\n\n\n\nNotify phone number from which to make the call. When you initiate a call, the outgoing call workflow for the number group associated with this number runs. Ensure this workflow includes a **join conference call** activity to connect the user to the conference call.\n\n
\n\ntoPhoneNumber\n\n\n\nString\n\n\n\nPhone number to call. Called numbers are added to the conference call.\n\n
\n\nconferenceCall\n\n\n\nGlideRecord\n\n\n\nOptional. If this parameter is passed in, the callers identified in the **toPhoneNumber** parameter are automatically joined into the conference call identified by this record. GlideRecord for the Notify Call \\[notify\\_call\\] table that identifies the conference call record. This record is automatically added to the outgoing call workflow scratchpad as the workflow.scratchpad.conference\\_call variable.\n\n
\n\nuserSysId\n\n\n\nString\n\n\n\nOptional. Unique identifier \\(sys\\_id\\) of the user associated with the call.\n\n
\n\ngroupSysId\n\n\n\nString\n\n\n\nOptional. Unique identifier \\(sys\\_id\\) of the group associated with the call.\n\n
\n\nsourceRecord\n\n\n\nGlideRecord\n\n\n\nOptional. Source record that prompted this call.\n\n
|Type|Description|\n|----|-----------|\n|void| |\n\nThis example illustrates how to initiate a call to another phone number.\n\n```\nvar from = '+14048007337';\nvar to = '+31646810495';\n\n// set up call\nnew SNC.Notify().call(from, to);\n```\n\nThis example illustrates how to initiate a call to list of telephone numbers and automatically join those numbers into a new conference call.\n\n```\nvar notify = new SNC.Notify();\nvar from = '+14041234567';\nvar participants = ['+31612345678', '+31623456789', '+31687654321'];\n\n// set up a conference call\nvar conferenceCall = notify.conferenceCall();\n\n// set up the outbound calls for all conference call participants\nfor (var i in participants) {\n var to = participants[i];\n notify.call(from, to, conferenceCall);\n}\n```\n\nThis example illustrates how to initiate a new conference call.\n\n```\nSNC.Notify.call('+15413970605', '+91406XXXXXXX', SNC.Notify.conferenceCall(), null, null, null);\n```\n\nThis example illustrates how to initiate new a conference call using a user record.\n\n```\nvar sysUserGr = new GlideRecord('sys_user');\nsysUserGr.get('active conference sys id');\n \nif (conferenceGr.isValid) {\n SNC.Notify.call('+15413970605', '+91406XXXXXXX', SNC.Notify.conferenceCall(), sysUserGr.getUniqueValue(), null, null);\n}\n```\n\nThis example illustrates how to initiate a new conference call with a user, group, and source record.\n\n```\nvar sysUserGr = new GlideRecord('sys_user');\nsysUserGr.get('active sys user sys id');\n \nvar sysUserGroupGr = new GlideRecord('sys_user_group');\nsysUserGroupGr.get('active sys user group sys id');\n \nvar incidentGr = new GlideRecord('incident');\nincidentGr.get('incident sys_id');\n \nif (conferenceGr.isValid) {\n SNC.Notify.call('+15413970605', '+91406XXXXXXX',\n SNC.Notify.conferenceCall(),\n sysUserGr.getUniqueValue(),\n sysUserGroupGr.getUniqueValue(),\n incidentGr.getUniqueValue());\n}\n```\n\n### Scoped equivalent\n\nTo use the call\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - call\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - conferenceCall\\(GlideRecord sourceRecord\\)\n\nCreates a new conference call GlideRecord.\n\n|Name|Type|Description|\n|----|----|-----------|\n|sourceRecord|GlideRecord|Optional. Record that initiated the request to create the conference call. Used to populate the source and table fields on notify\\_conference\\_call record.|\n\n|Type|Description|\n|----|-----------|\n|GlideRecord|New Notify conference call \\[notify\\_conference\\_call\\] record.|\n\n```\nvar notify = new SNC.Notify();\nvar from = '+14041234567';\nvar participants = ['+31612345678', '+31623456789', '+31687654321'];\n\n// set up a conference call\nvar conferenceCall = notify.conferenceCall();\n\n// set up the outbound calls for all conference call participants\nfor (var i in participants) {\n var to = participants[i];\n notify.call(from, to, conferenceCall);\n}\n```\n\n### Scoped equivalent\n\nTo use the conferenceCall\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - conferenceCall\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n**Related topics** \n\n\n[Notify - call\\(String notifyPhoneNumber, String toPhoneNumber, GlideRecord conferenceCall, GlideRecord conferenceCallRecord, String userSysId, String groupSysId, GlideRecord sourceRecord\\)]()\n\n## Notify - dequeueCall\\(GlideRecord callRecord\\)\n\nResumes a call after it was put in a queue \\(on hold\\).\n\nUse this method to resume calls that were put in a queue with the queueCall\\(\\) method.\n\n|Name|Type|Description|\n|----|----|-----------|\n|callRecord|GlideRecord|A GlideRecord object on the Notify Call \\[notify\\_call\\] table with the held call you want to resume.|\n\n|Type|Description|\n|----|-----------|\n|void| |\n\nThe following example shows how to reactivate a call that was put on hold.\n\n```\nvar notifyCallGr = new GlideRecord('notify_call');\nnotifyCallGr.get('active participant sys id');\n \nif (notifyCallGr.isValid) {\n SNC.Notify.dequeueCall(notifyCallGr);\n}\n```\n\n### Scoped equivalent\n\nTo use the dequeueCall\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - dequeueCall\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - forwardCall\\(GlideRecord call, String destination, String dtmf\\)\n\nForwards the specified call to a different call recipient.\n\n|Name|Type|Description|\n|----|----|-----------|\n|call|GlideRecord or String|Notify call record or the telephony provider call ID, of the call to be forwarded.|\n|destination|GlideRecord or String|Notify phone number record or an E.164-compliant phone number, of the caller to which to forward the call.|\n|dtmf|String|Dual Tone - Multi Frequency \\(DTMF\\) code to send upon call connection.|\n\n|Type|Description|\n|----|-----------|\n|void| |\n\nThe following example shows how to forward a call to another phone number.\n\n```\nvar callID = 'CA92374b5aa561dab476a7001db6026edc'; // Twilio Call ID\nvar phoneNumber = '+91406xxxxxxx';\nvar dtmfTones = null;\n \nvar notifyCallGr = new GlideRecord('notify_call');\nnotifyCallGr.get('active participant sys id');\n \nif (notifyCallGr.isValid) {\n SNC.Notify.forwardCall(notifyCallGr(or) callID, phoneNumber, dtmfTones)\n}\n```\n\n### Scoped equivalent\n\nTo use the forwardCall\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - forwardCall\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - getAvailableClients\\(String notifyNumber\\)\n\nReturns a list of client sessions that are available to receive calls.\n\n|Name|Type|Description|\n|----|----|-----------|\n|notifyNumber|String|Valid Notify phone number.|\n\n\n
\n\nType\n\n\n\nDescription\n\n
\n\nGlideRecord\n\n\n\nGlideRecord from the notify\\_client\\_session table for the specified phone number. Returns \"0\" if there are no available client sessions.\n\n
The following example shows how to use the getAvailableClients\\(\\) method to index into the notify\\_client\\_session table and then iterate across all available Notify clients.\n\n```\nvar clientSessionGr = SNC.Notify.getAvailableClients('+185xxxxxxxx'); \n// Here clientSessionGr is of type GlideRecord on 'notify_client_session' table.\n \nvar isLoggedInUserAvailable = false;\nwhile (clientSessionGr.next()) {\n if (clientSessionGr.user == gs.getUserID())\n isLoggedInUserAvailable = clientSessionGr.available;\n}\ngs.info('isLoggedInUserAvailable - ' + isLoggedInUserAvailable);\n```\n\n### Scoped equivalent\n\nTo use the getAvailableClients\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - getAvailableClients\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - getParentCallID\\(GlideRecord callRecord\\)\n\nReturns the sys\\_id of a specified call's parent call.\n\nAny call started by forwarding another call, such as with the Forward workflow activity, is considered a child of the original call. The original call is the parent call.\n\n|Name|Type|Description|\n|----|----|-----------|\n|callRecord|GlideRecord|Record on the Notify Call \\[notify\\_call\\] table for which to return the call status.|\n\n|Type|Description|\n|----|-----------|\n|String|Unique sys\\_id of the parent call record.|\n\nThis example shows how to obtain the parent call of the specified call.\n\n```\nvar callRecord = new GlideRecord('notify_call');\ncallRecord.get(\"0f4f5863ff13310014ecffffffffff28\");\n\nvar notify = new SNC.Notify();\nvar parentCallID = notify.getParentCallID(callRecord);\n```\n\n## Notify - getPhoneNumbers\\(\\)\n\nReturns all phone numbers and short codes available to Notify.\n\n|Name|Type|Description|\n|----|----|-----------|\n|None| | |\n\n|Type|Description|\n|----|-----------|\n|List|List of NotifyPhoneNumber objects, each object representing one phone number available to Notify.|\n\n```\nvar list = SNC.Notify.getPhoneNumbers();\nfor (var i = 0; i < list.size(); i++) {\n var num = list.get(i);\n gs.info(num.getNumber())\n}\n```\n\n### Scoped equivalent\n\nTo use the getPhoneNumbers\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - getPhoneNumbers\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - getTokens\\(GlideRecord, record\\)\n\nReturns client tokens for any active telephony drivers for use in WebRTC or mobile clients.\n\n|Name|Type|Description|\n|----|----|-----------|\n|record|GlideRecord|GlideRecord to use to identify the Notify client, such as a group record or a user record.|\n\n|Type|Description|\n|----|-----------|\n|String|Web RTC tokens for the supported drivers, as a JSON string with the following format: \\{driverName1: \"token1\", driverName2: \"token2\"\\}, such as \"TwilioDirect\":\"eyJhxxxx.eyJleHAiOiIxxxx.7fejxxx\\_mbLxxx\"|\n\nThis example shows how to obtain the client tokens for the currently logged in user.\n\n```\n// get Notify client Tokens per active Notify driver for the currently logged in user\nvar json = new SNC.Notify().getTokens();\n \n// Parse the JSON that was return into a tokens object\nvar tokens = JSON.parse(json);\n\n// Log line\ngs.log('Notify client tokens for the currently logged in user');\n\n // iterate over the driver tokens\nfor (var driver in tokens) {\n \tgs.log(driver + ' Driver token: ' + tokens[driver]);\n}\n```\n\nThis example shows how to obtain the client tokens for every Notify group.\n\n```\n// instantiate Notify\nvar notify = new SNC.Notify();\n \n// get all Notify Groups\nvar notifyGroup = new GlideRecord(\"notify_group\");\nnotifyGroup.query();\n \n// iterate over all notify groups\nwhile (notifyGroup.next()) {\n // generate Notify Client tokens per active Notify Driver for this group\n var json = notify.getTokens(notifyGroup);\n var tokens = JSON.parse(json);\n \n for (var driver in tokens) {\n gs.log(gs.getMessage(\"Notify Client token for {0} driver and Notify Group '{1}': {2}\", [driver, notifyGroup.getValue('name'), tokens[driver]]));\n }\n}\n```\n\n### Scoped equivalent\n\nTo use the getTokens\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - getTokens\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - getTokenTTL\\(String owner\\)\n\nReturns the maximum amount of time that a client session stays active for a specified telephony driver before automatically timing out.\n\n\n
\n\nName\n\n\n\nType\n\n\n\nDescription\n\n
\n\nowner\n\n\n\nString\n\n\n\nName of the telephony driver for which to retrieve the session length. Valid values:\n\n - Twilio: for the old driver\n- TwilioDirect: for the new driver\n\n
|Type|Description|\n|----|-----------|\n|Integer|Maximum length of the session \\(in seconds\\). Default: 1800 seconds|\n\nThe following example shows how to properly call this method and the associated response. It also shows what is returned if an invalid driver is passed.\n\n```\nvar owner = \"TwilioDirect\"; // Valid driver\nvar ttl = SNC.Notify.getTokenTTL(owner);\ngs.info(\"Token TTL for \" + owner + \" --> \" + ttl);\n \nowner = \"Abcxyz\"; // Invalid driver\nttl = SNC.Notify.getTokenTTL(owner);\n// For an invalid driver, we throw NoSuchNotifyDriverException saying that Abcxyzdriver is not available\n// and return the default value of TTL\ngs.info(\"Token TTL for \" + owner + \" --> \" + ttl); \n```\n\n### Scoped equivalent\n\nTo use the getTokenTTL\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - getAvailableClients\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - hasCapability\\(String notifyPhoneNumber, String capability\\)\n\nDetermines whether the specified phone number has the specified capability.\n\nThe telephony driver associated with the phone number contains a list of all of the capabilities of the phone.\n\n**Note:** In the base system, the Notify JS driver only has 'show\\_speakers' as a capability; this can be modified.\n\n|Name|Type|Description|\n|----|----|-----------|\n|notifyPhoneNumber|String|Phone number for which to check for the specified capability.|\n|capability|String|Capability to detect. The string text must be an exact match to what is in the phone.|\n\n\n
\n\nType\n\n\n\nDescription\n\n
\n\nBoolean\n\n\n\nFlag that indicates whether the specified phone has the specified capability.- true: phone has the capability\n- false: phone does not have the capability\n\n
This example shows how to check if a phone has a specific capability.\n\n```\n// Each driver has a defined set of capabilities.\n\nvar capability = 'show_speakers';\ngs.info(SNC.Notify.hasCapability('+185xxxxxxxx', capability)); // true\n \ncapability = 'send_sms';\ngs.info(SNC.Notify.hasCapability('+185xxxxxxxx', capability)); // false\n```\n\n### Scoped equivalent\n\nTo use the hasCapability\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - hasCapability\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - kick\\(GlideRecord participant\\)\n\nRemoves the specified caller from the current Notify conference call.\n\n|Name|Type|Description|\n|----|----|-----------|\n|participant|GlideRecord|GlideRecord object containing the Notify Participant \\[notify\\_participant\\] record of the caller to remove from the conference call.|\n\n|Type|Description|\n|----|-----------|\n|void| |\n\nThe following example shows how to remove a participant from a conference call.\n\n```\nvar notifyParticipantGr = new GlideRecord('notify_participant');\nnotifyParticipantGr.get('active participant sys id');\n \nif (notifyParticipantGr.isValid) {\n SNC.Notify.kick(notifyParticipantGr);\n}\n```\n\n### Scoped equivalent\n\nTo use the kick\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - kick\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - modifyCall\\(GlideRecord callRecord, NotifyAction notifyAction\\)\n\nPerforms one or more actions on an active Notify phone call.\n\nAvailable actions that you can perform on calls include queuing or dequeueing the call, reading text, playing audio, or forwarding the call. You can also create custom actions Call the modifyCall\\(\\) method after you have specified all the actions that you want to apply to the specified call. Refer to the [NotifyAction](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/c_NotifyActionApi.md) API documentation for more information about available actions.\n\n|Name|Type|Description|\n|----|----|-----------|\n|callRecord|GlideRecord|Notify Call \\[notify\\_call\\] record of the call for which to apply the actions.|\n|notifyAction|NotifyAction|NotifyAction object describing one or more actions to perform on the call. Create this object by calling one or more of the NotifyAction\\(\\) methods.|\n\n|Type|Description|\n|----|-----------|\n|void| |\n\nThis example shows how to modify a call.\n\n```\n// get the most recent call record\nvar callRecord = new GlideRecord('notify_call');\ncallRecord.orderByDesc('sys_created_on');\ncallRecord.query();\n \nif (callRecord.next()) {\n // instantiate notify action container class\n var notifyAction = new SNC.NotifyAction();\n // The call is already in progress. Now, we want to modify the call behavior by putting this call in a queue.\n // So, we add a queue action to queue the call\n notifyAction.addQueue('my fancy queue');\n \n // modify the call by passing in the above action, putting the call in a queue\n new SNC.Notify().modifyCall(callRecord, notifyAction);\n} else {\n gs.log('no such call record');\n}\n```\n\n### Scoped equivalent\n\nTo use the modifyCall\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - modifyCall\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - mute\\(GlideRecord participantRecord\\)\n\nMutes the specified conference call participant.\n\n|Name|Type|Description|\n|----|----|-----------|\n|participantRecord|GlideRecord|GlideRecord from the notify\\_participant table for the participant to mute.|\n\n|Type|Description|\n|----|-----------|\n|void| |\n\nThe following example shows how to mute a caller.\n\n```\nvar notifyParticipantGr = new GlideRecord('notify_participant');\nnotifyParticipantGr.get('active participant sys id');\n \nif (notifyParticipantGr.isValid) {\n SNC.Notify.mute(notifyParticipantGr);\n}\n```\n\n### Scoped equivalent\n\nTo use the mute\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - mute\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - queueCall\\(GlideRecord callRecord\\)\n\nPuts the specified call into a queue \\(on hold\\).\n\nResume a queued call using the dequeueCall\\(\\) method.\n\n|Name|Type|Description|\n|----|----|-----------|\n|callRecord|GlideRecord|GlideRecord object of the Notify Call record \\(notify\\_call table\\) to put on hold.|\n\n|Type|Description|\n|----|-----------|\n|void| |\n\nThe following example shows how to put a call on hold \\(in the queue\\).\n\n```\nvar notifyCallGr = new GlideRecord('notify_call');\nnotifyCallGr.get('active participant sys id');\n \nif (notifyCallGr.isValid) {\n SNC.Notify.queueCall(notifyCallGr);\n}\n```\n\n### Scoped equivalent\n\nTo use the queueCall\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - queueCall\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - sendBulkSMS\\(String notifyPhoneNumber, Array toPhoneNumbers, String messageBody, GlideRecord source\\)\n\nSends a specified SMS message to the specified list of Notify clients \\(phone numbers\\).\n\n\n
\n\nName\n\n\n\nType\n\n\n\nDescription\n\n
\n\nnotifyPhoneNumber\n\n\n\nString\n\n\n\nNotify phone number from which the SMS message is being sent.\n\n
\n\ntoPhoneNumbers\n\n\n\nArray of Strings\n\n\n\nComma-separated list of phone numbers to which to send the SMS message.Format: E.164\n\n
\n\nmessageBody\n\n\n\nString\n\n\n\nSMS text to send.\n\n
\n\nsource\n\n\n\nGlideRecord\n\n\n\nSource record that prompted this SMS message, such as an incident.\n\n
|Type|Description|\n|----|-----------|\n|String|Null|\n\nThe following example shows how to send a bulk SMS message.\n\n```\nvar incidentGr = new GlideRecord('incident');\nincidentGr.get(active incident sys_id');\nif (incidentGr.isValid()) {\n SNC.Notify.sendBulkSMS('+15413970605', ['+919885XXXXXX', '+919775XXXXXX'], 'Test automation message', incidentGr);\n}\n```\n\n### Scoped equivalent\n\nTo use the sendBulkSMS\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - sendBulkSMS\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - sendSMS\\(String notifyPhoneNumber, String toPhoneNumber, String messageBody, GlideRecord source\\)\n\nSends an SMS text message to an E.164-compliant phone number.\n\nThis method creates a new record on the Notify Message \\[notify\\_message\\] table and associates it with the source record.\n\n|Name|Type|Description|\n|----|----|-----------|\n|notifyPhoneNumber|String|Notify phone number from which the SMS message is being sent.|\n|toPhoneNumber|String|E.164-compliant phone number to which to send the SMS message.|\n|messageBody|String|Body of the SMS text message.|\n|source|GlideRecord|Source record that prompted this SMS message, such as an incident.|\n\n|Type|Description|\n|----|-----------|\n|String|Unique message SID; stored in the Notify Message \\[notify\\_message\\] record as message\\_id.|\n\nThe following example shows how to send an SMS message.\n\n```\nvar incidentGr = new GlideRecord('incident');\nincidentGr.get('active incident sys_id');\nif (incidentGr.isValid()) {\n SNC.Notify.sendSMS('+15413970605', '+919885XXXXXX', 'Test automation message', incidentGr);\n}\n```\n\n### Scoped equivalent\n\nTo use the sendSMS\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - sendSMS\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n## Notify - unmute\\(GlideRecord participantRecord\\)\n\nUnmutes the specified conference call participant.\n\n|Name|Type|Description|\n|----|----|-----------|\n|participantRecord|GlideRecord|GlideRecord from the notify\\_participant table for the participant to unmute.|\n\n|Type|Description|\n|----|-----------|\n|void| |\n\nThe following example shows how to unmute a caller.\n\n```\nvar notifyParticipantGr = new GlideRecord('notify_participant');\nnotifyParticipantGr.get('active participant sys id');\n \nif (notifyParticipantGr.isValid) {\n SNC.Notify.unmute(notifyParticipantGr);\n}\n```\n\n### Scoped equivalent\n\nTo use the unmute\\(\\) method in a scoped application, use the corresponding scoped method: [NotifyScoped - unmute\\(\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/server-api-reference/notifyScopedAPI.md).\n\n"}}