NotifyJsTelephonyDriver - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura

    • . NotifyJsTelephonyDriver A API fornece métodos que você pode usar para obter informações sobre os recursos do driver de telefonia associado.

    É um ponto de extensão com script que só pode ser usado quando seu objeto é retornado por outro método, como NotifyUtil - getTelephonyDrivers FromNotifyNumber() . Não é possível chamar esta API diretamente. O método de chamada associa um driver específico à interface, abstraindo os detalhes da determinação do driver. Cada um dos drivers disponíveis implementa a mesma interface, que é definida pelo NotifyJsTelephonyDriver API.

    No exemplo de código a seguir, ObtNúmero de NotifyTelefone() O método retorna uma implementação desta API, com a interface do driver sendo determinada pelo número de telefone passado, como TwilioNotifyJsTelephonyDriver. 
    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        driverName: driver.getName(),
        supportsCall: driver.supportsCall(),
        supportsSMS: driver.supportsSms()
      } 
    }
}

    Para ver quais drivers estão associados ao ponto de extensão NotifyJsTelephonyDriver, navegue até Pontos de extensão do sistema > NotifyJsTelephonyDriver . Todas as implementações de driver associadas aparecem no Implementações guia.

    Para obter informações adicionais sobre pontos de extensão com script, consulte Usando pontos de extensão para estender o ponto de funcionalidade da aplicação .

    Para usar esta API, você deve ativar o plug-in Notify (com.snc.notify). Para ativar implementações de driver específicas, como Twillo, você deve ativar o plug-in específico.

    NotifyJsTelephonyDriver - call(Object notifyPhoneNumber, cadeia de caracteres phoneNumber)

    Liga para um número de telefone especificado.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    NotifyPhoneNumber NotifyPhoneNumber - Global Registro NotifyPhoneNumber que contém o número de telefone do Notify do qual fazer a chamada.

    Tabela: Tabela Número de telefone do Notify [notify_number].
    ToPhoneNumber Cadeia de caracteres Número de telefone para ligar.

    Formato: E.164
    Tabela 2. Retornos
    Tipo Descrição
    Nenhum

    NotifyJsTelephonyDriver - GetCapabilities()

    Retorna uma lista dos recursos do driver de telefonia.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    Nenhum

    Este exemplo retorna os recursos do driver de telefonia associado.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
       capabilities: driver.getCapabilities()
      } 
    }
}

    NotifyJsTelephonyDriver - getMaxSizeForBulkSms(String phoneNumber)

    Retorna o número máximo de números de telefone para os quais o driver de telefonia associado ao número de telefone do Notify aprovado pode enviar uma mensagem SMS de uma só vez.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    phoneNumber Cadeia de caracteres Número de telefone do Notify para verificar o número máximo de números de telefone para os quais o motorista associado pode enviar em uma mensagem SMS em massa.
    Tabela 6. Retornos
    Tipo Descrição
    Número Número máximo de números de telefone para os quais uma mensagem SMS pode ser enviada em uma única entrega de SMS em massa.

    Este exemplo retorna o número máximo de números de telefone que podem ser enviados para em uma única mensagem SMS em massa para o driver de telefonia associado.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
       return {
       maxSmsNumbers: driver.getMaxSizeForBulkSMS(notifyNumber)
      }       
    }
}

    NotifyJsTelephonyDriver - getPhoneNumber(cadeia de caracteres phoneNumber)

    Retorna o registro do número de telefone do Notify para o número de telefone especificado.

    Retorna nulo se o número de telefone especificado não for encontrado na tabela Número de telefone do Notify [notify_number].

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    NotifyPhoneNumberAPI Registro de número de telefone do Notify associado ao número de telefone especificado.

    Este exemplo obtém o driver de telefonia e retorna o registro de número de telefone do Notify associado a um número de telefone especificado.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
       phoneNumberRecord: driver.getPhoneNumber(notifyNumber)
      } 
    }
}

    NotifyJsTelephonyDriver - getPhoneNumbers()

    Retorna uma lista de todos os números de telefone do Notify associados ao driver de telefonia atual.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Cadeia de caracteres Lista separada por vírgulas de todos os números de telefone do Notify associados ao driver atual.

    Este exemplo obtém o driver de telefonia e retorna a lista de números de telefone do Notify associados ao driver de telefonia atual.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
       phoneNumbers: driver.getPhoneNumbers()
      } 
    }
}

    NotifyJsTelephonyDriver - isActive()

    Verifica se o driver de telefonia atual está ativo.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    Booliano

    Sinalizador que indica se o driver de telefonia atual está ativo.

    Valores válidos:
    • Verdadeiro: O driver está ativo.
    • Falso: O driver está inativo.

    Este exemplo obtém o driver de telefonia e retorna se o driver de telefonia atual está ativo.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        active: driver.isActive()
      } 
    }
}

    NotifyJsTelephonyDriver - kick(GlideRecord participantRecord)

    Remove o chamador especificado da chamada em conferência do Notify atual.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    ParticidentRecord GlideRecord - Global Objeto GlideRecord que contém o registro Notify Participante [notify_participant] do chamador a ser removido da chamada em conferência.
    Tabela 14. Retornos
    Tipo Descrição
    Cadeia de caracteres Retornado somente em caso de erro. Mensagem de erro que descreve por que o chamador não foi removido da chamada.

    Este exemplo silencia o chamador associado na chamada em conferência atual.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      var notifyParticipantGr = new GlideRecord('notify_participant');
      notifyParticipantGr.get('active participant sys id');
    
      if (notifyParticipantGr.isValid) {
        driver.kick(notifyParticipantGr)
    }
}

    NotifyJsTelephonyDriver - mudo(GlideRecord participantRecord)

    Silencia o chamador especificado na chamada em conferência do Notify atual.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    ParticidentRecord GlideRecord - Global Objeto GlideRecord que contém o registro Notify Participant [notify_participant] do chamador a ser silenciado na chamada em conferência.
    Tabela 16. Retornos
    Tipo Descrição
    Cadeia de caracteres Retornado somente em caso de erro. Mensagem de erro que descreve por que o chamador não foi silenciado.

    Este exemplo silencia o chamador associado na chamada em conferência atual.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      var notifyParticipantGr = new GlideRecord('notify_participant');
      notifyParticipantGr.get('active participant sys id');
    
      if (notifyParticipantGr.isValid) {
        driver.mute(notifyParticipantGr)
    }
}

    NotifyJsTelephonyDriver - sendAutonomousBulkSms(Object notifyPhoneNumber, Array toPhoneNumber, String message, GlideRecord source)

    Envia a mensagem SMS (Short Message Service) especificada para a lista especificada de números de telefone.

    Opcionalmente, você pode associar o registro de incidente que causou a geração da mensagem SMS à mensagem SMS.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem a ser enviada.
    NotifyPhoneNumber NotifyPhoneNumber - Global Registro que contém o número de telefone que está enviando a mensagem SMS em massa.
    origem GlideRecord - Global Opcional. GlideRecord de incidente a ser armazenado no campo Origem do registro de mensagem SMS associado na tabela Mensagem de notificação [mensagem de notificação]. Vincula o registro de incidente que causou a geração da mensagem SMS a essa mensagem SMS.

    Padrão: Nenhum. Se este parâmetro não for passado, essas informações não serão rastreadas.
    ToPhoneNumbers Matriz Lista de números de telefone dos dispositivos para receber a mensagem SMS.
    Tabela 18. Retornos
    Tipo Descrição
    Nenhum(a)

    Este exemplo mostra como enviar um SMS autônomo em massa.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {

    }
}

    NotifyJsTelephonyDriver - sendSMS(NotifyPhoneNumber notifyPhoneNumber, cadeia de caracteres para PhoneNumber, cadeia de caracteres MessageBody)

    Envia uma mensagem SMS (Short Message Service) especificada para um número de telefone especificado.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    NotifyPhoneNumber NotifyPhoneNumber - Global Registro de número de telefone do Notify que contém o número de telefone que está enviando a mensagem SMS.

    Tabela: Número de telefone do Notify [notify_number]
    ToPhoneNumber Cadeia de caracteres Número de telefone para o qual enviar a mensagem SMS.

    Formato: Compatível com E.164
    mensagem Cadeia de caracteres Texto a ser enviado na mensagem SMS.
    Tabela 20. Retornos
    Tipo Descrição
    Nenhum

    NotifyJsTelephonyDriver - SupportsAutonomousBulkSms(String phoneNumber)

    Verifica se o número de telefone do Notify especificado é capaz de lidar com mensagens de SMS (Short Message Service, serviço de mensagens curtas) autônomas em massa.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 22. Retorna
    Tipo Descrição
    Booliano

    Sinalizador que indica se o número de telefone do Notify especificado oferece suporte a SMS em massa autônomo.

    Valores válidos:
    • Verdadeiro: Oferece suporte a SMS em massa autônomo.
    • Falso: Não oferece suporte a SMS em massa autônomo.

    Este exemplo obtém o driver de telefonia e retorna se o driver oferece suporte a SMS em massa autônomo.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        supportsBulkSMS: driver.supportsAutonomousBulkSms(notifyNumber)
      } 
    }
}

    NotifyJsTelephonyDriver - SupportsCall()

    Verifica se o driver de telefonia atual é capaz de lidar com chamadas telefônicas.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 24. Retorna
    Tipo Descrição
    Booliano

    Sinalizador que indica se o driver de telefonia atual oferece suporte a chamadas telefônicas.

    Valores válidos:
    • Verdadeiro: O driver oferece suporte a chamadas telefônicas.
    • Falso: O driver não oferece suporte a chamadas telefônicas.

    Este exemplo obtém o driver de telefonia e retorna se o driver oferece suporte a chamadas telefônicas.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        supportsCall: driver.supportsCall()
      } 
    }
}

    NotifyJsTelephonyDriver - SupportsCallOverWebRtc()

    Verifica se o número de telefone do Notify especificado é capaz de fazer chamadas para um navegador usando WebRTC (Comunicações em tempo real).

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 26. Retorna
    Tipo Descrição
    Booliano

    Sinalizador que indica se o número de telefone do Notify especificado oferece suporte a chamadas do navegador usando WebRTC.

    Valores válidos:
    • Compatível com WebRTC.
    • Falso: Não é compatível com WebRTC.

    Este exemplo obtém o driver de telefonia e retorna se o driver oferece suporte a chamadas do navegador usando WebRTC.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        supportsWebRTC: driver.supportsCallOverWebRtc(notifyNumber)
      } 
    }
}

    NotifyJsTelephonyDriver - SupportsSMS()

    Verifica se o driver de telefonia atual é capaz de lidar com mensagens SMS (Short Message Service, serviço de mensagens curtas).

    Tabela 27. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 28. Retorna
    Tipo Descrição
    Booliano

    Sinalizador que indica se o driver de telefonia atual oferece suporte a SMS.

    Valores válidos:
    • Verdadeiro: O driver oferece suporte a SMS.
    • Falso: O driver não é compatível com SMS.

    Este exemplo obtém o driver de telefonia e retorna se o driver oferece suporte a SMS.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        supportsSMS: driver.supportsSMS()
      } 
    }
}

    NotifyJsTelephonyDriver - unmute(GlideRecord participantRecord)

    Desativa o mudo do chamador especificado na chamada em conferência do Notify atual.

    Tabela 29. Parâmetros
    Nome Tipo Descrição
    ParticidentRecord GlideRecord - Global Objeto GlideRecord que contém o registro Notify Participant [notify_participant] do chamador a ser silenciado na chamada em conferência.
    Tabela 30. Retornos
    Tipo Descrição
    Cadeia de caracteres Retornado somente em caso de erro. Mensagem de erro que descreve por que o chamador não foi silenciado.

    Este exemplo silencia o chamador associado na chamada em conferência atual.

    getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      var notifyParticipantGr = new GlideRecord('notify_participant');
      notifyParticipantGr.get('active participant sys id');
    
      if (notifyParticipantGr.isValid) {
        driver.unmute(notifyParticipantGr)
    }
}