---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Notify - Global

# Notify - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 14 min. de leitura

A API Notify permite que você interaja com chamadas e mensagens SMS do Notify usando scripts.

Acesse a classe Notify global e seus métodos associados no namespace `SNC`.

## Notify - call(cadeia de caracteres notifyPhoneNumber, cadeia de caracteres toPhoneNumber, GlideRecord conferenceCall, GlideRecord conferenceCallRecord, cadeia de caracteres userSysId, cadeia de caracteres groupSysId, GlideRecord sourceRecord) {#ariaid-title2}

Liga para o número de telefone compatível com E.164 especificado.
Além disso, este método pode adicionar automaticamente o número de telefone especificado a uma chamada em conferência especificada.
{#r_N-call_NotifyPhoneNumber_S_GR__table_abs_4hn_wr__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| notifyPhoneNumber | Cadeia de caracteres ou NotifyPhoneNumber | Número de telefone do Notify a partir do qual a chamada será feita. Quando você inicia uma chamada, o fluxo de trabalho de chamada de saída para o grupo de números associado a este número é executado. Certifique-se de que este fluxo de trabalho inclua uma atividade Ingressar na chamada em conferência para conectar o usuário à chamada em conferência. |
| paraNúmeroDeTelefone | Cadeia de caracteres | Número de telefone para ligar. Os números chamados são adicionados à chamada em conferência. |
| ConferenceCall | GlideRecord | Opcional. Se este parâmetro for passado, os solicitantes identificados no parâmetro toPhoneNumber ingressarão automaticamente na chamada em conferência identificada por este registro. GlideRecord para a tabela Chamada do Notify \[notify_call\] que identifica o registro da chamada em conferência. Este registro é adicionado automaticamente ao bloco de anotações do fluxo de trabalho de chamada de saída como a variável workflow.scratchpad.conference_call. |
| userSysId | Cadeia de caracteres | Opcional. Identificador exclusivo (sys_id) do usuário associado à chamada. |
| groupSysId | Cadeia de caracteres | Opcional. Identificador exclusivo (sys_id) do grupo associado à chamada. |
| sourceRecord | GlideRecord | Opcional. Registro de origem que solicitou esta chamada. |
[Tabela 1. Parâmetros]

{#r_N-call_NotifyPhoneNumber_S_GR__table_abs_4hn_wr} {#r_N-call_NotifyPhoneNumber_S_GR__table_bbs_4hn_wr__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 2. Retorna]

{#r_N-call_NotifyPhoneNumber_S_GR__table_bbs_4hn_wr}  
Este exemplo ilustra como iniciar uma chamada para outro número de telefone.

    var from = '+14048007337';
    var to = '+31646810495';

    // set up call
    new SNC.Notify().call(from, to);

Este exemplo ilustra como iniciar uma chamada para uma lista de números de telefone e ingressar automaticamente esses números em uma nova chamada em conferência.

    var notify = new SNC.Notify();
    var from = '+14041234567';
    var participants = ['+31612345678', '+31623456789', '+31687654321'];

    // set up a conference call
    var conferenceCall = notify.conferenceCall();

    // set up the outbound calls for all conference call participants
    for (var i in participants) {
        var to = participants[i];
        notify.call(from, to, conferenceCall);
    }

Este exemplo ilustra como iniciar uma nova chamada em conferência.

    SNC.Notify.call('+15413970605', '+91406XXXXXXX', SNC.Notify.conferenceCall(), null, null, null);

Este exemplo ilustra como iniciar uma nova chamada em conferência usando um registro de usuário.

    var sysUserGr = new GlideRecord('sys_user');
    sysUserGr.get('active conference sys id');
     
    if (conferenceGr.isValid) {
        SNC.Notify.call('+15413970605', '+91406XXXXXXX', SNC.Notify.conferenceCall(), sysUserGr.getUniqueValue(), null, null);
    }

Este exemplo ilustra como iniciar uma nova chamada em conferência com um usuário, grupo e registro de origem.

    var sysUserGr = new GlideRecord('sys_user');
    sysUserGr.get('active sys user sys id');
     
    var sysUserGroupGr = new GlideRecord('sys_user_group');
    sysUserGroupGr.get('active sys user group sys id');
     
    var incidentGr = new GlideRecord('incident');
    incidentGr.get('incident sys_id');
     
    if (conferenceGr.isValid) {
        SNC.Notify.call('+15413970605', '+91406XXXXXXX',
            SNC.Notify.conferenceCall(),
            sysUserGr.getUniqueValue(),
            sysUserGroupGr.getUniqueValue(),
            incidentGr.getUniqueValue());
    }

### Equivalente com escopo

Para usar o método call() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - call()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-call_S_S_GR_GR_S_S_GR "Liga para o número de telefone compatível com E.164 especificado.").

## Notify - conferenceCall(GlideRecord sourceRecord) {#ariaid-title3}

Cria uma nova chamada em conferência GlideRecord.
{#r_N-conferenceCall__table_ysr_5mk_js__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sourceRecord | GlideRecord | Opcional. Registro que iniciou a solicitação para criar a chamada em conferência. Usado para preencher os campos de origem e de tabela no registro notify_conference_call. |
[Tabela 3. Parâmetros]

{#r_N-conferenceCall__table_ysr_5mk_js} {#r_N-conferenceCall__table_zsr_5mk_js__entry__2}

| Tipo | Descrição |
|-|-|
| GlideRecord | Novo registro de chamada em conferência do Notify \[notify_conference_call\]. |
[Tabela 4. Retorna]

{#r_N-conferenceCall__table_zsr_5mk_js}  

    var notify = new SNC.Notify();
    var from = '+14041234567';
    var participants = ['+31612345678', '+31623456789', '+31687654321'];

    // set up a conference call
    var conferenceCall = notify.conferenceCall();

    // set up the outbound calls for all conference call participants
    for (var i in participants) {
        var to = participants[i];
        notify.call(from, to, conferenceCall);
    }

### Equivalente com escopo {#r_N-conferenceCall__section_wzp_1dd_1gb}

Para usar o método conferenceCall() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - conferenceCall()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-conferenceCall "Cria uma nova chamada em conferência GlideRecord.").
**Referência relacionada**   

* [Notify - call(cadeia de caracteres notifyPhoneNumber, cadeia de caracteres toPhoneNumber, GlideRecord conferenceCall, GlideRecord conferenceCallRecord, cadeia de caracteres userSysId, cadeia de caracteres groupSysId, GlideRecord sourceRecord)](https://servicenow-prod.fluidtopics.net/8mx51v1_1I4AKGEoEBgUWg#r_N-call_NotifyPhoneNumber_S_GR "Liga para o número de telefone compatível com E.164 especificado.")

## Notify - dequeueCall(GlideRecord callRecord) {#ariaid-title4}

Retoma uma chamada depois que ela é colocada em uma fila (em espera).
Use este método para retomar chamadas que foram colocadas em uma fila com o método queueCall().
{#r_N-dequeueCall_GlideRecord__table_sf5_ddy_js__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| registro de chamada | GlideRecord | Um objeto GlideRecord na tabela Chamada do Notify \[notify_call\] com a chamada em espera que você deseja retomar. |
[Tabela 5. Parâmetros]

{#r_N-dequeueCall_GlideRecord__table_sf5_ddy_js} {#r_N-dequeueCall_GlideRecord__table_tf5_ddy_js__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 6. Retorna]

{#r_N-dequeueCall_GlideRecord__table_tf5_ddy_js}  
O exemplo a seguir mostra como reativar uma chamada que foi colocada em espera.

    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.dequeueCall(notifyCallGr);
    }

### Equivalente com escopo {#r_N-dequeueCall_GlideRecord__section_dws_mnd_1gb}

Para usar o método dequeueCall() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - dequeueCall()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-dequeueCall_GR "Retoma uma chamada depois que ela é colocada em uma fila (em espera).").

## Notify - encaminharCall(chamada GlideRecord, destino da cadeia de caracteres, dtmf da cadeia de caracteres) {#ariaid-title5}

Encaminha a chamada especificada para um destinatário de chamada diferente.
{#r_N-forwardCall_GR_S_S__table_byv_vml_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| chamada | GlideRecord ou String | Notifique o registro de chamadas ou o ID de chamada do provedor de telefonia da chamada a ser encaminhada. |
| destination | GlideRecord ou String | Notifique o registro de número de telefone ou um número de telefone compatível com E.164 do solicitante para o qual a chamada será encaminhada. |
| dtmf | Cadeia de caracteres | Código de tom duplo - Multifrequência (DTMF) a ser enviado na conexão de chamada. |
[Tabela 7. Parâmetros]

{#r_N-forwardCall_GR_S_S__table_byv_vml_ts} {#r_N-forwardCall_GR_S_S__table_cyv_vml_ts__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 8. Retorna]

{#r_N-forwardCall_GR_S_S__table_cyv_vml_ts}  
O exemplo a seguir mostra como encaminhar uma chamada para outro número de telefone.

    var callID = 'CA92374b5aa561dab476a7001db6026edc'; // Twilio Call ID
    var phoneNumber = '+91406xxxxxxx';
    var dtmfTones = null;
     
    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.forwardCall(notifyCallGr(or) callID, phoneNumber, dtmfTones)
    }

### Equivalente com escopo

Para usar o métodoforwardCall() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped -forwardCall()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-forwardCall_GR_S_S "Encaminha a chamada especificada para um destinatário de chamada diferente.").

## Notify - getAvailableClients(cadeia de caracteres notifyNumber) {#ariaid-title6}

Retorna uma lista de sessões de cliente que estão disponíveis para receber chamadas.
{#r_N-getAvailableClients_String__table_ibs_r1n_ms__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| notifyNumber | Cadeia de caracteres | Número de telefone do Notify válido. |
[Tabela 9. Parâmetros]

{#r_N-getAvailableClients_String__table_ibs_r1n_ms} {#r_N-getAvailableClients_String__table_jbs_r1n_ms__entry__2}

| Tipo | Descrição |
|-|-|
| GlideRecord | GlideRecord da tabela notify_client_session para o número de telefone especificado. Retorna "0" se não houver sessões de cliente disponíveis. |
[Tabela 10. Retorna]

{#r_N-getAvailableClients_String__table_jbs_r1n_ms}  
O exemplo a seguir mostra como usar o método getAvailableClients() para indexar na tabela notify_client_session e iterar em todos os clientes Notify disponíveis.

    var clientSessionGr = SNC.Notify.getAvailableClients('+185xxxxxxxx'); 
    // Here clientSessionGr is of type GlideRecord on 'notify_client_session' table.
     
    var isLoggedInUserAvailable = false;
    while (clientSessionGr.next()) {
      if (clientSessionGr.user == gs.getUserID())
        isLoggedInUserAvailable = clientSessionGr.available;
    }
    gs.info('isLoggedInUserAvailable - ' + isLoggedInUserAvailable);

### Equivalente com escopo {#r_N-getAvailableClients_String__section_bgp_tk2_1gb}

Para usar o método getAvailableClients() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - getAvailableClients()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-getAvailableClients_S "Retorna uma lista de sessões de cliente que estão disponíveis para receber chamadas.").

## Notify - getParentCallID(GlideRecord callRecord) {#ariaid-title7}

Retorna o sys_id da chamada primária de uma chamada especificada.
Qualquer chamada iniciada pelo encaminhamento de outra chamada, como com a atividade de fluxo de trabalho Encaminhar, é considerada secundária da chamada original. A chamada original é a chamada primária.
{#r_N-getParentCallID_GR__table_sqs_jxn_wr__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| registro de chamada | GlideRecord | Registro na tabela Chamada do Notify \[notify_call\] para a qual o status da chamada será retornado. |
[Tabela 11. Parâmetros]

{#r_N-getParentCallID_GR__table_sqs_jxn_wr} {#r_N-getParentCallID_GR__table_tqs_jxn_wr__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | sys_id exclusivo do registro de chamada primário. |
[Tabela 12. Retorna]

{#r_N-getParentCallID_GR__table_tqs_jxn_wr}  
Este exemplo mostra como obter a chamada primária da chamada especificada.

    var callRecord = new GlideRecord('notify_call');
    callRecord.get("0f4f5863ff13310014ecffffffffff28");

    var notify = new SNC.Notify();
    var parentCallID = notify.getParentCallID(callRecord);

## Notify - getPhoneNumbers() {#ariaid-title8}

Retorna todos os números de telefone e códigos curtos disponíveis para o Notify.
{#r_N-getPhoneNumbers__table_hsf_mwf_wr__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 13. Parâmetros]

{#r_N-getPhoneNumbers__table_hsf_mwf_wr} {#r_N-getPhoneNumbers__table_isf_mwf_wr__entry__2}

| Tipo | Descrição |
|-|-|
| Lista | Lista de objetos NotifyPhoneNumber, cada objeto representando um número de telefone disponível para o Notify. |
[Tabela 14. Retorna]

{#r_N-getPhoneNumbers__table_isf_mwf_wr}  

    var list = SNC.Notify.getPhoneNumbers();
    for (var i = 0; i < list.size(); i++) {
        var num = list.get(i);
        gs.info(num.getNumber())
    }

### Equivalente com escopo {#r_N-getPhoneNumbers__section_it5_ktc_1gb}

Para usar o método getPhoneNumbers() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - getPhoneNumbers()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-getPhoneNumbers "Retorna todos os números de telefone e códigos curtos disponíveis para o Notify.").

## Notify - getTokens(GlideRecord, registro) {#ariaid-title9}

Retorna tokens de cliente para todos os drivers de telefonia ativos para uso em clientes móveis ou WebRTC.
{#r_N-getTokens_GlideRecord__table_vsx_c3n_wr__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| registro | GlideRecord | GlideRecord a ser usado para identificar o cliente Notify, como um registro de grupo ou um registro de usuário. |
[Tabela 15. Parâmetros]

{#r_N-getTokens_GlideRecord__table_vsx_c3n_wr} {#r_N-getTokens_GlideRecord__table_wsx_c3n_wr__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Tokens RTC da web para os drivers compatíveis, como uma cadeia de caracteres JSON com o seguinte formato: {driverName1: "token1", driverName2: "token2"}, como "TwilioDirect":"eyJhxxxx.eyJleHAiOiIxxxx.7fejxxx_mbLxxx" |
[Tabela 16. Retorna]

{#r_N-getTokens_GlideRecord__table_wsx_c3n_wr}  
Este exemplo mostra como obter os tokens de cliente para o usuário conectado no momento.

    // get Notify client Tokens per active Notify driver for the currently logged in user
    var json = new SNC.Notify().getTokens();
     
    // Parse the JSON that was return into a tokens object
    var tokens = JSON.parse(json);

    // Log line
    gs.log('Notify client tokens for the currently logged in user');

     // iterate over the driver tokens
    for (var driver in tokens) {
     	gs.log(driver + ' Driver token: ' + tokens[driver]);
    }

Este exemplo mostra como obter os tokens do cliente para cada grupo do Notify.

    // instantiate Notify
    var notify = new SNC.Notify();
     
    // get all Notify Groups
    var notifyGroup = new GlideRecord("notify_group");
    notifyGroup.query();
     
    // iterate over all notify groups
    while (notifyGroup.next()) {
      // generate Notify Client tokens per active Notify Driver for this group
      var json = notify.getTokens(notifyGroup);
      var tokens = JSON.parse(json);
     
      for (var driver in tokens) {
        gs.log(gs.getMessage("Notify Client token for {0} driver and Notify Group '{1}': {2}", [driver, notifyGroup.getValue('name'), tokens[driver]]));
      }
    }

### Equivalente com escopo {#r_N-getTokens_GlideRecord__section_x32_ysl_1gb}

Para usar o método getTokens() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - getTokens()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-getTokens_GR "Retorna tokens de cliente para todos os drivers de telefonia ativos para uso em clientes móveis ou WebRTC.").

## Notify - getTokenTTL(cadeia de caracteres do proprietário) {#ariaid-title10}

Retorna o tempo máximo que uma sessão do cliente permanece ativa para um driver de telefonia especificado antes de atingir o tempo limite automaticamente.
{#Notify-getTokenTTL_S__table_mnj_xqb_zfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| responsável | Cadeia de caracteres | Nome do driver de telefonia para o qual a duração da sessão será recuperada. Valores válidos: * Twilio: para o driver antigo * TwilioDirect: para o novo driver {#Notify-getTokenTTL_S__ul_ql5_vgc_1gb} |
[Tabela 17. Parâmetros]

{#Notify-getTokenTTL_S__table_mnj_xqb_zfb} {#Notify-getTokenTTL_S__table_nnj_xqb_zfb__entry__2}

| Tipo | Descrição |
|-|-|
| Inteiro | Duração máxima da sessão (em segundos). Padrão: 1800 segundos |
[Tabela 18. Retorna]

{#Notify-getTokenTTL_S__table_nnj_xqb_zfb}  
O exemplo a seguir mostra como chamar corretamente este método e a resposta associada. Ele também mostra o que é retornado se um driver inválido for aprovado.

    var owner = "TwilioDirect";  // Valid driver
    var ttl = SNC.Notify.getTokenTTL(owner);
    gs.info("Token TTL for " + owner + " --> " + ttl);
     
    owner = "Abcxyz";  // Invalid driver
    ttl = SNC.Notify.getTokenTTL(owner);
    // For an invalid driver, we throw NoSuchNotifyDriverException saying that Abcxyzdriver is not available
    // and return the default value of TTL
    gs.info("Token TTL for " + owner + " --> " + ttl); 

### Equivalente com escopo {#Notify-getTokenTTL_S__section_bgp_tk2_1gb}

Para usar o método getTokenTTL() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - getAvailableClients()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-getTokenTTL_S "Retorna o tempo máximo que uma sessão do cliente permanece ativa para um driver de telefonia especificado antes de atingir o tempo limite automaticamente.").

## Notify - hasCapability(cadeia de caracteres notifyPhoneNumber, capacidade de cadeia de caracteres) {#ariaid-title11}

Determina se o número de telefone especificado tem a capacidade especificada.
O driver de telefonia associado ao número de telefone contém uma lista de todos os recursos do telefone.  
Nota:  
No sistema base, o driver Notify JS tem somente "show_speakers" como uma capacidade; isso pode ser modificado.
{#Notify-hasCapability_S_S__table_vsy_rdg_yfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| notifyPhoneNumber | Cadeia de caracteres | Número de telefone para o qual a capacidade especificada será verificada. |
| capacidade | Cadeia de caracteres | Capacidade de detecção. O texto da cadeia de caracteres deve corresponder exatamente ao que está no telefone. |
[Tabela 19. Parâmetros]

{#Notify-hasCapability_S_S__table_vsy_rdg_yfb} {#Notify-hasCapability_S_S__table_wsy_rdg_yfb__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o telefone especificado tem a capacidade especificada. * verdadeiro: o telefone tem a capacidade * falso: o telefone não tem a capacidade {#Notify-hasCapability_S_S__ul_ryg_y2g_yfb} |
[Tabela 20. Retorna]

{#Notify-hasCapability_S_S__table_wsy_rdg_yfb}  
Este exemplo mostra como verificar se um telefone tem uma capacidade específica.

    // Each driver has a defined set of capabilities.

    var capability = 'show_speakers';
    gs.info(SNC.Notify.hasCapability('+185xxxxxxxx', capability)); // true
     
    capability = 'send_sms';
    gs.info(SNC.Notify.hasCapability('+185xxxxxxxx', capability)); // false

### Equivalente com escopo {#Notify-hasCapability_S_S__section_bgp_tk2_1gb}

Para usar o método hasCapability() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - hasCapability()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-hasCapabilitiy_S_S "Determina se o número de telefone especificado tem a capacidade especificada.").

## Notify - kick(participante do GlideRecord) {#ariaid-title12}

Remove o chamador especificado da chamada em conferência atual do Notify.
{#r_N-kick_GlideRecord__table_asm_xdx_ls__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| participante | GlideRecord | Objeto GlideRecord que contém o registro de Participante do Notify \[notify_participant\] do solicitante a ser removido da chamada em conferência. |
[Tabela 21. Parâmetros]

{#r_N-kick_GlideRecord__table_asm_xdx_ls} {#r_N-kick_GlideRecord__table_bsm_xdx_ls__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 22. Retorna]

{#r_N-kick_GlideRecord__table_bsm_xdx_ls}  
O exemplo a seguir mostra como remover um participante de uma chamada em conferência.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.kick(notifyParticipantGr);
    }

### Equivalente com escopo {#r_N-kick_GlideRecord__section_myh_bfd_1gb}

Para usar o método kick() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - kick()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-kick_GR "Remove o chamador especificado da chamada em conferência atual do Notify.").

## Notify - notifyCall(GlideRecord callRecord, NotifyAction notifyAction) {#ariaid-title13}

Executa uma ou mais ações em uma chamada telefônica ativa do Notify.
As ações disponíveis que você pode executar em chamadas incluem enfileirar ou retirar da fila a chamada, ler texto, reproduzir áudio ou encaminhar a chamada. Você também pode criar ações personalizadas Chame o método notifyCall() depois de ter especificado todas as ações que deseja aplicar à chamada especificada. Consulte a documentação da API [NotifyAction](https://servicenow-prod.fluidtopics.net/JFxCQ47wLja56NBBOzKbmg#c_NotifyActionApi "A API NotifyAction permite que você defina ações a serem enviadas para um provedor de telefonia.") para obter mais informações sobre as ações disponíveis.
{#r_N-modifyCall_GR_NA__table_rrh_gzn_wr__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| registro de chamada | GlideRecord | Chamada do Notify \[notify_call\] Registro da chamada para a qual as ações serão aplicadas. |
| NotifyAction | NotifyAction | Objeto NotifyAction que descreve uma ou mais ações a serem executadas na chamada. Crie este objeto chamando um ou mais métodos NotifyAction(). |
[Tabela 23. Parâmetros]

{#r_N-modifyCall_GR_NA__table_rrh_gzn_wr} {#r_N-modifyCall_GR_NA__table_srh_gzn_wr__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 24. Retorna]

{#r_N-modifyCall_GR_NA__table_srh_gzn_wr}  
Este exemplo mostra como modificar uma chamada.

    // get the most recent call record
    var callRecord = new GlideRecord('notify_call');
    callRecord.orderByDesc('sys_created_on');
    callRecord.query();
     
    if (callRecord.next()) {
        // instantiate notify action container class
        var notifyAction = new SNC.NotifyAction();
        // The call is already in progress. Now, we want to modify the call behavior by putting this call in a queue.
        // So, we add a queue action to queue the call
        notifyAction.addQueue('my fancy queue');
       
        // modify the call by passing in the above action, putting the call in a queue
        new SNC.Notify().modifyCall(callRecord, notifyAction);
    } else {
        gs.log('no such call record');
    }

### Equivalente com escopo {#r_N-modifyCall_GR_NA__section_a4l_chd_1gb}

Para usar o método notifyCall() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - notifyCall()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-modifyCall_GR_NA "Executa uma ou mais atividades em uma chamada telefônica ativa do Notify.").

## Notify - mudo (GlideRecord participanteRecord) {#ariaid-title14}

Silencia o participante da chamada em conferência especificado.
{#Notify-mute_GR__table_bch_xfg_yfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ParticipantRecord | GlideRecord | GlideRecord da tabela notify_participant para o participante silenciar. |
[Tabela 25. Parâmetros]

{#Notify-mute_GR__table_bch_xfg_yfb} {#Notify-mute_GR__table_cch_xfg_yfb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 26. Retorna]

{#Notify-mute_GR__table_cch_xfg_yfb}  
O exemplo a seguir mostra como silenciar um solicitante.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.mute(notifyParticipantGr);
    }

### Equivalente com escopo

Para usar o método mute() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - mute()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-mute_GR "Silencia o participante da chamada em conferência especificado.").

## Notify - queueCall(GlideRecord callRecord) {#ariaid-title15}

Coloca a chamada especificada em uma fila (em espera).
Retome uma chamada na fila usando o método dequeueCall().
{#r_N-queueCall_GlideRecord__table_uhl_mcy_js__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| registro de chamada | GlideRecord | Objeto GlideRecord do registro de Chamada do Notify (tabela notify_call) a ser colocado em espera. |
[Tabela 27. Parâmetros]

{#r_N-queueCall_GlideRecord__table_uhl_mcy_js} {#r_N-queueCall_GlideRecord__table_vhl_mcy_js__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 28. Retorna]

{#r_N-queueCall_GlideRecord__table_vhl_mcy_js}  
O exemplo a seguir mostra como colocar uma chamada em espera (na fila).

    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.queueCall(notifyCallGr);
    }

### Equivalente com escopo

Para usar o método queueCall() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - queueCall()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-queueCall_GR "Coloca a chamada especificada em uma fila (em espera).").

## Notify - sendBulkSMS (cadeia de caracteres notifyPhoneNumber, matriz toPhoneNumbers, cadeia de caracteres messageBody, origem de GlideRecord) {#ariaid-title16}

Envia uma mensagem SMS especificada para a lista especificada de clientes do Notify (números de telefone).
{#Notify-sendBulkSMS_NPN_S_S_GR__table_n2q_3zf_yfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| notifyPhoneNumber | Cadeia de caracteres | Número de telefone do Notify do qual a mensagem SMS está sendo enviada. |
| paraNúmerosDeTelefone | Matriz de cadeia de caracteres | Lista separada por vírgulas de números de telefone para os quais a mensagem SMS será enviada. Formato: E.164 |
| corpo da mensagem | Cadeia de caracteres | Texto SMS a ser enviado. |
| origem | GlideRecord | Registro de origem que solicitou esta mensagem SMS, como um incidente. |
[Tabela 29. Parâmetros]

{#Notify-sendBulkSMS_NPN_S_S_GR__table_n2q_3zf_yfb} {#Notify-sendBulkSMS_NPN_S_S_GR__table_o2q_3zf_yfb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Nulo |
[Tabela 30. Retorna]

{#Notify-sendBulkSMS_NPN_S_S_GR__table_o2q_3zf_yfb}  
O exemplo a seguir mostra como enviar uma mensagem SMS em massa.

    var incidentGr = new GlideRecord('incident');
    incidentGr.get(active incident sys_id');
    if (incidentGr.isValid()) {
        SNC.Notify.sendBulkSMS('+15413970605', ['+919885XXXXXX', '+919775XXXXXX'], 'Test automation message', incidentGr);
    }

### Equivalente com escopo

Para usar o método sendBulkSMS() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - sendBulkSMS()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-sendBulkSMS_NPN_S_S_GR "Envia uma mensagem SMS especificada para a lista especificada de clientes do Notify (números de telefone).").

## Notify - sendSMS (cadeia de caracteres notifyPhoneNumber, cadeia de caracteres toPhoneNumber, cadeia de caracteres messageBody, origem de GlideRecord) {#ariaid-title17}

Envia uma mensagem de texto SMS para um número de telefone compatível com E.164.
Este método cria um novo registro na tabela Notify Message \[notify_message\] e o associa ao registro de origem.
{#r_N-sendSMS_NPN_S_S_GR__table_dnk_4dn_wr__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| notifyPhoneNumber | Cadeia de caracteres | Número de telefone do Notify do qual a mensagem SMS está sendo enviada. |
| paraNúmeroDeTelefone | Cadeia de caracteres | Número de telefone compatível com E.164 para o qual a mensagem SMS será enviada. |
| corpo da mensagem | Cadeia de caracteres | Corpo da mensagem de texto SMS. |
| origem | GlideRecord | Registro de origem que solicitou esta mensagem SMS, como um incidente. |
[Tabela 31. Parâmetros]

{#r_N-sendSMS_NPN_S_S_GR__table_dnk_4dn_wr} {#r_N-sendSMS_NPN_S_S_GR__table_enk_4dn_wr__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | SID de mensagem exclusiva; armazenado no registro Notify Message \[notify_message\] como message_id. |
[Tabela 32. Retorna]

{#r_N-sendSMS_NPN_S_S_GR__table_enk_4dn_wr}  
O exemplo a seguir mostra como enviar uma mensagem SMS.

    var incidentGr = new GlideRecord('incident');
    incidentGr.get('active incident sys_id');
    if (incidentGr.isValid()) {
        SNC.Notify.sendSMS('+15413970605', '+919885XXXXXX', 'Test automation message', incidentGr);
    }

### Equivalente com escopo {#r_N-sendSMS_NPN_S_S_GR__section_kby_cyc_1gb}

Para usar o método sendSMS() em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - sendSMS()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-sendSMS_NPN_S_S_GR "Envia uma mensagem de texto SMS para um número de telefone compatível com E.164.").

## Notify - unmute(GlideRecord participanteRecord) {#ariaid-title18}

Reativa o mudo do participante da chamada em conferência especificado.
{#Notify-unmute_GR__table_v1w_p3g_yfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ParticipantRecord | GlideRecord | GlideRecord da tabela notify_participant para o participante cancelar o mudo. |
[Tabela 33. Parâmetros]

{#Notify-unmute_GR__table_v1w_p3g_yfb} {#Notify-unmute_GR__table_w1w_p3g_yfb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 34. Retorna]

{#Notify-unmute_GR__table_w1w_p3g_yfb}  
O exemplo a seguir mostra como reativar o mudo de um solicitante.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.unmute(notifyParticipantGr);
    }

### Equivalente com escopo {#Notify-unmute_GR__section_a4l_chd_1gb}

Para usar o método unmute () em uma aplicação com escopo, use o método com escopo correspondente: [NotifyScoped - unmute()](https://servicenow-prod.fluidtopics.net/xiCWUHwJoHN1gNMFGKVUFQ#NotifyScoped-unmute_GR "Reativa o mudo do participante da chamada em conferência especificado.").