Configure o. Spoke do Vonage

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

    • Integre seu ServiceNow instância com Vonage instância para habilitar a comunicação entre eles. Com esta integração, seu ServiceNow a instância pode automatizar ações no Vonage instância, enquanto Vonage a instância pode enviar cargas úteis para seu ServiceNow instância.

    Antes de Iniciar

    • Solicitar uma assinatura de IntegrationHub.
    • Ative o. Spoke do Vonage plug-in em seu ServiceNow instância.
    • Função necessária: administrador
    • Conta da instância do desenvolvedor do Vonage.

    Configure a instância do desenvolvedor do Vonage

    Gere credenciais essenciais, como chaves de API, segredos e segredos de assinatura, para configurar seu Vonage instância do desenvolvedor. . ServiceNow a instância usa essas credenciais no registro de conexão para se conectar ao Vonage instância do desenvolvedor.

    Antes de Iniciar

    Função necessária: administrador

    Acesso a um Vonage conta de desenvolvedor.

    Procedimento

    1. Faça login no https://developer.vonage.com/en/home.
    2. Em Vonage Página Central do desenvolvedor, selecione Meu painel.Página Meu painel.
    3. Em Vonage Página Painel de API, use a chave de API padrão e o segredo de API ou crie sua chave de API personalizada e o segredo de API.
      1. Para usar a chave de API padrão e o segredo de API, copie os valores da chave de API padrão e do segredo de API.Botão Copiar para chave de API e segredo de API.
      2. Para gerar uma chave de API personalizada e um segredo de API, no painel esquerdo, selecione Configurações de API.Link de configurações de API.
      3. Selecione Solicite mais chaves de API .
      4. Preencha e envie o formulário.
      5. Selecione Criar novo segredo .
      6. Na janela Adicionar um novo segredo, insira seu segredo personalizado.
      7. Selecione Save (Salvar).
    4. No campo Segredo da assinatura, copie o segredo da assinatura.

    Configure o registro de conexão para o alias de conexão e credencial do Vonage

    Configure um registro de conexão que habilite seu ServiceNow instância para se conectar ao Vonage e automatizar várias ações no Vonage instância. Por exemplo, crie um fluxo em Workflow Studio que recebe o seu Vonage saldo da conta.

    Antes de Iniciar

    Função necessária: administrador
    Nota:
    Certifique-se de estar em Spoke do Vonage escopo.

    Procedimento

    1. Navegar até Tudo > Automação de Processo > Flow Designer.
    2. Selecione Conexões.
    3. No campo Pesquisar todas as conexões, insira Vonage .Campo Pesquisar todas as conexões.
    4. No cartão Vonage, selecione Exibir detalhes .
    5. Selecione Configurar.
    6. Preencha o formulário.
      Tabela 1. Criar Conexão
      Campo Descrição
      Nome da Conexão O nome padrão e somente leitura do registro de conexão. Para fornecer um nome personalizado para o registro de conexão, crie um registro de conexão selecionando Adicionar conexão .
      URL de conexão A URL para se conectar à API Vonage.
      Versão da API de mensagens A versão das APIs que o registro de conexão solicita usando o recurso SMS na instância do Vonage.
      Versão da API de voz A versão das APIs que o registro de conexão solicita usando o recurso de voz na instância do Vonage.
      Nome da Credencial Nome do registro da credencial. O nome padrão da credencial do Vonage que você pode atualizar.
      Nome da aplicação Nome da conta que você inseriu na página Configurações da conta de desenvolvedores do Vonage.Campo Nome da conta na instância do Vonage.
      Chave de API Chave de API que você adquiriu na instância do desenvolvedor Vonage.
      Segredo de API Segredo de API adquirido na instância do desenvolvedor Vonage.
      Segredo da assinatura Chave secreta de assinatura que você adquiriu na instância do desenvolvedor Vonage.
    7. Selecione Criar conexão.

    Configure o registro de conexão para o alias primário do Vonage

    Configure um registro de conexão que habilite seu ServiceNow instância para se conectar ao Vonage e automatizar várias ações no Vonage instância. Por exemplo, crie um fluxo em Workflow Studio que recebe o seu Vonage saldo da conta.

    Antes de Iniciar

    Função necessária: administrador
    Nota:
    Certifique-se de estar em Spoke do Vonage escopo.

    Procedimento

    1. Navegar até Tudo > Automação de Processo > Flow Designer.
    2. Selecione Conexões.
    3. No campo Pesquisar todas as conexões, insira Vonage .Campo Pesquisar todas as conexões.
    4. No cartão VonagePrimary, selecione Exibir detalhes .
    5. Selecione Configurar.
    6. Preencha o formulário.
      Tabela 2. Criar Conexão
      Campo Descrição
      Nome da Conexão O nome padrão e somente leitura do registro de conexão. Para fornecer um nome personalizado para o registro de conexão, crie um registro de conexão selecionando Adicionar conexão .
      URL de conexão A URL para se conectar à API Vonage. Insira https://rest.nexmo.com.
      Chave de API Chave de API que você adquiriu na instância do desenvolvedor Vonage.
      Segredo de API Segredo de API adquirido na instância do desenvolvedor Vonage.
    7. Selecione Criar conexão.

    Crie um webhook para receber dados do Vonage

    Configure webhooks para SMS para habilitar a plataforma de API Vonage para enviar dados para sua instância da ServiceNow. Por exemplo, se um fluxo em sua instância da ServiceNow enviar uma solicitação de API para detalhes de chamada para a API Vonage, mas a solicitação falhar inicialmente, o webhook garantirá que a API Vonage envie os dados posteriormente.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Spoke do Vonage > Registros do webhook do Vonage.
    2. Selecione Novo.
    3. No formulário, preencha os seguintes campos.
      Tabela 3. Formulário Registro do webhook do Vonage
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro do webhook.
      Descrição Descrição do registro do webhook.
      Tipo de evento Tipo de evento para o qual o webhook está configurado. Selecione SMS .
      Chave Secreta Chave secreta para autenticar as solicitações do webhook. Insira sua chave secreta personalizada.
    4. Clique com o botão direito no cabeçalho do formulário e selecione Salvar.
    5. Selecione o URL de retorno de chamada.
      O sistema exibe o URL de retorno de chamada do webhook.
    6. Copie e registre o URL de retorno de chamada do webhook.
    7. Faça login no https://developer.vonage.com/en/home.
    8. No painel esquerdo, em Criar e gerenciar, selecione Aplicações.Link Aplicações em Criar e gerenciar.
    9. Na página Suas aplicações, selecione o ícone de menu ( Ícone de menu.) para sua aplicação.Minha aplicação.
    10. Selecione Editar.
    11. No título Mensagens, insira o URL do retorno de chamada nos campos URL de entrada e URL de status.Configurações de mensagens.
    12. No painel esquerdo, selecione Configurações de API.
    13. Na página Configurações, no título Configurações de SMS, verifique se você selecionou API SMS .
    14. Preencha os valores.
      Campo Valor
      Webhooks de recibos de entrega (DLR) URL de retorno de chamada do webhook
      Webhooks de SMS de entrada URL de retorno de chamada do webhook
    15. Selecione Salvar mudanças.
      As configurações de SMS da aplicação são salvas.

    Personalize webhooks e políticas de roteamento

    Personalize a política e o subfluxo de roteamento do webhook de acordo com seu requisito.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Flow Designer > Designer.
    2. Clique em Subfluxos .
    3. Crie uma cópia do subfluxo padrão necessário.
    4. Personalize o subfluxo de acordo com seu requisito e publique-o.
      Consulte Criando subfluxos para obter mais informações sobre como criar e usar subfluxos e. Vonage Spoke para obter informações sobre os campos compatíveis com a política de roteamento padrão e os subfluxos.
    5. Navegar até Vonage Spoke > Política de roteamento do webhook do Vonage.
    6. Clique em Nova.
    7. No formulário, preencha os campos.
      Tabela 4. Formulário de decisão
      Campo Descrição
      Rótulo Rótulo exclusivo para identificar a política de roteamento.
      Resposta padrão Opção para especificar se esta é a resposta padrão. A resposta padrão é aplicável quando as condições não são atendidas.
      1. Clique no ícone de pesquisa ( ícone de pesquisa).
      2. Selecione o subfluxo necessário na lista Documentos.
        Nota:
        Certifique-se de que Nome da tabela . Fluxo [sys_hub_flow] .
      Condição Condições a serem atendidas quando os eventos necessários ocorrem em Vonage . Compatíveis Vonage os campos são:
      • 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
      Resposta Subfluxo que deve ser acionado quando as condições especificadas são atendidas.
    8. Clique em Enviar.
      Nota:
      Essas políticas de roteamento são salvas nas tabelas de decisão. Os usuários são advertidos contra atualizar ou modificar diretamente os dados nessas tabelas.