Consulte os conectores compatíveis com a Application Integration.

Gatilho do Zendesk

O gatilho do Zendesk é um acionador de evento do conector que permite invocar uma integração com base nos eventos do Zendesk que você se inscreveu na conexão do Zendesk.

Antes de começar

Se você planeja criar ou configurar uma nova conexão para o gatilho Zendesk, verifique se tem o seguinte papel do IAM no projeto:

  • Administrador de conectores (roles/connectors.admin)
  • Para informações sobre como conceder papéis, consulte Gerenciar acesso.

Conceda os seguintes papéis do IAM à conta de serviço que você quer usar para o gatilho do Zendesk:

  • Invocador do Application Integration (roles/integrations.integrationInvoker)
  • Para informações sobre como conceder papéis a uma conta de serviço, consulte Gerenciar o acesso a contas de serviço.

Adicionar o gatilho do Zendesk

Para adicionar um acionador do Zendesk à integração, siga estas etapas:

  1. No console do Google Cloud, acesse a página Application Integration.

    Acessar o Application Integration

  2. No menu de navegação, clique em Integrações.

    A página Lista de integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

  3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

    Se você estiver criando uma integração:

    1. Digite um nome e uma descrição no painel Create Integration.
    2. Selecione uma região para a integração.
    3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas.
    4. Clique em Criar.

    Isso abre a integração na página do editor de integração.

  4. Na barra de navegação do editor de integração, clique em Gatilhos para conferir a lista de gatilhos disponíveis.
  5. Clique e coloque o elemento gatilho do Zendesk no editor de integração.
  6. Para configurar o gatilho do Zendesk, você pode usar uma conexão existente do Zendesk disponível nos Integration Connectors ou criar uma nova conexão do Zendesk usando a opção de criação de conexão in-line.

Configurar o gatilho do Zendesk usando uma conexão atual

É possível configurar o acionador do Zendesk usando uma conexão do Zendesk nos Integration Connectors. O gatilho do Zendesk é um acionador de evento do conector, portanto, só é possível usar uma conexão do Zendesk com a assinatura de evento ativada para configurar o acionador.

Saiba como configurar um gatilho do Zendesk usando uma nova conexão do Zendesk em Configurar o gatilho do Zendesk usando uma nova conexão.

Para configurar um acionador do Zendesk usando uma conexão atual do Zendesk, siga estas etapas:

  1. Clique no elemento Acionador do Zendesk no editor de integração para abrir o painel de configuração do acionador.
  2. Clique em Configurar gatilho.
  3. Forneça os seguintes detalhes de configuração na página Editor do gatilho de evento do conector:
    1. Região:selecione a região da sua conexão do Zendesk.
    2. Conexão:selecione a conexão do Zendesk que você quer usar.

      A Application Integration exibe apenas as conexões do Zendesk que estão ativas e com uma assinatura de eventos ativada.

    3. Tipo de assinatura de evento:selecione o tipo de assinatura de evento que aciona a integração. Para mais informações sobre os tipos de assinatura de evento compatíveis com esse acionador, consulte Tipos de assinatura de evento compatíveis.
    4. Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para o gatilho do Zendesk.
  4. Clique em Concluído para finalizar a configuração do acionador e fechar a página.

Configurar o gatilho do Zendesk usando uma nova conexão

Para configurar o acionador do Zendesk usando uma nova conexão do Zendesk, siga estas etapas:

  1. Clique no elemento Acionador do Zendesk no editor de integração para abrir o painel de configuração do acionador.
  2. Clique em Configurar gatilho.
  3. Ignore o campo Região.
  4. Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
  5. Siga estas etapas no painel Criar conexão:
    1. Na etapa Local, escolha o local da nova conexão do Zendesk:
      1. Região:selecione uma região na lista suspensa.
      2. Clique em Próxima.
    2. Na etapa Connection Details, informe detalhes sobre a nova conexão do Zendesk:
      1. Versão do conector:escolha uma versão disponível do conector do Zendesk na lista suspensa.
      2. Connection Name:digite um nome para a conexão do Zendesk.
      3. (Opcional) Descrição : insira uma descrição para a conexão.
      4. (Opcional) Ativar o Cloud Logging:marque essa caixa de seleção para armazenar todos os dados de registro da conexão.
      5. Service Account: selecione uma conta de serviço com os papéis do IAM necessários para a conexão do Zendesk.
      6. Ativar assinatura de eventos:selecione para criar e ativar uma nova assinatura de eventos para a conexão do Zendesk. É possível ativar apenas assinaturas de eventos ou incluir entidades, operações e ações de conexão.
      7. (Opcional) Expanda Configurações avançadas para definir as configurações do nó de conexão.

        Para mais informações sobre as configurações do nó de conexão do Zendesk, consulte a documentação Conexão do Zendesk.

      8. (Opcional) Clique em + Adicionar rótulo para incluir um rótulo à conexão na forma de um par de chave-valor.
      9. Clique em Próxima.
    3. Na etapa Destinations, informe os detalhes da instância do Zendesk:
      1. Destination Type:selecione Host address.
      2. Host:digite o nome do host ou o endereço IP da instância do Zendesk.
      3. Clique em Próxima.
    4. Na etapa Autenticação, forneça os detalhes de autenticação da instância do Zendesk:
      1. Selecione o tipo de autenticação desejado e insira os detalhes relevantes para acessar o URL do host do Zendesk fornecido.

        Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

      2. Clique em Próxima.
    5. Na etapa Event subscription details, forneça detalhes da instância do Zendesk em que as inscrições do evento serão criadas.
      1. Destination Type:selecione Host address.
      2. Host:insira o URL de registro da instância do Zendesk. As inscrições em eventos serão criadas para este URL.
      3. Nome de usuário:digite o nome de usuário para acessar o URL de registro fornecido.
      4. Password:selecione o secret do Secret Manager que contém a senha associada ao nome de usuário.
      5. Versão do secret:selecione uma versão do secret.
      6. Ativar o aprimoramento de dados:marque essa caixa de seleção se você quiser que o gatilho do Zendesk recupere o payload do evento completo da instância do Zendesk. Consulte Saída do acionador para exemplos.
      7. Clique em Próxima.
    6. Revisão: verifique os detalhes da conexão do Zendesk fornecidos.
    7. Clique em Criar para concluir a criação de uma nova conexão do Zendesk.
  6. Tipo de assinatura de evento:selecione o tipo de assinatura de evento que aciona a integração. Para mais informações sobre os tipos de assinatura de evento compatíveis com esse acionador, consulte Tipos de assinatura de evento compatíveis.
  7. Clique em Concluído e feche a página.

Saída do gatilho

O acionador do Zendesk leva alguns minutos para concluir a configuração da assinatura do evento. É possível ver o status da sua assinatura de eventos no painel de configuração do acionador, em Detalhes da inscrição de eventos.

O acionador do Zendesk indica o status de uma assinatura de evento usando os seguintes estados:

  • Creating: indica que o acionador está assinando a assinatura do evento.
  • Active: indica que o acionador foi inscrito em uma assinatura de evento.
  • Error: indica que há um problema com a inscrição de eventos configurada.

Além do status da inscrição no evento, a seção Detalhes da inscrição no evento também exibe outras informações, como região da conexão, nome da conexão, nome da inscrição do evento e muito mais.

A imagem a seguir mostra um exemplo de layout do painel de configuração do gatilho do Zendesk:

imagem mostrando o painel de configuração do gatilho do Zendesk imagem mostrando o painel de configuração do gatilho do Zendesk

Variável de saída do acionador

Para cada evento, o gatilho Zendesk gera uma variável de saída ConnectorEventPayload que pode ser usada nas tarefas downstream. A variável de saída está no formato JSON, que contém o esquema de payload de saída do Zendesk.

Exemplo 1: payload de saída do evento Zendesk: Agent Assignment Changed

  {
    "description": "The root schema of event that has occurred in Zendesk.",
    "type": "object",
    "properties": {
        "data": {
    "description": "",
    "type": "object",
    "properties": {
        "accountId": {
            "description": "Zendesk account ID.",
            "type": "number",
            "readOnly": false
        },
        "integration_key": {
            "description": "Integration Key retrieved from ZIS bundle.",
            "type":  "string",
            "readOnly": false
        },
        "subdomain": {
            "description": "Account subdomain.",
            "type":  "string",
            "readOnly": false
        },
        "input": {
            "description": "Contains information about events changes.",
            "type": "object",
            "properties": {
                "ticket_event": {
                    "description": "Type of event is ticket event.",
                    "type": "object",
                    "properties": {
                        "meta": {
                            "description": "Metadata about the ticket.",
                            "type": "object",
                            "properties": {
                                "version": {
                                    "description": "Event version",
                                    "type":  ["string", "null"]
                                },
                                "occurred_at": {
                                    "description": "Timestamp when the event occurred.",
                                    "type":  "string"
                                },
                                "ref": {
                                    "description": "Reference ID",
                                    "type":  ["string", "null"]
                                },
                                "sequence": {
                                    "description": "Sequence of Occurrence",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "description": "",
                                            "type":  ["string", "null"]
                                        },
                                        "position": {
                                            "description": "",
                                            "type": ["number","null"]
                                        },
                                        "total": {
                                            "description": "",
                                            "type": ["number","null"]
                                        }
                                    }
                                }
                            }
                        },
                        "type": {
                            "description": "Type of Ticket Event ",
                            "type":  "string"
                        },
                        "previous": {
                            "description": "Previous ID",
                            "type": ["number","null"]
                        },
                        "current": {
                            "description": "Current ID",
                            "type": ["number","null"]
                        },
                        "ticket": {
                            "description": "Properties related to the ticket",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "description": "Ticket ID",
                                    "type": "number"
                                },
                                "created_at": {
                                    "description": "Timestamp of ticket creation.",
                                    "type":  "string"
                                },
                                "updated_at": {
                                    "description": "Timestamp of ticket updation.",
                                    "type":  "string"
                                },
                                "type": {
                                    "description": "Type of ticket",
                                    "type":  ["string", "null"]
                                },
                                "priority": {
                                    "description": "Priority of ticket.",
                                    "type":  ["string", "null"]
                                },
                                "status": {
                                    "description": "Status of the ticket.",
                                    "type":  ["string", "null"]
                                },
                                "requester_id": {
                                    "description": "ID of the ticket requestor.",
                                    "type": ["number","null"]
                                },
                                "submitter_id": {
                                    "description": "ID of the ticket submitter.",
                                    "type": ["number","null"]
                                },
                                "assignee_id": {
                                    "description": "ID of the ticket assignee.",
                                    "type": ["number","null"]
                                },
                                "organization_id": {
                                    "description": "ID of the organization ticket belongs to.",
                                    "type": ["number","null"]
                                },
                                "group_id": {
                                    "description": "ID of the group ticket belongs to.",
                                    "type": ["number","null"]
                                },
                                "brand_id": {
                                    "description": "ID of the brand ticket belongs to",
                                    "type": ["number","null"]
                                },
                                "form_id": {
                                    "description": "ID of the form associated with the ticket.",
                                    "type": ["number","null"]
                                },
                                "external_id": {
                                    "description": "",
                                    "type":  ["string", "null"]
                                },
                                "tags": {
                                    "description": "Tags associated with the ticket.",
                                    "type": "array",
                                    "items": {
                                        "description": "",
                                        "type":  ["string", "null"]
                                    }
                                },
                                "via": {
                                    "description": "Channel via which change was made.",
                                    "type": "object",
                                    "properties": {
                                        "channel": {
                                            "description": "",
                                            "type":  "string"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "readOnly": false
        }
    }
}
}
}

Exemplo 2: payload de saída com aprimoramento de dados para o evento Zendesk Agent Assignment Changed

    {
      "description": "The root schema of event that has occurred in Zendesk.",
      "type": "object",
      "properties": {
        "data": {
          "description": "",
          "type": "object",
          "properties": {
            "accountId": {
              "description": "Zendesk account ID.",
              "type": "number",
              "readOnly": false
            },
            "integration_key": {
              "description": "Integration Key retrieved from ZIS bundle.",
              "type": "string",
              "readOnly": false
            },
            "subdomain": {
              "description": "Account subdomain.",
              "type": "string",
              "readOnly": false
            },
            "input": {
              "description": "Contains information about events changes.",
              "type": "object",
              "properties": {
                "ticket_event": {
                  "description": "Type of event is ticket event.",
                  "type": "object",
                  "properties": {
                    "meta": {
                      "description": "Metadata about the ticket.",
                      "type": "object",
                      "properties": {
                        "version": {
                          "description": "Event version",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "occurred_at": {
                          "description": "Timestamp when the event occurred.",
                          "type": "string"
                        },
                        "ref": {
                          "description": "Reference ID",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "sequence": {
                          "description": "Sequence of Occurrence",
                          "type": "object",
                          "properties": {
                            "id": {
                              "description": "",
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "position": {
                              "description": "",
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "total": {
                              "description": "",
                              "type": [
                                "number",
                                "null"
                              ]
                            }
                          }
                        }
                      }
                    },
                    "type": {
                      "description": "Type of Ticket Event ",
                      "type": "string"
                    },
                    "previous": {
                      "description": "Previous ID",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "current": {
                      "description": "Current ID",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "ticket": {
                      "description": "Properties related to the ticket",
                      "type": "object",
                      "properties": {
                        "id": {
                          "description": "Ticket ID",
                          "type": "number"
                        },
                        "created_at": {
                          "description": "Timestamp of ticket creation.",
                          "type": "string"
                        },
                        "updated_at": {
                          "description": "Timestamp of ticket updation.",
                          "type": "string"
                        },
                        "type": {
                          "description": "Type of ticket",
                          "type": "string"
                        },
                        "priority": {
                          "description": "Priority of ticket.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "status": {
                          "description": "Status of the ticket.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "requester_id": {
                          "description": "ID of the ticket requestor.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "submitter_id": {
                          "description": "ID of the ticket submitter.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "assignee_id": {
                          "description": "ID of the ticket assignee.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "organization_id": {
                          "description": "ID of the organization ticket belongs to.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "group_id": {
                          "description": "ID of the group ticket belongs to.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "brand_id": {
                          "description": "ID of the brand ticket belongs to",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "form_id": {
                          "description": "ID of the form associated with the ticket.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "external_id": {
                          "description": "",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "tags": {
                          "description": "Tags associated with the ticket.",
                          "type": "array",
                          "items": {
                            "description": "",
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "via": {
                          "description": "Channel via which change was made.",
                          "type": "object",
                          "properties": {
                            "channel": {
                              "description": "",
                              "type": "string"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              },
              "readOnly": false
            }
          }
        },
"context-data": {
          "description": "",
          "type": "object",
          "properties": {
            "Id": {
              "type": "number",
              "readOnly": false,
              "description": "Automatically assigned when the ticket is created."
            },
            "Subject": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The value of the subject field for this ticket. When used in WHERE clause: The text in the ticket subject"
            },
            "RawSubject": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The dynamic content placeholder, if present, or the subject value, if not."
            },
            "Description": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The first comment on the ticket. When used in WHERE clause: The text in the tickets description and comments"
            },
            "Type": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The type of this ticket. Possible values: problem, incident, question or task."
            },
            "Priority": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The urgency with which the ticket should be addressed. Possible values: urgent, high, normal, low."
            },
            "Status": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The state of the ticket. Possible values: new, open, pending, hold, solved, closed."
            },
            "Recipient": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The original recipient e-mail address of the ticket."
            },
            "HasIncidents": {
              "type": [
                "boolean",
                "null"
              ],
              "readOnly": false,
              "description": "Is true of this ticket has been marked as a problem, false otherwise."
            },
            "DueAt": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "If this is a ticket of type task it has a due date. Due date format uses ISO 8601 format."
            },
            "RequesterId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The user who requested this ticket."
            },
            "SubmitterId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The user who submitted the ticket. The submitter always becomes the author of the first comment on the ticket. "
            },
            "AssigneeId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The agent currently assigned to the ticket."
            },
            "OrganizationId": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The organization of the requester. You can only specify the ID of an organization associated with the requester."
            },
            "GroupId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The group this ticket is assigned to. When used in WHERE clause: The assigned agents group name."
            },
            "CollaboratorIds": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The ids of users currently cc-ed on the ticket."
            },
            "FollowerIds": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "Agents currently following the ticket."
            },
            "ForumTopicId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The topic this ticket originated from, if any."
            },
            "ProblemId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "For tickets of type incident, the ID of the problem the incident is linked to."
            },
            "ExternalId": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "An id you can use to link Zendesk Support tickets to local records."
            },
            "FollowupIds": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "Closed tickets only. The ids of the followups created from this ticket."
            },
            "ViaFollowupSourceId": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "POST requests only. The id of a closed ticket when creating a follow-up ticket.."
            },
            "MacroIds": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "POST requests only. List of macro IDs to be recorded in the ticket audit."
            },
            "TicketFormId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "Enterprise only. The id of the ticket form to render for the ticket."
            },
            "BrandId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "Enterprise only. The id of the brand this ticket is associated with."
            },
            "Tags": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The array of tags applied to this ticket."
            },
            "ViaChannel": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "This tells you how the ticket or event was created. Examples: web, mobile, rule, system."
            },
            "ViaSource": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The tickets source. "
            },
            "CustomFields": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "Custom fields for the ticket.The values of custom field are set and get dynamically"
            },
            "SatisfactionRating": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The satisfaction rating of the ticket, if it exists, or the state of satisfaction, offered or unoffered."
            },
            "SharingAgreementIds": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The ids of the sharing agreements used for this ticket."
            },
            "AllowChannelback": {
              "type": [
                "boolean",
                "null"
              ],
              "readOnly": false,
              "description": "Is false if channelback is disabled, true otherwise. Only applicable for channels framework ticket."
            },
            "IsPublic": {
              "type": [
                "boolean",
                "null"
              ],
              "readOnly": false,
              "description": "Is true if any comments are public, false otherwise."
            },
            "CreatedAt": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "When this record was created."
            },
            "UpdatedAt": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "When this record last got updated."
            },
            "Url": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The API url of this ticket."
            },
            "View_Id": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The view that tickets belong to."
            },
            "User_Id": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The user that tickets belong to."
            },
            "Assignee": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The assigned agent or other entity. You can specify none, me, user name (full name or partial), email address, user ID, or phone number"
            },
            "GroupName": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The assigned agents group name."
            },
            "Requester": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The ticket requester. You can specify none, me, user name (full name or partial), email address, user ID, or phone number."
            },
            "Submitter": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The ticket submitter. This may be different than the requester if the ticket was submitted by an agent on behalf of the requester. You can specify none, me, user name (full name or partial), email address, user ID, or phone number. ."
            },
            "Brand": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "Search for a specific Brand on a ticket."
            },
            "Via": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The tickets source, which can be any of the following:mail, api, phone, etc."
            },
            "Commenter": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "People who have added comments to tickets. You can specify none, me, user name (full name or partial), email address, user ID, or phone number."
            },
            "Cc": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "People who have been CCd on tickets. You can specify none, me, user name (full name or partial), email address, user ID, or phone number."
            },
            "HasAttachment": {
              "type": [
                "boolean",
                "null"
              ],
              "readOnly": false,
              "description": "Search for all tickets with or without attachments using true or false."
            },
            "Ticket status": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false
            }
          }
        }
      }
    }

  

Ver inscrições em eventos

Para conferir e gerenciar todas as assinaturas de eventos associadas a uma conexão no Integration Connectors, faça o seguinte:

  1. Acesse a página Conectores de integração > Conexões.

    Acessar a página "Conexões"

  2. Clique na conexão em que você quer exibir as assinaturas.
  3. Clique na guia Inscrições em eventos.

    Todas as inscrições de eventos da conexão são exibidas.

Editar acionador do Zendesk

Edite um acionador do Zendesk para alterar ou atualizar a configuração da conexão e os detalhes da inscrição de eventos.

Para editar um acionador do Zendesk, siga estas etapas:

  1. Clique no elemento Acionador do Zendesk no editor de integração para abrir o painel de configuração do acionador.
  2. Clique em Configurar o gatilho do Zendesk.
  3. Faça o seguinte na página Editor do gatilho de evento do conector:
    1. Para manter a assinatura de eventos configurada anteriormente, clique em Reter. Caso contrário, clique em Excluir.
    2. Atualize a configuração da conexão e os detalhes da inscrição no evento conforme desejado.
    3. Clique em Concluído.
  4. Você pode ver os detalhes atualizados da conexão e das inscrições de eventos no painel de configuração do acionador, em Detalhes da inscrição de eventos.

Tipos de assinatura de eventos compatíveis

Use o gatilho do Zendesk para invocar uma integração com os seguintes tipos de assinatura de evento:

Tipos de inscrição em eventos Descrição
organization.ExternalChanged O ID externo de uma organização foi alterado.
organization.OrganizationCreated Uma organização é criada.
organization.TagsChanged As tags de uma organização foram alteradas.
ticket.AgentAssignmentChanged Um tíquete é reatribuído a outro agente no suporte.
ticket.AttachmentLinkedToComment Um anexo está vinculado a um comentário do tíquete no suporte.
ticket.AttachmentRedactedFromComment Um anexo é encoberto de um comentário existente em um tíquete.
ticket.BrandChanged A marca mudou. Uma marca é uma identidade voltada para o cliente que pode ser representada como vários produtos ou serviços, ou várias marcas de propriedade da empresa.
ticket.CcsChanged Usuários foram adicionados ou removidos de um tíquete.
ticket.CommentAdded Um comentário é adicionado quando um tíquete de suporte é criado ou atualizado.
ticket.CommentMadePrivate Um comentário particular é adicionado a um tíquete de suporte.
ticket.CommentRedacted As palavras ou strings foram removidas permanentemente de um comentário no tíquete.
ticket.DescriptionChanged A descrição é alterada em um tíquete.
ticket.ExternalIdChanged O ID do tíquete externo é alterado.
ticket.FollowersChanged Os seguidores foram alterados em um tíquete.
ticket.GroupAssignmentChanged Um tíquete é reatribuído a outro grupo de agentes.
ticket.MarkedAsSpam Um tíquete foi marcado como spam.
ticket.OrganizationChanged A organização é alterada no tíquete.
ticket.PriorityChanged A prioridade é alterada em um tíquete.
ticket.ProblemLinkChanged O ID do problema associado a um tíquete de tipo de incidente foi alterado.
ticket.RequesterChanged O solicitante de um tíquete é alterado.
ticket.StatusChanged O status de um tíquete for alterado.
ticket.SubjectChanged O assunto de um tíquete é alterado.
ticket.SubmitterChanged O remetente de um tíquete é alterado.
ticket.TagsChanged As tags foram alteradas em um tíquete.
ticket.TaskDueAtChanged A data e a hora de vencimento da tarefa em um tíquete são alteradas.
ticket.TicketCreated Um tíquete de suporte será criado.
ticket.TicketFormChanged O formulário é alterado no tíquete.
ticket.TicketMerged Um tíquete está mesclado com outro.
ticket.TicketPermanentlyDeleted Um tíquete é excluído permanentemente.
ticket.TicketSoftDeleted Um tíquete é excluído e não fica visível para os usuários, incluindo os administradores que usam a interface do produto ou a API.
ticket.TicketTypeChanged O tipo de ingresso é alterado.
ticket.TicketUndeleted A exclusão de um tíquete é cancelada.
user.CustomRoleChanged A função personalizada de um usuário foi alterada.
user.ExternalidChanged O ID externo de um usuário mudou.
user.LastLoginChanged O horário do último login de um usuário mudou.
user.OnlyPrivateCommentsChanged A capacidade de um usuário criar comentários públicos foi alterada.
user.TageChanged As tags de um usuário foram alteradas.
userTimeZoneChanged O fuso horário de um usuário foi alterado.
user.UserAliasChanged O alias de um usuário foi alterado.
user.UserCreated Um usuário é criado.
user.UserDetailsChanged Os detalhes de um usuário foram alterados.
user.UserGroupAdded Um usuário é adicionado a um grupo.
user.UserGroupRemoved Um usuário é removido de um grupo.
user.UserIdentityChanged A identidade de um usuário foi alterada.
user.UserIdentityCreated A identidade de um usuário é criada.
user.UserIdentityRemoved A identidade de um usuário é excluída.
user.UserActiveChanged O status ativo de um usuário mudou.
user.UserMerged Um usuário está mesclado com outro.
user.UserNameChanged O nome de um usuário foi alterado.
user.UserNotesChanged As anotações de um usuário foram alteradas.
user.UserOrganizationAdded Um usuário é adicionado a uma organização.
user.UserOrganizationRemoved Um usuário é removido de uma organização.
user.UserPhotoChanged A foto de um usuário foi alterada.
user.UserRoleChanged A função de um usuário foi alterada.