Vonage spoke

Solicitar aplicativos na Store

Visite ServiceNow Storepara exibir todos os apps disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.

Assinatura do IntegrationHub

Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do IntegrationHub.

Versão do spoke

Vonage spoke v 2.0.0 é a versão mais recente.

Versões compatíveis

Este spoke foi criado para Vonage para essas versões, mas pode ser compatível com versões posteriores:

API de mensagens versão v1
API de voz versão v1

Requisitos do spoke

Acesso de administrador para Vonage conta e. Vonage API Painel .
Registre os valores de Chave de API e. Segredo da API . Você pode acessar esses valores no Vonage Painel de API. Para obter mais informações, consulte Autenticação . Vonage API Developer site de documentação.
Registre e salve o valor de Segredo da assinatura . Você pode acessar este valor no Configurações da conta no painel da API do Vonage . Para obter mais informações, consulte Autenticação . Vonage API Developer site de documentação.

Dependências do spoke

Se você estiver tendo problemas para instalar o aplicativo, verifique se estes plug-ins dependentes estão instalados:

ServiceNow Etapa de ação do IntegrationHub - REST (com.glide.hub.action_step.rest)
ServiceNow Tempo de execução do IntegrationHub (com.glide.hub.integration.runtime)
Objeto complexo (com.glide.cobject)
ServiceNow Designer de fluxo - Entradas dinâmicas (com.glide.hub.dynamic_inputs)

Nota:

Alguns desses plug-ins são recursos licenciáveis e exigem licenças apropriadas, se usados fora da implementação do spoke.

Subfluxos do spoke

. Vonage spoke fornece subfluxos de amostra para demonstrar a automação Vonage tarefas. Para personalizar um subfluxo de amostra, copie-o para um novo escopo da aplicação. Os subfluxos de amostra disponíveis incluem:


Subfluxo	Descrição
Vonage Webhook de SMS	Processa as solicitações de SMS de Vonage .
Vonage Webhook de voz	Processa as solicitações de voz de Vonage .
Vonage WhatsApp Webhook	Processa o. WhatsApp solicitações de Vonage .

Para personalizar o subfluxo padrão, você deve criar uma cópia do subfluxo de amostra e personalizar o subfluxo de acordo com sua necessidade. Ao personalizar subfluxos, você deve garantir que os subfluxos estejam configurados para evitar loops infinitos.

Gatilhos do spoke

Use gatilhos no spoke do Vonage para assinar os eventos necessários. O endpoint permite que os webhooks se conectem à sua instância da ServiceNow. Você pode configurar os fluxos para serem executados somente quando as condições do gatilho especificadas forem atendidas. Os eventos compatíveis são:


Categoria	Gatilho	Descrição
Gestão de chamadas	Toque de voz	O gatilho é iniciado quando uma chamada é feita do Vonage e o número está tocando.
	Resposta de voz	O gatilho é iniciado quando uma chamada é feita do Vonage e a chamada é atendida.
	Voz concluída	O gatilho é iniciado quando uma chamada é feita do Vonage e a chamada é concluída.
Gestão de SMS	SMS entregue	O gatilho é iniciado quando um SMS é enviado do Vonage para um número.
	SMS falhou	O gatilho é iniciado quando um SMS é enviado da Vonage e falha.
	SMS aceito	O gatilho é iniciado quando uma mensagem é aceita para entrega, mas ainda não foi entregue.

Para obter informações sobre como configurar os gatilhos do Spoke Vonage, consulte Configurar o gatilho do Spoke vonage .

Ações do spoke

. Vonage spoke fornece ações para automatizar Vonage tarefas quando ocorrem eventos no ServiceNow instância. As ações disponíveis incluem:


Categoria	Ação	Descrição
Gestão de contas	Obter saldo da conta	Recupera o saldo atual do Vonage conta.
Gestão de chamadas	Reproduza o tom DTMF na chamada	Reproduz tons DTMF (multifrequência de tom duplo) em uma chamada ativa
	Anexar gravação a. ServiceNow Registro	Anexa uma gravação de chamada ao destino ServiceNow registro.
	Criar chamada de saída	Cria uma chamada de saída para um número de telefone.
	Gerar NCCO	Cria objetos de controle de chamadas Nexmo (NCCO) que são usados na ação Criar uma chamada de saída.
	Gerar Connect NCCO	Gera um objeto de controle de chamadas Nexmo (NCCO) que define como conectar uma chamada de saída a endpoints, como um número de telefone ou WebSocket.
	Notify NCCO	Gera um objeto de controle de chamada Nexmo (NCCO) que define uma ação Notify para uma chamada de saída.
	Gerar NCCO de transferência	Gera um objeto de controle de chamada Nexmo (NCCO) que define como transferir uma chamada ativa.
	Pesquisar detalhes da chamada	Recupera os detalhes da chamada especificada.
	Pesquisar chamadas	Recupera detalhes das chamadas especificadas.
	Reproduzir áudio na chamada	Reproduz um arquivo de áudio em uma chamada ativa.
	Reproduza Texto para fala na chamada	Reproduz conversão de texto em fala em uma chamada ativa.
	Parar a reprodução de áudio na chamada	Para a reprodução de um arquivo de áudio em uma chamada ativa.
	Parar Texto para fala na chamada	Para a conversão de texto em fala em uma chamada ativa.
	Atualizar chamada	Atualiza o status de uma chamada ativa.
Gestão de números	Pesquisar números	Recupera todos os números de entrada associados à conta do Vonage.
Gestão de RCS Nota: Se você estiver fazendo upgrade de uma versão anterior do spoke, certifique-se de gerar um novo token JWT no registro de credencial existente antes de usar essas ações de categoria.	Enviar mensagem do cartão RCS	Envia uma mensagem de cartão RCS (Rich Communication Services) para um número de telefone especificado.
	Enviar mensagem de mídia do RCS	Envia uma mensagem de mídia RCS (Rich Communication Services) para um número de telefone especificado.
	Enviar mensagem de texto do RCS	Envia uma mensagem de texto RCS (Rich Communication Services) para um número de telefone especificado.
Gestão de SMS	Enviar SMS	Envia um SMS (Short Message Service) para um número de telefone.
WhatsApp Gestão Nota: Se você estiver fazendo upgrade de uma versão anterior do spoke, certifique-se de gerar um novo token JWT no registro de credencial existente antes de usar essas ações de categoria.	Enviar contatos	Envia contatos para um WhatsApp número.
	Local de envio	Envia coordenadas geográficas de um local para um WhatsApp número.
	Enviar mensagem de mídia	Envia uma mensagem de mídia para um WhatsApp número.
	Enviar mensagem de texto	Envia uma mensagem de texto para um WhatsApp número.
	Enviar mensagem de texto usando o modelo	Envia uma mensagem de texto usando o modelo para um WhatsApp número.

Módulo Spoke

Os webhooks bidirecionais podem ser configurados para serem notificados sobre os eventos necessários. A política de roteamento define condições que devem ser atendidas para notificar o. ServiceNow instância. Essas condições são baseadas nos eventos em Vonage sobre o qual você deseja ser notificado. Quando as condições são atendidas, a política de roteamento aciona o subfluxo associado, que, por sua vez, automatiza o. Vonage tarefas. Por padrão, o. Vonage A aplicação Spoke está disponível e tem os seguintes módulos:

Vonage Registros do webhook
Vonage Políticas de roteamento do webhook

Use o. Vonage Webhook Registries para atribuir um token e fornecer o caminho da API. Você deve gerar um URL de retorno de chamada aqui e fornecer este URL em Vonage . As políticas de roteamento padrão são fornecidas como referência no Vonage Módulo de políticas de roteamento do webhook. Personalize essas políticas de roteamento de acordo com seu requisito. A política de roteamento oferece suporte a estes campos:

Palavras-chave
Direção da chamada
Status da chamada
Tipo de evento
De
Status do SMS
Mensagem SMS
Para
WhatsApp Status da mensagem
WhatsApp Texto
Mostrar campos relacionados

Requisitos de aliases de conexão e credencial

IntegrationHub usa aliases para gerenciar informações de conexão e credenciais. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão. Para obter mais informações, consulte Connections and Credentials.

Dois aliases de conexão e credencial estão disponíveis junto com o. Vonage spoke:


Vonage alias	Descrição
VonagePrimary	Necessário para as ações que gerenciam SMS, número e conta.
Vonage	Necessário para as ações que gerenciam chamadas e. WhatsApp .

Para obter informações sobre como configurar o spoke, consulte Configure o. Vonage spoke.