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 permite que você se inscreva em eventos que ocorrem nos seus aplicativos de back-end. Por exemplo, considere que você quer receber uma notificação quando um novo tíquete do Jira for criado. É possível fazer isso configurando o conector do Jira Cloud para assinaturas de eventos. Ao usar as assinaturas de eventos com a Application Integration, você pode criar integrações úteis para atender às suas necessidades de negócios. Para mais informações, consulte Usar assinaturas 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á tem uma conexão e quer reutilizá-la para a inscrição de eventos, edite e reconfigure a conexão para fazer isso.

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 anexar mais informações em uma resposta de notificação de eventos. As informações adicionais são específicas da entidade para a qual você configurou o evento. Para mais informações, ative o Aprimoramento de dados na sua conexão.

Por exemplo, se você tiver se inscrito para um evento de criação de tíquete no Zendesk, receberá uma notificação quando um tíquete for criado. No entanto, o payload da notificação de eventos consiste apenas nos detalhes básicos do ingresso. Outros detalhes, como descrição do tíquete, cessionário e status, não estão presentes no payload. Para conferir esses outros detalhes da entidade ticket, ative o aprimoramento de dados em uma conexão do Zendesk. Para mais informações, consulte Configurar assinatura de eventos. Os exemplos a seguir mostram o payload de 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, é necessário permitir o tráfego de rede de entrada para o listener de eventos por meio de um anexo de serviço PSC que será fornecido 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 criará um anexo de serviço PSC. Exponha o anexo de serviço PSC ao aplicativo de back-end usando qualquer abordagem adequada para você. Uma abordagem possível é usar o anexo de serviço PSC em um balanceador de carga e configurá-lo 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. Crie um grupo de endpoints de rede PSC que aponte para o anexo de serviço que você recebeu 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 (aplicativo de back-end) do seu provedor de eventos.

    Os setps subsequentes (7 a 11) são aplicáveis somente em conectores com back-end que seja compatível com o registro automático de inscrições 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 alterações da conexão.

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

Ao usar assinaturas de eventos com suas integrações, é possível criar integrações para resolver problemas complexos de negócios. Por exemplo, é possível iniciar a execução de toda a integração com base em um evento do ServiceNow. A Application Integration fornece os seguintes gatilhos que detectam 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 em uma conexão existente ou em uma nova conexão. Para ver etapas detalhadas de como configurar esses gatilhos do Application Integration, consulte a documentação de gatilhos correspondente.

Ver assinaturas ativas

Quando você usa uma assinatura de evento na integração de aplicativos, 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 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 nesta página 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, falha de 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 assinatura de eventos processados em acionadores de disponibilidade geral.