Inscrições em eventos

Além de permitir que você execute operações de leitura e gravação no back-end, os Integration Connectors também permitem 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. Para isso, configure 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 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 da VPC para seu projeto do Google Cloud, ative a conectividade particular para assinaturas de eventos.

Ativar inscrições em eventos nas conexões

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

• Apenas para executar operações do conector (entidades e ações)
• Apenas para assinaturas de eventos
• Para executar operações do conector e assinaturas de eventos

A opção para ativar assinaturas de eventos e configurar detalhes relacionados a eventos estão disponíveis para você durante a criação da conexão. No entanto, se você já tem uma conexão e quer reaproveitá-la para inscrição em eventos, é possível fazer isso editando e reconfigurando a conexão.

Os seguintes conectores são compatíveis com assinaturas de eventos:

• Hubspot
• IBM MQ
• Jira
• MQ do coelho
• ServiceNow
• Webhook
• Zendesk

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 eventos. As outras informações são específicas da entidade para a qual você configurou o evento. Para receber outras informações, ative o enriquecimento de dados na conexão.

Por exemplo, se você se inscreveu para um evento de criação de ingressos no Zendesk, vai receber uma notificação quando um ingresso for criado. No entanto, o payload de notificação de eventos consiste apenas nos detalhes básicos do ingresso. Outros detalhes, como descrição do tíquete, responsável e status, não estão presentes no payload. Para receber esses detalhes extras 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 com o enriquecimento de dados e sem ele.

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 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 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 de resposta 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 detalhes adicionais do tíquete recém-criado no Zendesk.
• Somente o conector do Zendesk é compatível com o aprimoramento de dados para notificações de eventos.

Conectividade particular para inscrição em eventos

Para maior segurança, é possível 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 se torna público diretamente. Em vez disso, você precisa permitir o tráfego de rede de entrada para o listener de eventos usando um anexo de serviço PSC que será fornecido pelos Integration Connectors.

Durante a criação da conexão, se você tiver selecionado Ativar conectividade particular para a assinatura do evento, os Integration Connectors criarão um anexo de serviço do PSC. É necessário expor o anexo de serviço do 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 ouve 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 PSC.
4. Crie um grupo de endpoints de rede PSC apontando 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 o 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 seu provedor de eventos (aplicativo de back-end).

   As setps subsequentes (7 a 11) são aplicáveis apenas em conectores com back-end compatível com o 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 Save para salvar as mudanças na conexão.

Usar assinaturas de eventos nas suas integrações

Ao usar assinaturas de eventos com suas integrações, você pode 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 seus aplicativos de back-end:

• Gatilho do HubSpot: detecta eventos do HubSpot.
• Gatilho do IBM MQ: detecta eventos do IBM MQ.
• Gatilho do Cloud Jira: detecta eventos do Jira Cloud.
• Gatilho do MQ do Rabbit: detecta eventos do MQ do Rabbit.
• Gatilho do ServiceNow: detecta eventos do ServiceNow.
• Gatilho de webhook: detecta eventos genéricos de webhook.
• Gatilho do Zendesk: detecta eventos do Zendesk.

Para configurar os gatilhos, ative a assinatura de eventos para suas conexões. Você pode ativar a assinatura do evento em uma conexão atual ou em uma nova conexão. Para conferir as etapas detalhadas sobre como configurar esses acionadores da Application Integration, consulte a documentação correspondente.

Ver assinaturas ativas

Quando você usa uma assinatura de evento na integração do seu aplicativo, os Integration Connectors criam uma entrada para a assinatura na conexão correspondente. Para visualizar 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 exibir as assinaturas.

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

3. Clique na guia Assinaturas.

   Todas as inscrições da conexão serão exibidas. 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á no estado suspenso.
   • Erro: não foi possível criar a assinatura. 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 do host ou o endereço IP do back-end da conexão.

Preços da assinatura de eventos

Os dados (payload de evento) processados para assinaturas de eventos nos gatilhos de visualização não são cobrados. No entanto, você vai receber cobranças pelos dados de assinatura de eventos processados em acionadores com disponibilidade geral.