Configure o. Vonage spoke

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 6 min. de leitura

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

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o. Vonage spoke plug-in no ServiceNowinstâ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 o. Vonage instância do desenvolvedor. Seu ServiceNowa 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 Vonage conta de desenvolvedor.

    Procedimento

    1. Faça login no https://developer.vonage.com/en/home.
    2. Em Vonage Central do desenvolvedor, selecione Meu painel.Minha página do painel.
    3. Em Vonage Página do 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 a chave de API padrão e os valores 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 Crie um novo segredo .
      6. Na janela Adicionar um novo segredo, insira seu segredo personalizado.
      7. Selecione 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 o. ServiceNowinstância para se conectar ao Vonage e automatizar várias ações no Vonage instância. Por exemplo, crie um fluxo em Workflow Studioque recebe seu Vonage saldo da conta.

    Antes de Iniciar

    Função necessária: administrador
    Nota:
    Certifique-se de estar em Vonage spoke 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 O URL para se conectar à API do Vonage.
      Versão da API de mensagens A versão das APIs que o registro de conexão solicita para usar 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 para usar o recurso 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 de nome da conta na instância do Vonage.
      Chave de API Chave de API adquirida na instância do desenvolvedor Vonage.
      Segredo da 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 o. ServiceNowinstância para se conectar ao Vonage e automatizar várias ações no Vonage instância. Por exemplo, crie um fluxo em Workflow Studioque recebe seu Vonage saldo da conta.

    Antes de Iniciar

    Função necessária: administrador
    Nota:
    Certifique-se de estar em Vonage spoke 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 O URL para se conectar à API do Vonage. Insira https://rest.nexmo.com.
      Chave de API Chave de API adquirida na instância do desenvolvedor Vonage.
      Segredo da API Segredo de API adquirido na instância do desenvolvedor Vonage.
    7. Selecione Criar conexão.

    Crie um webhook para receber dados da Vonage

    Configure webhooks para SMS para habilitar a plataforma da 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 > Vonage spoke > Registros do webhook do Vonage.
    2. Selecione Novo.
    3. No formulário, preencha os seguintes campos.
      Tabela 3. Formulário de 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 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 de 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 cabeçalho Mensagens, insira o URL de 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 cabeçalho Configurações de SMS, certifique-se de que você selecionou API DE 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 foram salvas.

    Personalize webhooks e políticas de roteamento

    Personalize a política de roteamento do webhook e o subfluxo de acordo com sua necessidade.

    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 sua necessidade e publique-o.
      Consulte Criando subfluxos para obter mais informações sobre como criar e usar subfluxos e. Vonage spokepara 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 . O compatível Vonage os campos são:
      • Palavras-chave
      • Direção da chamada
      • Status da chamada
      • Tipo de evento
      • De
      • Status do SMS
      • Mensagem SMS
      • à(s)
      • 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.