Vonage Spoke

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura

    • Gerencie comunicações por meio de chamadas, SMS e do WhatsApp usando a conta Vonage da sua instância ServiceNow.

    Solicitar aplicativos na Store

    Acesse o site ServiceNow Store para ver todos os aplicativos 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 Integration Hub

    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

    O spoke Vonage v1.1.3 é a versão mais recente.

    Versões compatíveis

    Este spoke foi criado para Vonage para estas versões, mas pode ser compatível com versões posteriores:
    • API de mensagens versão v0.1
    • API de voz versão v1

    Requisitos do spoke

    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 Flow Designer - 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

    O spoke do Vonage fornece subfluxos de amostra para demonstrar a automação de tarefas Vonage. 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 do WhatsApp Webhook Processa as do 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 seus requisitos. Ao personalizar subfluxos, você deve garantir que os subfluxos estejam configurados para evitar loops infinitos.

    Ações do spoke

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

    Categoria Ação Descrição
    Gestão de contas Obter saldo da conta Recupera o saldo atual da conta do Vonage.
    Gestão de chamadas Reproduzir toque DTMF na chamada Reproduz tons DTMF (Dual-Tom Multi-Frequency) em uma chamada ativa
    Anexar gravação ao registro ServiceNow Anexa uma gravação de chamada ao registro ServiceNow de destino.
    Criar chamada de saída Cria uma chamada de saída para um número de telefone.
    Gerar NCCO Constrói um NCCO (Nexmo Call Control Objects, objetos de controle de chamadas Nexmo) usado na ação Criar uma chamada de saída.
    Obter detalhes da chamada Recupera os detalhes da chamada especificada.
    Pesquisar chamadas Recupera os detalhes das chamadas especificadas.
    Reproduzir áudio na chamada Reproduz um arquivo de áudio em uma chamada ativa.
    Reproduzir texto para voz em uma chamada Reproduz texto para voz em uma chamada ativa.
    Parar de reproduzir áudio na chamada Interrompe a reprodução de um arquivo de áudio em uma chamada ativa.
    Parar texto para fala na chamada Interrompe 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 seus próprios números Recupera todos os números de entrada associados à conta Vonage.
    Gestão de SMS Enviar SMS Envia um SMS (Short Message Service) para um número de telefone.
    Gestãodo WhatsApp Enviar contatos Envia contatos para um número do WhatsApp.
    Enviar local Envia coordenadas geográficas de um local para um número do WhatsApp.
    Enviar mensagem de mídia Envia uma mensagem de mídia para um número do WhatsApp.
    Enviar mensagem de texto Envia uma mensagem de texto para um número do WhatsApp.
    Enviar mensagem de texto usando modelo Envia uma mensagem de texto usando o modelo para um número do WhatsApp.

    Módulo de 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 a instância ServiceNow. Essas condições são baseadas nos eventos em Vonage sobre os quais 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 as tarefas Vonage. Por padrão, a aplicação Vonage Spoke está disponível e tem os seguintes módulos:
    • Vonage Registros de webhook
    • Vonage Políticas de roteamento do WebHook
    Use o módulo Vonage Registros de Webhook para atribuir um token e fornecer o caminho da API. Você deve gerar uma URL de retorno de chamada aqui e fornecer essa URL em Vonage. As políticas de roteamento padrão são fornecidas como referência no módulo Vonage Políticas de roteamento do WebHook. Personalize essas políticas de roteamento de acordo com seus requisitos. A política de roteamento é compatível com estes campos:
    • Palavras-chave
    • Direção da chamada
    • Status da chamada
    • Tipo de evento
    • De
    • Status do SMS
    • Mensagem SMS
    • Para
    • do WhatsApp Status da mensagem
    • do WhatsApp Texto
    • Mostrar campos relacionados

    Requisitos de aliases de conexão e credencial

    Integration Hub 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 spoke Vonage :
    Vonage alias Descrição
    VonagePrimário Necessário para as ações que gerenciam SMS, número e conta.
    Vonage Necessário para as ações que gerenciam chamadas e do WhatsApp.

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