Consulte os conectores compatíveis com o Application Integration.

Gatilho do Zendesk

O gatilho Zendesk é um acionador de evento do conector que permite invocar uma integração com base nos eventos do Zendesk em 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 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 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 Integrations.

    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. 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 da 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 informações sobre como configurar um acionador do Zendesk usando uma nova conexão do Zendesk, consulte Configurar o gatilho do Zendesk usando uma nova conexão.

Para configurar um acionador do Zendesk usando uma 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. Forneça os seguintes detalhes de configuração na página Editor do acionador de evento do conector:
    1. Region: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 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 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 Location, escolha o local da nova conexão do Zendesk:
      1. Região:selecione uma região na lista suspensa.
      2. Clique em Next.
    2. Na etapa Connection Details, 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 essa 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 essa opção para criar e ativar uma nova assinatura de eventos 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 Next.
    3. Na etapa Destinations, forneça 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 sua instância do Zendesk.
      3. Clique em Next.
    4. Na etapa Authentication, 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 de host do Zendesk fornecido.

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

      2. Clique em Next.
    5. Na etapa Event subscription details, informe a 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. Serão criadas inscrições em eventos para esse 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 gatilho para exemplos.
      7. Clique em Next.
    6. Revisão: analise os detalhes da conexão do Zendesk fornecidos.
    7. Clique em Create 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 acionador do Zendesk leva alguns minutos para concluir a configuração da inscrição do evento. É possível conferir o status da assinatura do evento no painel de configuração do acionador em Detalhes da assinatura do evento.

O acionador 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 eventos.
  • Error: indica que há um problema com a inscrição de eventos 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 exemplo de layout 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

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

Exemplo 1: payload de saída 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", "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
            }
          }
        }
      }
    }
    
  

Ver inscrições em 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 Inscrições de eventos.

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

Editar gatilho do Zendesk

É possível editar um acionador do Zendesk para alterar ou atualizar a configuração da conexão e os detalhes da assinatura do evento.

Para editar um gatilho 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 Configure Zendesk trigger.
  3. Faça o seguinte na página Editor do acionador 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 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 assinatura de 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 de um comentário no tíquete.
ticket.DescriptionChanged A descrição for 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 é alterado.
ticket.RequesterChanged o solicitante do tíquete for alterado.
ticket.StatusChanged O status de um tíquete for alterado.
ticket.SubjectChanged o assunto do tíquete for alterado.
ticket.SubmitterChanged O remetente do tíquete é alterado.
ticket.TagsChanged As tags foram alteradas em um tíquete.
ticket.TaskDueAtChanged A data e a hora de conclusão 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 A exclusão de um tíquete foi cancelada.
user.CustomRoleChanged A função personalizada de um usuário foi alterada.
user.ExternalidChanged O ID externo de um usuário foi alterado.
user.LastLoginChanged O horário do último login de um usuário foi alterado.
user.OnlyPrivateCommentsChanged A capacidade de um usuário de 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 do usuário é excluída.
user.UserActiveChanged O status ativo de um usuário foi alterado.
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 cotas e limites, consulte Cotas e limites.

A seguir