Subscrições de eventos

Além de lhe permitir realizar operações de leitura e escrita no seu back-end, os Integration Connectors também lhe permitem subscrever eventos que ocorrem nas suas aplicações de back-end. Por exemplo, considere que quer receber uma notificação quando é criado um novo pedido do Jira. Pode fazê-lo configurando o conetor do Jira Cloud para subscrições de eventos. Ao usar as subscrições de eventos juntamente com a integração de aplicações, pode criar integrações úteis para satisfazer as necessidades da sua empresa. Para mais informações, consulte o artigo Use subscrições de eventos nas suas integrações

Ative as subscrições de eventos nas associações

Uma associação que criar pode ser usada para qualquer um dos seguintes fins:

  • Apenas para realizar operações de conetores (entidades e ações)
  • Apenas para subscrições de eventos
  • Para realizar operações de conector e subscrições de eventos

A opção para ativar subscrições de eventos e configurar detalhes relacionados com eventos está disponível durante a criação da associação. No entanto, se já tiver uma associação existente e quiser reutilizá-la para a subscrição de eventos, pode fazê-lo editando e reconfigurando a associação.

Os seguintes conetores suportam subscrições de eventos:

Enriquecimento de dados nas notificações de eventos

Pode configurar uma associação para anexar informações adicionais numa resposta de notificação de evento. As informações adicionais são específicas da entidade para a qual configurou o evento. Para receber as informações adicionais, tem de ativar o Enriquecimento de dados na sua associação.

Por exemplo, se subscreveu um evento de criação de pedidos no Zendesk, recebe uma notificação quando um pedido é criado. No entanto, a carga útil da notificação de eventos consiste apenas nos detalhes básicos do bilhete. Detalhes adicionais, como a descrição do pedido, o responsável e o estado, não estão presentes na carga útil. Para obter estes detalhes adicionais da entidade ticket, tem de ativar o enriquecimento de dados numa associação do Zendesk. Para mais informações, consulte o artigo Configure a subscrição de eventos. Os exemplos seguintes mostram a carga útil da resposta sem e com o enriquecimento de dados.

Payload sem enriquecimento de dados

O exemplo seguinte mostra a carga útil de resposta do evento de criação de pedidos do Zendesk sem o 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 seguinte mostra a carga útil da resposta do evento de criação de pedidos do Zendesk com o 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"
        }
      }
    }
  }
 }

Conetividade privada para a subscrição de eventos

Para maior segurança, pode configurar a conetividade privada entre a sua aplicação de back-end e a sua ligação. Na conetividade privada, o ouvinte de eventos da sua ligação não é tornado público diretamente. Em alternativa, tem de permitir o tráfego de rede de entrada para o ouvinte de eventos através de uma associação de serviço do PSC que lhe será fornecida pelos Integration Connectors.

Durante a criação da ligação, se tiver selecionado a opção Ativar conetividade privada para a subscrição de eventos, o Integration Connectors cria uma associação de serviços do PSC. Tem de expor a associação de serviços da PSC à sua aplicação de back-end através de qualquer abordagem adequada. Uma abordagem possível é usar a associação de serviço do PSC num balanceador de carga e, em seguida, configurar o balanceador de carga para aceitar eventos da sua aplicação de back-end. Em seguida, a ligação escuta os eventos do seu back-end no endereço do equilibrador de carga. Os seguintes passos de nível elevado mostram como pode usar um balanceador de carga para configurar a conetividade privada:

  1. Aceda à página de detalhes da ligação criada recentemente.
  2. Clique em Editar ponto final de entrada. É apresentado o painel Definições de subscrição de eventos.
  3. Copie o nome do anexo de serviço, conforme apresentado no campo Nome do anexo de serviço do PSC.
  4. Crie um grupo de pontos finais de rede do PSC que aponte para a associação de serviço que obteve no passo anterior.
  5. Crie um balanceador de carga externo com o grupo de pontos finais de rede do PSC criado no passo anterior como back-end.
  6. Configure o balanceador de carga para aceitar pedidos do endereço IP do fornecedor de eventos (aplicação de back-end).

    Os passos subsequentes (7 a 11) são aplicáveis apenas em conetores cujo back-end suporta o registo automático da subscrição de eventos. Por exemplo, Zendesk e Jira.

  7. Aceda à página de detalhes da ligação criada recentemente.
  8. Clique em Editar ponto final de entrada. É apresentado o painel Definições de subscrição de eventos.
  9. Introduza o endereço do equilibrador de carga no campo Ponto final de entrada do ouvinte de eventos.
  10. Clique em Concluído.
  11. Clique em Guardar para guardar as alterações à associação.

Use subscrições de eventos nas suas integrações

Quando usa subscrições de eventos juntamente com as suas integrações, pode criar integrações para resolver os seus problemas empresariais complexos. Por exemplo, pode iniciar a execução de toda a integração com base num evento do ServiceNow. A integração de aplicações fornece os seguintes acionadores que ouvem notificações de eventos das suas aplicações de back-end:

Para configurar os acionadores, tem de ativar a subscrição de eventos para as suas associações. Pode ativar a subscrição de eventos numa ligação existente ou numa nova ligação. Para ver passos detalhados sobre como configurar estes acionadores da integração de aplicações, consulte a documentação de acionadores correspondente.

Ver subscrições ativas

Quando usa uma subscrição de eventos na integração da aplicação, os Integration Connectors criam uma entrada para a subscrição na ligação correspondente. Para ver todas as subscrições de uma associação, siga estes passos:

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

    Aceda à página Ligações

  2. Clique na associação para a qual quer ver as subscrições.

    É apresentada a página Detalhes da associação.

  3. Clique no separador Subscrições.

    Apresenta todas as subscrições da associação. Uma subscrição apresentada nesta página pode estar num dos seguintes estados:

    • A criar: a subscrição está a ser criada por uma integração.
    • Ativa: a subscrição é válida e está a funcionar.
    • Suspensa: a associação está num estado de suspensão.
    • Erro: a criação da subscrição não foi bem-sucedida. Por exemplo, falha de autenticação durante a criação da subscrição.

Preços da subscrição de eventos

Os dados (payload do evento) processados para subscrições de eventos nas pré-visualizações de acionadores não são cobrados. No entanto, é-lhe cobrado o processamento de dados de subscrição de eventos em acionadores geralmente disponíveis.