Consulte os conectores compatíveis com o Application Integration.

Gatilho do Zendesk

O gatilho do Zendesk é um gatilho de evento do conector que permite invocar uma integração com base nos eventos do Zendesk aos quais você se inscreveu na sua 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 do conector (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 acionador do Zendesk

Para adicionar um gatilho Zendek à sua 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 ou clique em Criar integração para criar uma nova.

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Insira um nome e uma descrição no painel Criar integração.
    2. Selecione uma região para a integração.
    3. Selecione uma conta de serviço para a integração. É possível 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 de integração.
    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 ver a lista de gatilhos disponíveis.
  5. Clique e coloque o elemento gatilho Zendek no editor de integração.
  6. Para configurar o acionador do Zendesk, você pode usar uma conexão do Zendesk disponível no Integration Connectors ou criar uma nova conexão do Zendesk usando a opção de criação de conexão inline.

Configurar o gatilho do Zendesk usando uma conexão atual

Você pode configurar o acionador do Zendesk usando uma conexão do Zendesk no Integration Connectors. O acionador do Zendesk é um acionador de evento do conector. Portanto, você só pode usar uma conexão do Zendesk com a assinatura de eventos ativada para configurar o acionador.

Para saber como configurar um gatilho do Zendesk usando uma nova conexão, consulte Configurar o gatilho do Zendesk usando uma nova conexão.

Para configurar um gatilho do Zendesk usando uma conexão existente, siga estas etapas:

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

      O Application Integration exibe apenas as conexões do Zendesk que estão ativas e têm uma assinatura de evento ativada.

    3. Tipo de assinatura de evento:selecione o tipo de assinatura de evento que aciona a integração. Para saber mais 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 acionador do Zendesk.
  4. Clique em Concluído para concluir 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 gatilho Zendek 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. Conclua as seguintes 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 Detalhes da conexão, forneça 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 esta caixa de seleção para armazenar todos os dados de registro da conexão.
      5. Conta de serviço: 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 evento para a conexão do Zendesk. Só é possível ativar 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 de nós de conexão do Zendesk, consulte a documentação Conexão do Zendesk.

      8. (Opcional) Clique em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
      9. Clique em Próxima.
    3. Na etapa Destinos, forneça os detalhes da instância do Zendesk:
      1. Tipo de destino: selecione Endereço do host.
      2. Host: insira o nome do host ou o endereço IP da sua 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 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 Detalhes da assinatura de eventos, forneça detalhes da instância do Zendesk em que as assinaturas de eventos serão criadas.
      1. Destination Type:selecione Host address.
      2. Host:digite o URL de registro da sua instância do Zendesk. As assinaturas de 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. Senha:selecione o secret do Secret Manager com 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 quiser que o acionador do Zendesk recupere o payload do evento completo da instância do Zendesk. Consulte Saída do acionador para conferir exemplos.
      7. Clique em Próxima.
    6. Revisão: analise 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 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 gatilho do Zendesk leva alguns minutos para concluir a configuração da assinatura de eventos. É possível conferir o status da assinatura de evento no painel de configuração do acionador em Detalhes da assinatura de evento.

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

  • Creating: indica que o acionador está fazendo a assinatura da assinatura de eventos.
  • Active: indica que o acionador foi inscrito em uma assinatura de evento.
  • Error: indica que há um problema com a assinatura de evento configurada.

Além do status da assinatura do evento, a seção Detalhes da assinatura do evento também exibe outros detalhes, como região da conexão, nome da conexão, nome da assinatura do evento e muito mais.

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

Imagem mostrando o painel de configuração do acionador do Zendesk Imagem mostrando o painel de configuração do acionador do Zendesk

Acionar variável de saída

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 com o esquema de payload de saída do Zendesk.

Exemplo 1: payload de saída do evento do 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 dados aprimorados para o evento do 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
            }
          }
        }
      }
    }
    
  

Conferir as assinaturas de eventos

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

  1. Acesse Integration Connectors > Conexões.

    Acessar a página "Conexões"

  2. Clique na conexão que tem as assinaturas que você quer conferir.
  3. Clique na guia Assinaturas de eventos.

    Isso exibe todas as inscrições de eventos da conexão.

Editar acionador do Zendesk

Você pode editar um gatilho do Zendesk para mudar ou atualizar a configuração da conexão e os detalhes da assinatura de eventos.

Para editar um gatilho do Zendesk, siga estas etapas:

  1. Clique no elemento gatilho do Zendesk no editor de integração para abrir o painel de configuração do gatilho.
  2. Clique em Configure Zendesk trigger.
  3. Faça o seguinte na página Editor do acionador de evento do conector:
    1. Para manter a assinatura de evento configurada anteriormente, clique em Manter. Caso contrário, clique em Excluir.
    2. Atualize a configuração da conexão e os detalhes de inscrição no evento conforme desejado.
    3. Clique em Concluído.
  4. Confira os detalhes atualizados da conexão e da assinatura do evento no painel de configuração do acionador em Detalhes da assinatura do evento.

Tipos de assinatura de eventos compatíveis

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

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 de suporte.
ticket.AttachmentLinkedToComment Um anexo é vinculado a um comentário do tíquete no suporte.
ticket.AttachmentRedactedFromComment Um anexo é editado a partir 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 Palavras ou strings foram removidas permanentemente do comentário do tíquete.
ticket.DescriptionChanged A descrição é alterada em um tíquete.
ticket.ExternalIdChanged O ID do tíquete externo foi 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 é alterado.
ticket.RequesterChanged o solicitante do tíquete for alterado.
ticket.StatusChanged O status de um tíquete for alterado.
ticket.SubjectChanged O assunto de um tíquete é alterado.
ticket.SubmitterChanged O remetente do tíquete é alterado.
ticket.TagsChanged As tags foram alteradas em uma passagem.
ticket.TaskDueAtChanged A data e a hora de entrega da tarefa em um tíquete são alteradas.
ticket.TicketCreated Um tíquete de suporte é criado.
ticket.TicketFormChanged O formulário é alterado no tíquete.
ticket.TicketMerged Um tíquete é mesclado com outro.
ticket.TicketPermanentlyDeleted Um tíquete é excluído permanentemente.
ticket.TicketSoftDeleted Um tíquete é excluído e fica indisponível para os usuários, inclusive para os administradores que usam a interface do produto ou a API.
ticket.TicketTypeChanged Um tipo de ingresso for alterado.
ticket.TicketUndeleted Um ingresso é restaurado.
user.CustomRoleChanged O papel personalizado de um usuário foi alterado.
user.ExternalidChanged O ID externo de um usuário foi alterado.
user.LastLoginChanged O último horário de login de um usuário foi alterado.
user.OnlyPrivateCommentsChanged A capacidade de um usuário de criar comentários públicos mudou.
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 mudou.
user.UserIdentityCreated A identidade de um usuário é criada.
user.UserIdentityRemoved A identidade do usuário é excluída.
user.UserActiveChanged O status ativo de um usuário mudou.
user.UserMerged Um usuário é 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.

Cotas e limites

Para informações sobre o assunto, consulte Cotas e limites.

A seguir