Inscrições em eventos

Além de permitir que você execute operações de leitura e gravação no back-end, o Integration Connectors também permitem que você se inscreva em eventos que ocorrem nos seus aplicativos de back-end. Por exemplo, considere que você Você quer receber uma notificação quando um tíquete do Jira for criado. Você pode fazer isso configurando o conector do Jira Cloud para assinaturas de eventos. Ao usar as inscrições de eventos com a Application Integration, criar integrações úteis para atender às necessidades da sua empresa. Para mais informações, consulte Usar inscrições de eventos nas suas integrações

Ativar inscrições em eventos nas conexões

A conexão que você cria pode ser usada para qualquer uma das seguintes finalidades:

  • Apenas para a execução de operações do conector (entidades e ações)
  • Apenas para assinaturas de eventos
  • Para executar operações de conector e assinaturas de eventos

A opção de ativar assinaturas de eventos e configurar detalhes relacionados a eventos está disponível durante a criação da conexão. No entanto, se você já tiver uma conexão e quiser reutilizá-la para a inscrição em eventos, poderá fazer editando e reconfigurando a conexão.

Os seguintes conectores são compatíveis com assinaturas de eventos:

Aprimoramento de dados em notificações de eventos

Você pode configurar uma conexão para acrescentar informações adicionais em uma resposta de notificação de evento. As informações adicionais é específico da entidade para a qual você configurou o evento. Para mais informações, Ative o enriquecimento de dados na sua conexão.

Por exemplo, se você se inscreveu em um evento de criação de tíquetes no Zendesk, receberá notificado quando um tíquete for criado. No entanto, o payload de notificação de eventos consiste somente os detalhes básicos do ingresso. Outros detalhes, como descrição do tíquete, cessionário e status não estejam presentes no payload. Para obter esses detalhes adicionais do ticket, ative o aprimoramento de dados em uma conexão do Zendesk. Para mais informações, consulte Configurar a assinatura de eventos. O Os exemplos a seguir mostram o payload da resposta sem e com enriquecimento de dados.

Payload sem enriquecimento de dados

O exemplo a seguir mostra o payload de resposta do evento de criação de tíquete do Zendesk sem enriquecimento de dados.

{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }

Payload com enriquecimento de dados

O exemplo a seguir mostra o payload de resposta do evento de criação de tíquete do Zendesk com aprimoramento de dados.

{
    "context-data": {
    "AllowChannelback": false,
    "Assignee": null,
    "AssigneeId": 1.6696812051473E13,
    "Brand": null,
    "BrandId": 1.6696812163985E13,
    "Cc": null,
    "CollaboratorIds": null,
    "Commenter": null,
    "HasAttachment": null,
    "CreatedAt": "2023-07-08 11:37:19.0",
    "CustomFields": null,
    "Description": "Test desc 2",
....
....
    "Status": "open",
    "Subject": "Test Zendesk Ticket Created -2 -DA",
    "Submitter": null,
    "SubmitterId": 1.6696812051473E13,
    "Tags": "tag-changed-after-cache,ticket-created",
....
....
    "ViaChannel": "web",
    "ViaFollowupSourceId": null,
    "ViaSource": "{\r\n  \"from\": null,\r\n  \"to\": null,\r\n  \"rel\": null\r\n}",
    "View_Id": null
  },
   "data":{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }
 }

Conectividade particular para inscrições em eventos

Para reforçar a segurança, você pode configurar a conectividade particular entre seu aplicativo de back-end e sua conexão. Na conectividade particular, o listener de eventos de sua conexão não será tornado público diretamente. Em vez disso, você deve permitir a entrada de tráfego de rede no listener de eventos por meio de um anexo de serviço PSC que será fornecido a você pelos Integration Connectors.

Durante a criação da conexão, se você tiver selecionado Ativar a conectividade particular para a assinatura do evento, o Integration Connectors cria um anexo de serviço do PSC. Você precisa expor o anexo de serviço PSC ao aplicativo de back-end usando qualquer abordagem que seja adequada para você. Uma possível é usar o anexo de serviço PSC em um balanceador de carga e configurar balanceador de carga para aceitar eventos do aplicativo de back-end. Em seguida, a conexão detecta os eventos do back-end no endereço do balanceador de carga. As etapas avançadas a seguir mostram como usar um balanceador de carga para configurar a conectividade particular:

  1. Acesse a página de detalhes da conexão recém-criada.
  2. Clique em Editar endpoint de entrada. Isso mostra o painel Configurações de inscrição de eventos.
  3. Copie o nome do anexo de serviço conforme exibido no campo Nome do anexo de serviço do PSC.
  4. Criar um grupo de endpoints da rede PSC que aponte ao anexo de serviço que você recebeu na etapa anterior.
  5. Crie um balanceador de carga externo com a rede PSC. grupo de endpoints criado na etapa anterior como back-end.
  6. Configure o balanceador de carga para aceitar solicitações do endereço IP (aplicativo de back-end) do seu provedor de eventos.

    Os setps subsequentes (7 a 11) são aplicáveis apenas em conectores com back-end compatível registro automático de inscrição no evento. Por exemplo, Zendesk e Jira.

  7. Acesse a página de detalhes da conexão recém-criada.
  8. Clique em Editar endpoint de entrada. Isso mostra o painel Configurações de inscrição de eventos.
  9. Digite o endereço do balanceador de carga no campo Endpoint de entrada do listener de eventos.
  10. Clique em Concluído.
  11. Clique em Salvar para salvar as alterações da conexão.

Usar inscrições de eventos nas suas integrações

Ao usar assinaturas de eventos com suas integrações, você pode criar e integrações para solucionar problemas complexos de negócios. Por exemplo, você pode começar a execução de toda a integração com base em um evento do ServiceNow. A Application Integration fornece os seguintes gatilhos que detectar notificações de eventos dos aplicativos de back-end:

Para configurar os gatilhos, ative a assinatura de eventos para suas conexões. Você pode ativar a inscrição no evento uma conexão existente ou em uma nova conexão. Para ver etapas detalhadas de como para configurar esses gatilhos da Application Integration, consulte as documentação do gatilho.

Ver assinaturas ativas

Quando você usa uma assinatura de evento na integração do seu aplicativo, o Integration Connectors cria uma entrada para a assinatura na conexão correspondente. Para acessar todas as assinaturas para uma conexão, siga estas etapas:

  1. Abra a página "Todas as conexões" do seu projeto do Google Cloud.

    Acessar a página "Conexões"

  2. Clique na conexão que tem as assinaturas que você quer conferir.

    A página Detalhes da conexão será aberta.

  3. Clique na guia Assinaturas.

    Isso exibe todas as assinaturas da conexão. Uma assinatura listada neste pode estar em qualquer um dos seguintes estados:

    • Criando: a assinatura está sendo criada por uma integração.
    • Ativa: a assinatura é válida e está funcionando.
    • Suspensa: a conexão está em estado suspenso.
    • Erro: não foi possível criar a assinatura. Por exemplo, a autenticação durante a criação da assinatura.
.

Preços da assinatura de eventos

Os dados (payload de evento) processados para assinaturas de eventos nos acionadores de pré-visualização não são cobrados. No entanto, você vai receber uma cobrança por dados de inscrição de eventos processados em acionadores de disponibilidade geral.