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, imagine que você quer receber uma notificação quando um novo tíquete do Jira for criado. Para isso, configure 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 assinaturas de eventos nas suas integrações.

Observação:se você estiver configurando um perímetro de serviço do VPC para seu projeto do Google Cloud, ative a conexão privada para inscrições de eventos.

Ativar assinaturas de eventos nas conexões

Uma conexão criada pode ser usada para qualquer um dos seguintes fins:

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

• Apache Kafka
• HubSpot
• HL7
• IBM MQ
• Jira Cloud
• Rabbit MQ
• Gateway SAP
• ERP da SAP
• ServiceNow
• Solace (link em inglês)
• TIBCOEMS
• Webhook
• Zendesk

Enriquecimento 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 receber as informações adicionais, ative o Enriquecimento de dados na 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 da notificação de evento consiste apenas nos detalhes básicos do tíquete. Detalhes adicionais, como a descrição do tíquete, o atribuído e o status, não estão presentes no payload. Para conferir 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"
        }
      }
    }
  }
 }

Observação:

• Se você tiver ativado o enriquecimento de dados, o payload da resposta vai conter o campo context-data, além da resposta normal que você teria recebido sem o enriquecimento de dados. No exemplo anterior, o campo context-data contém mais detalhes do tíquete recém-criado no Zendesk.
• Somente o conector Zendesk oferece suporte ao enriquecimento de dados para notificações de eventos.

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 da sua conexão não é publicado diretamente. Em vez disso, é necessário permitir o tráfego de entrada de rede para o listener de eventos usando um anexo de serviço PSC fornecido pelos Integration Connectors.

Durante a criação de conexão, se você selecionou Ativar conectividade privada para a assinatura de eventos, os Integration Connectors criam 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 abordagem possível é usar o anexo de serviço do PSC em um balanceador de carga e, em seguida, configurar o balanceador 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 mostrado 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.
   Dica : se você já tiver um balanceador de carga externo, poderá usá-lo para configurar a conectividade particular em vez de criar um novo.
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. O painel Configurações de assinatura de eventos é mostrado.
9. Insira 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, é possível iniciar a execução de toda a integração com base em um evento do ServiceNow. Application Integration oferece os seguintes gatilhos que detectam notificações de eventos dos seus aplicativos de back-end:

• Gatilho HL7: ouve eventos HL7.
• Acionador do HubSpot: detecta eventos do HubSpot.
• Gatilho do IBM MQ: detecta eventos do IBM MQ.
• Acionador do Jira Cloud: detecta eventos do Jira Cloud.
• Gatilho do RabbitMQ: detecta eventos do RabbitMQ.
• ServiceNow trigger: ouve eventos do ServiceNow.
• Gatilho TIBCOEMS: detecta eventos TIBCOEMS.
• Gatilho de webhook: detecta eventos de webhook genéricos.
• Gatilho do Zendesk: detecta eventos do Zendesk.

Para configurar os gatilhos, ative a assinatura de eventos nas suas conexões. É possível ativar a assinatura de eventos em uma conexão existente ou em uma nova. Para conferir etapas detalhadas sobre como configurar esses gatilhos de Application Integration, consulte a documentação correspondente.

Ver assinaturas ativas

Quando você usa uma inscrição de evento na integração do aplicativo, os Integration Connectors criam uma entrada para a inscrição 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 mostra todas as assinaturas da conexão. Uma assinatura listada nesta página 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, falha de autenticação durante a criação da assinatura.

Observação:se uma conexão tiver assinaturas de eventos ativas, não será possível excluir a conexão nem editar o nome de host ou o endereço IP do back-end.

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.