zendesk-salesforce-sync-ticket-to-case

eesel Team
Written by

eesel Team

Last edited 2 março 2026

{
  "title": "Como sincronizar tickets do Zendesk com casos do Salesforce: Guia completo de 2026",
  "slug": "zendesk-salesforce-sync-ticket-to-case",
  "locale": "pt",
  "date": "2026-03-02",
  "updated": "2026-03-02",
  "template": "default",
  "excerpt": "Um guia passo a passo para sincronizar tickets do Zendesk com casos do Salesforce usando a integração nativa, incluindo configuração, e dicas de solução de problemas.",
  "categories": [
    "Zendesk",
    "Guides"
  ],
  "tags": [
    "Zendesk",
    "Salesforce",
    "Integration",
    "Ticket Sync",
    "Customer Support"
  ],
  "readTime": 10,
  "author": 16,
  "reviewer": 14,
  "seo": {
    "title": "Como sincronizar tickets do Zendesk com casos do Salesforce: Guia completo de 2026",
    "description": "Um guia passo a passo para sincronizar tickets do Zendesk com casos do Salesforce usando a integração nativa, incluindo configuração, e dicas de solução de problemas.",
    "image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-5816d2c7-30af-4a41-9be2-65b8eb87b246"
  },
  "coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-5816d2c7-30af-4a41-9be2-65b8eb87b246",
  "coverImageAlt": "Imagem do banner para Como sincronizar tickets do Zendesk com casos do Salesforce: Guia completo de 2026",
  "coverImageWidth": 1920,
  "coverImageHeight": 1080,
  "faqs": {
    "heading": "Perguntas Frequentes",
    "type": "blog",
    "answerType": "html",
    "faqs": [
      {
        "question": "Posso sincronizar casos do Salesforce de volta para tickets do Zendesk usando a integração nativa?",
        "answer": "Não, a integração nativa Zendesk-Salesforce suporta apenas a sincronização unidirecional do Zendesk para o Salesforce. Se você precisar de sincronização bidirecional, precisará de uma ferramenta de terceiros como Exalate, Skyvia ou uma integração de API personalizada."
      },
      {
        "question": "O que acontece se um campo de caso obrigatório do Salesforce não estiver mapeado no Zendesk?",
        "answer": "A sincronização falhará para esse ticket. O Salesforce exige que todos os campos obrigatórios tenham valores antes que um registro possa ser criado. Mapeie o campo obrigatório para um campo do Zendesk ou defina um valor padrão no tipo de registro do seu caso do Salesforce."
      },
      {
        "question": "Os anexos de tickets do Zendesk são sincronizados com os casos do Salesforce?",
        "answer": "Não, os anexos não são sincronizados automaticamente com a integração nativa. Apenas os metadados do ticket (assunto, descrição, status, prioridade, etc.) são transferidos para o Salesforce. Se você precisar de sincronização de anexos, considere uma solução de integração de terceiros."
      },
      {
        "question": "Quais edições do Salesforce funcionam com a sincronização de tickets do Zendesk?",
        "answer": "A integração requer Salesforce Performance, Unlimited, Enterprise ou Developer Edition, ou qualquer edição com direitos de acesso à API. A edição Salesforce Starter não inclui as permissões de API necessárias."
      },
      {
        "question": "Com que rapidez os tickets do Zendesk são sincronizados com os casos do Salesforce?",
        "answer": "A sincronização acontece quase imediatamente quando o gatilho é acionado, normalmente em segundos. No entanto, o processamento do Salesforce e quaisquer regras de validação em sua organização podem adicionar um pequeno atraso. A sincronização não é realmente em tempo real como uma conexão de banco de dados ao vivo."
      }
    ],
    "supportLink": null
  }
}
---

Quando sua equipe de suporte usa o [Zendesk](https://www.zendesk.com) e sua equipe de vendas vive no [Salesforce](https://www.salesforce.com), os dados do cliente ficam fragmentados rapidamente. Os agentes de suporte não conseguem ver o histórico da conta. Os representantes de vendas perdem problemas críticos de suporte. Todos perdem tempo alternando entre ferramentas ou pedindo atualizações no Slack.

Sincronizar tickets do Zendesk com casos do Salesforce resolve isso. Ele dá às equipes de vendas visibilidade das interações de suporte, ajuda os gerentes de contas a identificar clientes em risco e cria uma única fonte de verdade para a saúde do cliente. A integração nativa Zendesk-Salesforce lida com isso automaticamente, enviando dados de tickets para casos do Salesforce à medida que os tickets são criados ou atualizados.

Este guia orienta você na configuração da sincronização de tickets do Zendesk Salesforce para a integração de casos, passo a passo. Abordaremos tudo, desde a conexão inicial até a solução de problemas comuns. E se a abordagem nativa parecer muito limitada, veremos alternativas que podem se adequar melhor ao seu fluxo de trabalho.

## O que você precisará antes de começar

Antes de mergulhar na configuração, certifique-se de ter as contas e permissões corretas. A integração não funcionará sem esses pré-requisitos.

**Contas e acesso necessários:**

- **Conta de suporte do [Zendesk](https://www.zendesk.com/pricing)** Plano Team ou superior (a integração não está disponível no plano Support Team)
- **Conta do [Salesforce](https://www.salesforce.com/service/pricing/)** Performance, Unlimited, Enterprise ou Developer Edition (ou qualquer edição com acesso à API)
- **Permissões de administrador em ambos os sistemas** Você precisará instalar pacotes, modificar configurações de objetos e configurar gatilhos
- **Acesso à API de metadados do Salesforce** Necessário para a instalação do pacote de sincronização de tickets

**Limitação importante a entender:** A integração nativa sincroniza apenas em uma direção, do Zendesk para o Salesforce. Os tickets criados ou atualizados no Zendesk aparecem como casos no Salesforce, mas os casos criados no Salesforce não são sincronizados de volta para o Zendesk. Se você precisar de sincronização bidirecional, precisará de uma ferramenta de terceiros (mais sobre isso mais tarde).

## Passo 1: Conecte o Salesforce ao Zendesk

Comece estabelecendo a conexão entre as duas plataformas.

No Zendesk, navegue até **Central de administração > Aplicativos e integrações > Integrações > Salesforce**. Se você não vir o Salesforce listado, pode ser necessário habilitá-lo primeiro no Zendesk Marketplace.

Clique em **Conectar** e autentique-se com suas credenciais do Salesforce. Você será solicitado a conceder ao Zendesk acesso à sua organização do Salesforce. Revise as permissões cuidadosamente e, em seguida, autorize a conexão.

Uma vez conectado, verifique se o status é exibido como "Ativo" nas configurações de integração. Se você vir um erro, verifique se seu usuário do Salesforce tem acesso à API e se você está usando uma edição suportada do Salesforce.

![Página de configuração da integração do Zendesk Salesforce para conectar sua instância do Salesforce](https://zen-marketing-documentation.s3.amazonaws.com/docs/en/salesforce_integration_prodsandbox.png)

## Passo 2: Crie um tipo de registro de caso do Salesforce

Os tipos de registro no Salesforce permitem categorizar casos por sua finalidade ou origem. Criar um tipo de registro dedicado para tickets do Zendesk os mantém organizados e facilita a geração de relatórios.

No Salesforce, vá para **Configuração > Gerenciador de objetos > Caso > Tipos de registro**. Clique em **Novo** para criar um tipo de registro. Dê a ele um nome descritivo como "Sincronização de tickets do Zendesk" para que sua equipe de vendas saiba de onde esses casos se originaram.

Você pode copiar um tipo de registro existente (se quiser herdar seus layouts de página e valores de lista de opções) ou criar um do zero. Para a maioria das equipes, copiar o tipo de registro padrão "Master" funciona bem.

Após salvar, o Salesforce exibirá o ID do tipo de registro. Copie este ID para um lugar seguro, você precisará dele na próxima etapa. Ele se parece com uma longa sequência de letras e números (por exemplo: 01250000000ABC1).

![Gerenciador de objetos do Salesforce mostrando o tipo de registro Sincronização de tickets do Zendesk para o objeto Caso](https://zen-marketing-documentation.s3.amazonaws.com/docs/en/salesforce_ticket_sync_record_type.png)

## Passo 3: Instale o pacote de sincronização de tickets

O pacote de sincronização de tickets é o que cria a ponte entre os tickets do Zendesk e os casos do Salesforce. Ele adiciona campos personalizados ao seu objeto Caso do Salesforce e lida com o mapeamento de dados.

Na Central de administração do Zendesk, vá para **Aplicativos e integrações > Integrações > Salesforce > Sincronização de dados > Sincronização de tickets > Configurar**. Você verá uma opção para instalar o pacote Sincronização de tickets. Clique em **Instalar**.

O processo de instalação usa a API de metadados do Salesforce para implantar campos personalizados, gatilhos e outros componentes em sua organização do Salesforce. Isso normalmente leva alguns minutos. Você pode monitorar o status da implantação no Salesforce em **Configuração > Status da implantação**.

Uma vez concluído, verifique a instalação verificando seu objeto Caso do Salesforce. Você deve ver novos campos personalizados como "ID do ticket do Zendesk", "URL do ticket do Zendesk" e "Tags do ticket do Zendesk". Esses campos armazenam os dados específicos do Zendesk que não têm um equivalente direto nos campos de caso padrão do Salesforce.

![Configurações de correspondência da organização do Zendesk para sincronização com contas do Salesforce](https://zen-marketing-documentation.s3.amazonaws.com/docs/en/salesforce_ticket_sync_org_matching_2.png)

## Passo 4: Configure os mapeamentos de campo

Agora que o pacote está instalado, você precisa dizer ao Zendesk quais campos do Salesforce devem receber quais dados do Zendesk.

Na configuração de sincronização de tickets, você verá dois tipos de mapeamentos:

**Mapeamentos padrão** (automáticos) Estes são pré-configurados pelo pacote:

| Campo do Zendesk | Campo de caso do Salesforce |
|---------------|----------------------|
| ID do ticket | Zendesk_Support_Ticket_ID__c |
| Assunto | Assunto |
| Descrição | Descrição |
| Status | Status |
| Prioridade | Prioridade |
| E-mail do solicitante | Zendesk_Support_Ticket_Requester_Email__c |
| Nome da organização | Zendesk_Support_Ticket_Organization_Name__c |

**Mapeamentos de campo personalizados** Se você tiver campos personalizados no Zendesk que precisam ser sincronizados com o Salesforce, mapeie-os aqui. Preste atenção à compatibilidade do tipo de campo:

- As listas suspensas do Zendesk são mapeadas para listas de opções do Salesforce
- Os campos de texto do Zendesk são mapeados para campos de texto ou área de texto do Salesforce
- Os campos numéricos do Zendesk são mapeados para campos de número do Salesforce

**Requisito crítico:** Cada campo obrigatório em seu objeto Caso do Salesforce deve ser mapeado para um campo do Zendesk ou ter um valor padrão definido. Se um campo obrigatório for deixado em branco, a sincronização falhará para esse ticket.

## Passo 5: Configure a correspondência de organização e solicitante

Quando um ticket do Zendesk é sincronizado com o Salesforce, a integração tenta corresponder o solicitante e a organização do ticket aos contatos e contas existentes do Salesforce. Acertar isso evita registros duplicados.

![Mapeamento de tickets de suporte vinculando contas de clientes e contatos no Salesforce para evitar duplicatas](https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/8f5f84aa-b04d-42f1-8cec-2b4a3a97710a)

**Correspondência de organização:**

As organizações do Zendesk podem corresponder às contas do Salesforce com base em:
- Nome da organização (correspondência exata)
- ID externo (se você configurou a sincronização de dados do Salesforce para o Zendesk)

Se nenhuma correspondência for encontrada, você pode optar por criar uma nova conta do Salesforce automaticamente ou deixar o campo da conta em branco.

**Correspondência de solicitante:**

Os usuários do Zendesk correspondem aos contatos do Salesforce com base em:
- Endereço de e-mail (mais confiável)
- Nome (fallback se o e-mail não corresponder)

Você também pode definir um contato ou conta padrão para tickets que não correspondem aos registros existentes. Isso é útil para capturar casos extremos sem criar desordem de dados.

## Passo 6: Configure o gatilho de sincronização

A etapa final é configurar quando e como os tickets são sincronizados. Isso é controlado por um gatilho do Zendesk que é acionado na criação e atualização do ticket.

O Zendesk cria um gatilho padrão chamado "(Integração do Salesforce) Sincronizar tickets com o Salesforce". Você pode encontrá-lo em **Central de administração > Objetos e regras > Regras de negócios > Gatilhos**.

**Revise as condições do gatilho:**

O gatilho padrão é acionado em todas as criações e atualizações de tickets. Você pode querer modificar isso para sincronizar apenas certos tipos de tickets. Por exemplo:
- Sincronizar apenas tickets de clientes pagantes
- Excluir tickets internos ou spam
- Sincronizar apenas tickets com uma tag específica

**Importante:** Não modifique o corpo JSON nas ações do gatilho. Isso contém as instruções técnicas para o Salesforce. Alterá-lo pode quebrar a sincronização.

Ative o gatilho e teste com um único ticket. Crie um ticket de teste no Zendesk e, em seguida, verifique o Salesforce para verificar se um caso foi criado com os dados corretos.

![Página de configuração de gatilhos do Zendesk mostrando gatilhos automatizados ativos](https://zen-marketing-documentation.s3.amazonaws.com/docs/en/salesforce_activate_trigger.png)

## Problemas comuns e como corrigi-los

Mesmo com uma configuração cuidadosa, as coisas podem dar errado. Aqui estão os problemas mais comuns e suas soluções.

![Fluxograma de diagnóstico para identificar e resolver erros comuns de integração](https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/dff8daf5-0b14-439b-a33d-f53151d7d9cc)

**Falhas de implantação no Salesforce**

Se o pacote de sincronização de tickets não for implantado, verifique se seu usuário do Salesforce tem permissão "Modificar todos os dados" e acesso à API de metadados. Algumas edições ou conjuntos de permissões do Salesforce restringem esses recursos.

**Erros de campo obrigatório**

Os casos do Salesforce geralmente têm campos obrigatórios como "Origem" ou "Tipo". Se estes não estiverem mapeados no Zendesk, a sincronização falhará. Mapeie esses campos ou defina valores padrão no tipo de registro do seu caso do Salesforce.

**Erros de ID do tipo de registro**

Inserir o ID do tipo de registro errado é um erro comum. Verifique se você copiou o ID completo do Salesforce. Ele deve ter 15 ou 18 caracteres.

**Registros duplicados**

Se você estiver vendo contatos ou contas duplicados no Salesforce, seus critérios de correspondência estão muito soltos. Aperte as regras de correspondência ou desative a criação automática de registros até que você possa limpar seus dados.

**Sincronização não sendo acionada**

Se os tickets não estiverem sincronizando, verifique se o gatilho está ativo e se suas condições correspondem aos tickets com os quais você está testando. Verifique o **Configurações > Salesforce > Log de erros** do Zendesk para mensagens de erro específicas.

**Limites de governador da API**

O Salesforce impõe limites de chamadas de API. Se você estiver sincronizando milhares de tickets diariamente, poderá atingir esses limites. Monitore seu uso de API no Salesforce e considere o processamento em lote ou o agendamento de sincronizações durante os horários de menor movimento.

## Abordagens alternativas a considerar

A integração nativa Zendesk-Salesforce funciona bem para casos de uso básicos, mas tem limitações. Se você precisar de mais flexibilidade, considere estas alternativas.

**Ferramentas de integração de terceiros:**

- **[Exalate](https://exalate.com)** Integração baseada em script com sincronização bidirecional. Você escreve scripts Groovy para definir exatamente como os dados fluem entre os sistemas. Melhor para fluxos de trabalho complexos.
- **[Skyvia](https://skyvia.com)** Plataforma ETL sem código com mapeamento visual de dados. Os planos de integração de dados começam em US$ 79/mês (cobrança anual). Bom para equipes sem desenvolvedores.
- **[Zapier](https://zapier.com)** Automação de fluxo de trabalho que conecta o Zendesk e o Salesforce. Você pode construir sincronização bidirecional com dois Zaps, embora exija uma configuração cuidadosa para evitar loops.

**Desenvolvimento de API personalizado:**

Se você tiver recursos de engenharia, construir uma integração personalizada usando a [API do Zendesk](https://developer.zendesk.com/api-reference) e a [API REST do Salesforce](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest) oferece controle total. Isso é exagero para a maioria das equipes, mas vale a pena considerar se você tiver necessidades exclusivas de transformação de dados.

**Uma abordagem totalmente diferente:**

Aqui está algo para se considerar. Toda essa complexidade de integração existe porque os dados de suporte e vendas vivem em sistemas separados. E se não vivessem?

Na [eesel AI](https://www.eesel.ai), adotamos uma abordagem diferente. Em vez de sincronizar dados entre plataformas, fornecemos um [agente de IA](https://www.eesel.ai/product/ai-agent) unificado que funciona em suas ferramentas existentes. Você pode conectar o eesel AI ao Zendesk e ao Salesforce (além do Slack, sua central de ajuda e outras fontes) e ele aprende com todos eles simultaneamente. Sem mapeamento de campo complexo. Sem se preocupar com limites de API. Sem atrasos de sincronização.

![Painel do eesel AI para configurar o agente de IA com interface sem código](https://website-cms.eesel.ai/wp-content/uploads/2025/08/03-The-eesel-AI-dashboard-for-configuring-the-supervisor-agent-an-alternative-to-complex-subagent-tools.png)

Quando um cliente entra em contato, o eesel AI pode ver seu histórico completo em tickets do Zendesk, oportunidades do Salesforce e conversas anteriores. Ele rascunha respostas, encaminha tickets e até mesmo toma medidas como criar casos do Salesforce diretamente. Se você está cansado de gerenciar integrações, [veja como o eesel AI funciona](https://www.eesel.ai/product/ai-agent).

## Comece a simplificar seus dados de suporte e vendas hoje mesmo

Configurar a sincronização de tickets do Zendesk Salesforce para a integração de casos exige algum trabalho inicial, mas a recompensa vale a pena. As equipes de vendas obtêm visibilidade dos problemas de suporte. Os agentes de suporte podem ver o contexto da conta. Todos tomam melhores decisões com dados completos do cliente.

Para recapitular as etapas principais:

1. Conecte o Salesforce ao Zendesk via OAuth
2. Crie um tipo de registro de caso dedicado no Salesforce
3. Instale o pacote de sincronização de tickets
4. Mapeie os campos entre os dois sistemas
5. Configure a correspondência de organização e solicitante
6. Configure e teste o gatilho de sincronização

**Uma recomendação final:** Teste tudo em um sandbox primeiro. Tanto o Zendesk quanto o Salesforce oferecem ambientes de sandbox. Use-os para verificar sua configuração antes de tocar nos dados de produção.

Se a integração nativa atender às suas necessidades, ótimo. Se você se encontrar atingindo suas limitações, lembre-se de que existem alternativas. Seja uma ferramenta de integração de terceiros ou uma abordagem completamente diferente como o eesel AI, você tem opções. O objetivo é fornecer às suas equipes a visibilidade do cliente de que precisam, não lutar com as configurações de integração.

Pronto para explorar uma maneira mais simples de unificar seus dados de clientes? [Experimente o eesel AI gratuitamente](https://dashboard.eesel.ai/api/auth/signup?returnTo=v2) e veja como um colega de equipe de IA que aprende com todas as suas ferramentas pode eliminar a necessidade de integrações complexas completamente.

Compartilhe esta postagem

eesel undefined

Article by

eesel Team

Leia outros blogs

zendesk-webhook-signature-verification

base64(HMACSHA256(TIMESTAMP + BODY)) x zendesk account id: 123456 x zendesk webhook id: 01F1KRFQ6BG29CNWFR60NK5FNY x zendesk webhook invocation id: 8350205582 x zendesk webhook signature: EiqWE3SXTPQpPulBV6OSuuGziIishZNc1VwNZYqZrHU= x zendesk webhook signature timestamp: 2021 03 25T05:09:27Z GET /api/v2/webhooks/{webhook id}/signing secret dGhpc19zZWNyZXRfaXNfZm9yX3Rlc3Rpbmdfb25seQ== javascript const express

eesel Team

eesel Team

Editor

zendesk-webhook-ticket-created

json { "ticket id": "{{ticket.id}}", "subject": "{{ticket.title}}", "description": "{{ticket.description}}", "requester email": "{{ticket.requester.email}}", "requester name": "{{ticket.requester.name}}", "priority": "{{ticket.priority}}", "status": "{{ticket.status}}", "group": "{{ticket.group.name}}", "assignee": "{{ticket.assignee.name}}", "created at": "{{ticket.created at}}", "tags": "{{ticket.tags}}", "url": "{{ticket.link}}" } json { "type": "zen:event type:ticket.created", "account id": 22129848,

eesel Team

eesel Team

Editor

zendesk-webhook-ticket-updated

json { "ticket id": "{{ticket.id}}", "subject": "{{ticket.title}}", "status": "{{ticket.status}}", "assignee": "{{ticket.assignee.name}}", "requester": "{{ticket.requester.email}}", "updated at": "{{ticket.updated at with timestamp}}" } json { "event": "ticket updated", "ticket id": "{{ticket.id}}", "subject": "{{ticket.title}}", "status": "{{ticket.status}}", "priority": "{{ticket.priority}}" } json { "event": "assignee changed",

eesel Team

eesel Team

Editor