Inscrições em eventos

Além de permitir a execução de operações de leitura e gravação no back-end, os Integration Connectors também permitem a inscrição em eventos que ocorrem nos 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. Usando as inscrições de eventos com a Application Integration, você pode 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 assinaturas de eventos nas conexões

Uma conexão criada pode ser usada para os seguintes fins:

  • Apenas para a realização de operações do conector (entidades e ações)
  • Somente 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 de conexão. No entanto, se você já tiver uma conexão e quiser usá-la para a assinatura de eventos, faça isso 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

É possível configurar uma conexão para anexar mais informações em uma resposta de notificação de evento. As informações adicionais são específicas para a entidade em que você configurou o evento. Para mais informações, Ative o enriquecimento de dados na sua conexão.

Por exemplo, se você se inscreveu para um evento de criação de tíquete no Zendesk, vai receber uma notificação quando um tíquete for criado. No entanto, o payload de notificação de eventos consiste apenas 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 receber esses detalhes adicionais da entidade ticket, ative o enriquecimento de dados em uma conexão do Zendesk. Para mais informações, consulte Configurar a assinatura de eventos. Os exemplos a seguir mostram o payload de resposta sem e com o 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 enriquecimento 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 da sua conexão não é publicado diretamente. Em vez disso, você precisa 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 de conexão, se você tiver selecionado Ativar conectividade privada para a assinatura de eventos, os Integration Connectors vão criar um anexo de serviço do PSC. É necessário expor o anexo de serviço do PSC ao seu aplicativo de back-end usando qualquer abordagem adequada. 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 de alto nível 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. Crie um grupo de endpoints de rede do PSC que aponte para o anexo de serviço recebido na etapa anterior.
  5. Crie um balanceador de carga externo com o grupo de endpoints de rede PSC criado na etapa anterior como back-end.
  6. Configure o balanceador de carga para aceitar solicitações do endereço IP do provedor de eventos (aplicativo de back-end).

    As etapas subsequentes (7 a 11) são aplicáveis apenas em conectores cujo back-end oferece suporte ao registro automático da assinatura de eventos. 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 mudanças na conexão.

Usar assinaturas de eventos nas integrações

Ao usar as inscrições de eventos com suas integrações, você pode criar integrações para resolver problemas de negócios complexos. Por exemplo, você pode começar a execução de toda a integração com base em um evento do ServiceNow. A integração de aplicativos oferece os seguintes gatilhos que detectam notificações de eventos dos seus 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 conferir todas as assinaturas de 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 em que você quer ver as assinaturas.

    A página Detalhes da conexão é 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:

    • Criação: 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 do evento) processados para assinaturas de eventos nos acionadores de visualização não são cobrados. No entanto, você vai receber cobranças pelos dados de assinatura de eventos processados em gatilhos disponíveis para todos.