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 assinaturas de eventos nas conexões

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

  • Apenas para a realização de operações do conector (entidades e ações)
  • Apenas para assinaturas de eventos
  • Para realizar 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 oferecem suporte a assinaturas de eventos:

Enriquecimento 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 receber as informações adicionais, ative o enriquecimento de dados na conexão.

Por exemplo, se você tiver se inscrito em um evento de criação de tíquetes no Zendesk, poderá participar notificado quando um tíquete é 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 assinatura de eventos

Para aumentar a segurança, configure a conectividade particular entre o aplicativo de back-end e a conexão. Na conectividade particular, o listener de eventos de sua conexão não será tornado público 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 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 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. O painel Configurações de assinatura de eventos é mostrado.
  3. Copie o nome do anexo de serviço 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 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.

    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. O painel Configurações de assinatura de eventos é mostrado.
  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 as inscrições de eventos com suas integrações, você pode criar integrações para resolver problemas de negócios complexos. Por exemplo, é possível iniciar 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 conferir etapas detalhadas sobre como configurar esses gatilhos de integração de aplicativos, consulte a documentação correspondente.

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 para conferir as assinaturas.

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

  3. Clique na guia Assinaturas.

    Isso mostra 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.
    • Suspenso: a conexão está em um estado suspenso.
    • Erro: a criação da assinatura não foi bem-sucedida. 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.