Solucionar problemas do conector do Zendesk Support

Esta página descreve erros comuns ao usar o conector do Zendesk Support.

Para orientação geral sobre solução de problemas que se aplica a todos os pipelines de ingestão gerenciados, consulte Troubleshoot managed ingestion pipelines.

O recurso não existe ou o acesso é proibido.

Mensagem de erro:

Error suggests either resource does not exist or access to resource is forbidden

Causa: Seu plano atual do Zendesk pode não ter acesso à entidade que está sendo importada.

Soluções: Certifique-se de que seu plano atual do Zendesk tenha acesso à entidade que está sendo importada. Algumas tabelas e recursos estão disponíveis apenas em determinados planos de assinatura do Zendesk.

O pipeline está funcionando muito lentamente.

Sintoma: O pipeline de ingestão está funcionando mais lentamente do que o esperado.

Causa: O Zendesk possui limites de taxa de API rigorosos, e a ingestão de muitas tabelas ao mesmo tempo pode causar limitação de taxa.

Soluções: Certifique-se de que não muitas tabelas estejam sendo processadas ao mesmo tempo para evitar limitação de taxa. Você pode dividir as tabelas em vários pipelines e programá-las em momentos diferentes para trabalhar dentro dos limites de taxa do Zendesk.

Continuo sendo redirecionado para a página de login do Zendesk após inserir meu ID de cliente e minha chave secreta.

Confirme se você está usando o valor correto para o ID do Cliente . O valor correto é o campo Identificador do cliente OAuth no console de administração do Zendesk. Este é o nome interno, visível para o código (por exemplo, my_new_app), não o nome de exibição mostrado aos usuários finais. Inserir o nome de exibição em vez do identificador gera um loop de redirecionamento.

Para confirmar o valor:

1. No Zendesk, acesse Administração > Aplicativos e integrações > APIs > API do Zendesk > Clientes OAuth .
2. Abra o cliente OAuth e copie o valor do campo Identificador (não o nome do cliente).
3. Insira novamente esse valor como o ID do cliente no Databricks.

Se as credenciais estiverem corretas e o problema persistir, crie um ticket de suporte com o ID do seu workspace , o ID pipeline e a mensagem de erro completa. Consulte Obter ajuda.

Estou recebendo erros em um endpoint específico da API do Zendesk.

Alguns comportamentos endpoint API do Zendesk não são controlados pelo conector. Se ajustar os parâmetros de sincronização não resolver o problema, crie um ticket de suporte com o ID do seu workspace , o ID pipeline e a mensagem de erro completa. Consulte Obter ajuda.

Um campo em um registro de auditoria ingerido está vazio ou desatualizado

Sintoma: Um campo aninhado na tabela ticket_audits, como a transcrição do chat no evento ChatStartedEvent, está vazio ou contém menos registros na tabela de destino do que a API do Zendesk retorna para a mesma auditoria. Nenhum erro é relatado, e outros registros são ingeridos corretamente.

Causa: o Zendesk documenta as auditorias de tíquetes como imutáveis, mas alguns campos dentro de uma auditoria podem continuar a mudar após a criação da auditoria. Como o conector ingere ticket_audits incrementalmente usando o cursor created_at, ele lê cada auditoria uma vez e não a revisita, portanto, o conector não detecta alterações feitas após a ingestão. Esta é uma limitação da API do Zendesk, em vez de ser do conector. Para obter mais informações, consulte Registros de auditoria podem mudar após a criação.

Solução: execute um refresh completo da ticket_audits tabela para recarregar os valores atuais do Zendesk.