Notificação com escopo - Com escopo

. Notificação com escopo A API permite interagir com chamadas de Notify e mensagens SMS usando scripts.

Execute o. Notificação com escopo e seus métodos associados do sn_notify namespace.

NotifyScoped - call(cadeia de caracteres notificyPhoneNumber, cadeia de caracteres toPhoneNumber, GlideRecord conferenceCall, GlideRecord conferenceCallRecord, cadeia de caracteres userSysId, cadeia de caracteres groupSysId, GlideRecord sourceRecord)

Liga para o número de telefone compatível com E.164 especificado.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
NotifyPhoneNumber	Cadeia de caracteres	Notify número de telefone do qual fazer a chamada. 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 um ingressar na chamada em conferência atividade para conectar o usuário à chamada em conferência.
ToPhoneNumber	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 chamadores identificados no toPhoneNumbero parâmetro entra automaticamente na chamada em conferência identificada por este registro. GlideRecord para a tabela Notify Call [Notify_call] que identifica o registro de 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 2. Retornos

Tipo	Descrição
vazio

Este exemplo ilustra como iniciar uma chamada para outro número de telefone.

var from = '[phone]';
var to = '[phone]';

// set up call
new sn_notify.NotifyScoped().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 sn_notify.NotifyScoped();
var from = '[phone]';
var participants = ['[phone]', '[phone]', '[phone]'];

// 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);
}

NotificaEscopo - conferenceCall (GlideRecord sourceRecord)

Cria um novo GlideRecord de chamada em conferência.

Tabela 3. Parâmetros

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 tabela no registro NOTIFY_CONFERENCE_CALL.

Tabela 4. Retornos

Tipo	Descrição
GlideRecord	Novo registro de chamada em conferência Notify [NOTIFY_CONFERENCE_CALL].

var notify = new sn_notify.NotifyScoped();
var from = '[phone]';
var participants = ['[phone]', '[phone]', '[phone]'];

// 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);
}

NotifyScoped - dequeueCall (GlideRecord callRecord)

Reinicia uma chamada depois que ela foi colocada em uma fila (em espera).

Use este método para retomar chamadas que foram colocadas em uma fila com QueueCall() método.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Registro de chamada	GlideRecord	Objeto GlideRecord na tabela Notify Call [Notify_call] com a chamada em espera que você deseja retomar.

Tabela 6. Retornos

Tipo	Descrição
vazio

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) {
    sn_notify.NotifyScoped.dequeueCall(notifyCallGr);
}

NotifyScoped - forwardCall (chamada GlideRecord, destino de cadeia de caracteres, cadeia de caracteres dtmf)

Encaminha a chamada especificada para um destinatário de chamada diferente.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
chamada	GlideRecord ou String	Notify registro de chamada ou o ID de chamada do provedor de telefonia da chamada a ser encaminhada.
destino	GlideRecord ou String	Notify registro de número de telefone ou um número de telefone compatível com E.164, do chamador para o qual encaminhar a chamada.
dtmf	Cadeia de caracteres	Tom duplo - Código de multifrequência (DTMF) a ser enviado mediante conexão de chamada.

Tabela 8. Retornos

Tipo	Descrição
vazio

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) {
    sn_notify.NotifyScoped.forwardCall(notifyCallGr(or) callID, phoneNumber, dtmfTones)
}

NotifyScoped - getAvailableClients(cadeia de caracteres notificyNumber)

Retorna uma lista de sessões de cliente que estão disponíveis para receber chamadas.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
NotifyNumber	Cadeia de caracteres	Número de telefone do Notify válido.

Tabela 10. Retornos

Tipo	Descrição
Matriz	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.

O exemplo a seguir mostra como usar o. GetAvailableClients() Método para indexar na tabela NOTIFY_CLIENT_SESSION e iterar em todos os clientes Notify disponíveis.

var clientSessionGr = sn_notify.NotifyScoped.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);

NotifyScoped - getPhoneNumbers()

Retorna todos os números de telefone e códigos curtos disponíveis para notificação.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 12. Retorna

Tipo	Descrição
Matriz	Lista de objetos NotifyPhoneNumber, cada objeto representando um número de telefone disponível para notificação.

Este exemplo ilustra como obter os números de telefone do Notify e, em seguida, iterar sobre a lista.

// Instantiate notify
var notify = new sn_notify.NotifyScoped();

// Retrieve all available phone numbers
var phoneNumbers = notify.getPhoneNumbers();

// Iterate over phone numbers
for (var i = 0; i < phoneNumbers.length; i++) {
  var number = phoneNumbers[i];

  // Perform any actions using each phone number

}

NotifyScoped - getShortCodes()

Retorna todos os códigos curtos disponíveis para Notify.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 14. Retorna

Tipo	Descrição
vazio

Este exemplo ilustra como obter os códigos curtos do Notify e, em seguida, iterar sobre a lista.

// Instantiate notify
var notify = new sn_notify.NotifyScoped();

// Retrieve all available shortcodes
var shortCodes = notify.getShortCodes();

// Iterate over phone numbers
for (var i = 0; i < shortCodes.length; i++) {
  var shortCode = shortCodes[i];
  gs.log(shortCode.getNumber());

//perform any actions using each shortcode

}

NotifyScoped - getTokens(GlideRecord, registro)

Retorna tokens de cliente para todos os drivers de telefonia ativos para uso em WebRTC ou clientes móveis.

Este método usa o registro de usuário conectado no momento como o cliente.

Tabela 15. Parâmetros

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 16. Retornos

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"

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 sn_notify.NotifyScoped().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 de cliente para cada grupo do Notify.

// instantiate Notify
var notify = new sn_notify.NotifyScoped.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]]));
  }
}

Este exemplo ilustra como obter os tokens de cliente para os drivers de telefonia ativos.

var notify = new sn_notify.NotifyScoped();
var now_GR = new GlideRecord('sys_user');
if (now_GR.get(gs.getUserID())) {
  gs.info(notify.getTokens(now_GR));
}

Saída:

{"TwilioDirect":"eyJhxxxx.eyJleHAiOiIxxxx.7fejxxx_mbLxxx"}

NotifyScoped - getTokenTTL (proprietário da cadeia de caracteres)

Retorna a quantidade máxima de tempo que uma sessão do cliente permanece ativa para um driver de telefonia especificado antes de expirar automaticamente.

Tabela 17. Parâmetros

Nome	Tipo	Descrição
responsável	Cadeia de caracteres	Nome do driver de telefonia para o qual recuperar a duração da sessão. Valores válidos: Twilio: Para o motorista antigo TwilioDirect: Para o novo driver

Tabela 18. Retornos

Tipo	Descrição
Inteiro	Duração máxima da sessão (em segundos). Padrão: 1800 segundos

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); 

NotifyScoped - hasCapability (cadeia de caracteres notificyPhoneNumber, capacidade de cadeia de caracteres)

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 todas as capacidades do telefone.

Nota:

No sistema base, o driver Notify JS só tem "show_speakers" como uma capacidade; isso pode ser modificado.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
NotifyPhoneNumber	Cadeia de caracteres	Número de telefone para o qual verificar a capacidade especificada.
capacidade	Cadeia de caracteres	Capacidade de detectar. O texto da cadeia de caracteres deve corresponder exatamente ao que está no telefone.

Tabela 20. Retornos

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

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(sn_notify.NotifyScoped.hasCapability('+185xxxxxxxx', capability)); // true
 
capability = 'send_sms';
gs.info(sn_notify.NotifyScoped.hasCapability('+185xxxxxxxx', capability)); // false

NotifyScoped - chute (participante GlideRecord)

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

Tabela 21. Parâmetros

Nome	Tipo	Descrição
participante	GlideRecord	Objeto GlideRecord que contém o registro Notify Participant [notify_participant] do chamador a ser removido da chamada em conferência.

Tabela 22. Retornos

Tipo	Descrição
vazio

Este exemplo mostra como remover um participante de uma chamada.

var participant = new GlideRecord('notify_participant');
participant.get('<sys_id>');
if (participant.isValid()) {
    new sn_notify.NotifyScoped().kick(participant);
}

NotifyScoped - modifyCall(GlideRecord callRecord, NotifyAction)

Executa uma ou mais atividades em uma chamada telefônica do Notify ativa.

Use este método para mudar o comportamento de uma chamada. Por exemplo, transferir uma chamada, reproduzir áudio ou forçar um desligamento.

Nota:

A implementação com escopo deste método oferece suporte somente a atividades de Notify personalizadas. Ao contrário da implementação global, ela não fornece um NotifyAction API. Para obter detalhes sobre como criar uma atividade de Notify personalizada, consulte Atividades de fluxo de trabalho do Notify .

Tabela 23. Parâmetros

Nome	Tipo	Descrição
Registro de chamada	GlideRecord	Notify Call [NOTIFY_CALL] registro da chamada para a qual as ações serão aplicadas.
Notify yAction	NotifyAction	Objeto NotifyAction que descreve uma ou mais atividades a serem executadas na chamada.

Tabela 24. Retornos

Tipo	Descrição
vazio

NotifyScoped - mudo (GlideRecord ParticidentRecord)

Silencia o participante da chamada em conferência especificado.

Tabela 25. Parâmetros

Nome	Tipo	Descrição
Registro de participante	GlideRecord	GlideRecord da tabela Notify_participant para o participante silenciar.

Tabela 26. Retornos

Tipo	Descrição
vazio

O exemplo a seguir mostra como silenciar um chamador.

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

NotifyScoped - queueCall (GlideRecord callRecord)

Coloca a chamada especificada em uma fila (em espera).

Retome uma chamada em fila usando DequeueCall() método.

Tabela 27. Parâmetros

Nome	Tipo	Descrição
Registro de chamada	GlideRecord	Objeto GlideRecord do registro Notify Call (tabela NOTIFY_CALL) a ser colocado em espera.

Tabela 28. Retornos

Tipo	Descrição
vazio

var call = new GlideRecord('notify_call');
call.get('<call record sys_id>');
if (call.isValid()) {
    new sn_notify.NotifyScoped().queueCall(call);
}

NotifyScoped - sendBulkSMS(NotifyPhoneNumber notificyPhoneNumber, cadeia de caracteres para PhoneNumbers, cadeia de caracteres MessageBody, origem GlideRecord)

Envia uma mensagem SMS especificada para a lista especificada de clientes do Notify (números de telefone).

Tabela 29. Parâmetros

Nome	Tipo	Descrição
NotifyPhoneNumber	NotifyPhoneNumber	Número de telefone do qual a mensagem SMS está sendo enviada.
ToPhoneNumbers	Cadeia de caracteres	Números de telefone da lista separada por vírgulas para os quais enviar a mensagem SMS. Formato: Em conformidade com 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 30. Retornos

Tipo	Descrição
Cadeia de caracteres	Nulo

Este exemplo mostra como enviar uma mensagem SMS para vários números de telefone (SMS em massa).

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

NotifyScoped - sendSMS(NotifyPhoneNumber notifyPhoneNumber, cadeia de caracteres para PhoneNumber, cadeia de caracteres MessageBody, GlideRecord source)

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 Mensagem Notify [NOTIFY_MESSAGE] e o associa ao registro de origem.

Tabela 31. Parâmetros

Nome	Tipo	Descrição
NotifyPhoneNumber	NotifyPhoneNumber	Notify número de telefone ou código curto para o qual enviar esta mensagem SMS.
ToPhoneNumber	Cadeia de caracteres	Número de telefone compatível com E.164 para o qual enviar a mensagem SMS.
Corpo da mensagem	Cadeia de caracteres	Mensagem de texto SMS.
origem	GlideRecord	Registro de origem que solicitou esta mensagem SMS, como um incidente.

Tabela 32. Retornos

Tipo	Descrição
Cadeia de caracteres	SID de mensagem exclusivo; armazenado no registro Mensagem de Notify [notify_message] como message_id.

O exemplo a seguir mostra como enviar uma mensagem SMS.

var incidentGr = new GlideRecord('incident');
incidentGr.get('active incident sys_id');
if (incidentGr.isValid()) {
    sn_notify.NotifyScoped.sendSMS('[phone]', '+919885XXXXXX', 'Test automation message', incidentGr);
}

NotifyScoped - Não mudo (GlideRecord ParticidentRecord)

Ativa o som do participante da chamada em conferência especificado.

Tabela 33. Parâmetros

Nome	Tipo	Descrição
Registro de participante	GlideRecord	GlideRecord da tabela Notify_participant para o participante ativar o mudo.

Tabela 34. Retornos

Tipo	Descrição
vazio

Este exemplo mostra como ativar o mudo de um participante de chamada especificado.

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